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.