#define CreateFileNonLinear ( _fname,
_fsize,
_handle,
_result   )     __createFileNonLinear(_fname, _fsize, _handle, _result)

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.
_result The function call result. See Loader module error codes.
Warning:
This function requires the enhanced NBC/NXC firmware.

Generated by  doxygen 1.6.2