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. |
- Returns
- The function call result. See Loader module error codes.
- Examples:
- ex_CreateFile.nxc, and ex_file_system.nxc.
1.8.2 
