This wiki is out of date, use the continuation of this wiki instead

From FenixWiki

Revision as of 12:33, 29 May 2007 (edit) Sandman (Talk | contribs) m ← Previous diff		Revision as of 12:33, 26 June 2007 (edit) (undo) Sandman (Talk | contribs) m Next diff →
Line 3:		Line 3:
	==Definition==		==Definition==
-	'''INT''' fopen ( <'''STRING''' file> , <'''INT''' mode> )	+	'''INT''' fopen ( <'''STRING''' filename> , <'''INT''' mode> )
	Opens a file on the hard drive for reading or writing.		Opens a file on the hard drive for reading or writing.
Line 9:		Line 9:
	== Parameters ==		== Parameters ==
	{|		{|
-	| '''STRING''' file || - The filename of the file you wish to open (including extension and possible path).	+	| '''STRING''' filename || - The filename of the file you wish to open (including extension and possible path).
	|-		|-
	| '''INT''' mode || - The mode with which to access the file (see [[Readwrite_modes]]).		| '''INT''' mode || - The mode with which to access the file (see [[Readwrite_modes]]).
Line 15:		Line 15:
	== Returns ==		== Returns ==
-	'''INT''' : FileHandle	+	'''INT''' : [[FileHandle]]
	{|		{|
	| 0 || - Could not load.		| 0 || - Could not load.

---

Revision as of 12:33, 26 June 2007

Contents 1 Definition 2 Parameters 3 Returns 4 Example

Definition

INT fopen ( <STRING filename> , <INT mode> )

Opens a file on the hard drive for reading or writing.

Parameters

STRING filename	- The filename of the file you wish to open (including extension and possible path).
INT mode	- The mode with which to access the file (see Readwrite_modes).

Returns

INT : FileHandle

0	- Could not load.
!0	- The identifier of the file now opened for reading/writing.

Example

Process loadthing(STRING loadpath);
Private
    int handle;   // handle for the loaded file 
    int druppels; // here's where the loaded data go
Begin

    handle=fopen(loadpath,O_READ); // opens the file in reading mode
    fread(handle,druppels);        // reads from the file and puts the data in druppels
    fclose(handle);                // zipping up after business is done

    write_int(0,160,100,4,&druppels); // let's see what we got here

End

Used in example: fread(), fclose(), write_int()