unsigned int CreateFileNonLinear ( string  fname, unsigned int  fsize, byte &  handle  )

inline

Create a non-linear file.

Create a new non-linear file with the specified filename and size and open it for writing. 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 and size parameters must be constants, constant expressions, or variables. A file created with a size of zero bytes cannot be written to since the NXC file writing functions do not grow the file if its capacity is exceeded during a write attempt.

Parameters

fname	The name of the file to create.
fsize	The size of the file.
handle	The 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_CreateFileNonLinear.nxc.