NXC  Version 1.2.1 r5
 All Data Structures Files Functions Variables Groups Pages
unsigned int OpenFileReadLinear ( string  fname,
unsigned int &  fsize,
byte &  handle 
)
inline

Open a linear file for reading.

Open an existing linear file with the specified filename for reading. The file size is returned in the second parameter, which must be a variable. The file handle is returned in the last parameter, which must be a variable. The loader result code is returned as the value of the function call. The filename parameter must be a constant or a variable.

Parameters
fnameThe name of the file to open.
fsizeThe size of the file returned by the function.
handleThe file handle output from the function call.
Returns
The function call result. See Loader module error codes.
Warning
This function requires the enhanced NBC/NXC firmware.
Examples:
ex_OpenFileReadLinear.nxc.