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.
|fname||The name of the file to create. |
|fsize||The size of the file. |
|handle||The file handle output from the function call. |
- The function call result. See Loader module error codes.
- This function requires the enhanced NBC/NXC firmware.