FPutC Function (ROM Call 0x3DF)

AMS 2.00 or higher files.h

unsigned short FPutC (short byte, FILES *fsPtr);

Write a byte to a file opened in write mode.

FPutC writes the byte byte to the file fsPtr opened in write mode at the current file position. The FILES structure pointed to by fsPtr must have been opened with FOpen in write mode.

FPutC returns FS_OK if successful, FS_ERROR if the file is not opened for write mode or FS_MEMORY if the system is 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.

This routine may cause heap compression.


Uses: HeapRealloc, HeapSize
Used by: FWrite


See also: FOpen, FGetC, FWrite, FSetPos, FStatus