 |
FWrite |
Function (ROM Call 0x3E7) |
Write a specified number of bytes to a file.
FWrite writes bytesToWrite bytes of data from the buffer buffer to the output file associated with the FILES structure pointed to by fsPtr.
The data written begins at the current file position. buffer is a pointer to any object.
FWrite returns one of the following values as enumerated in the FileStatusEnum enum:
FS_OK | The write was successful. |
FS_ERROR | The file fsPtr is not opened in write mode. |
FS_MEMORY | Out of memory. |
Note: Any error will cause the file status to be set to FS_ERROR so that multiple
writes may be performed without checking the return status as long as an
FStatus is done at the end to make sure all of the writes were successful.
Uses: FPutC
See also: FOpen, FPutC, FRead, FClose