#define CreateFile ( _fname,
_fsize,
_handle,
_result   )     __createFile(_fname, _fsize, _handle, _result)

Create a file.

Create a new 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.

Generated by  doxygen 1.6.2