File::Write

Defined in: C4Files.h

Writes data to a file.

Prototype

FileResult Write(const void *buffer, unsigned long size);

Parameters

`buffer`	A pointer to the location from which data will be written to the file.
`size`	The number of bytes to write to the file.

Description

The Write function attempts to perform a synchronous write operation for a file object. If successful, this function blocks until the write operation completes. The return value is one of the following file result codes.

`kFileOkay`	The write operation was successfully completed.
`kFileNotOpen`	No file has been opened for the `File` object.
`kFileIOFailed`	The operation failed because the operating system returned an error.