pSOSystem System Calls - Read

fclose pREPC+ System Calls
fclose Closes a stream.
#include
#include
int fclose(
FILE *stream /* stream pointer */
)
Description
Arguments
Return Value
Error Codes
The fclose() function first flushes the buffer associated with the stream pointed
to by stream and closes the associated file or I/O device. Any unwritten buffered
data is written to the associated file or I/O device, and any unread buffered data is
discarded. The stream is disassociated from the file or I/O device.
If the buffer was automatically allocated when the stream was opened, it is
reclaimed by the system. The user is responsible for returning user-supplied
buffers.
When invoked with a null stream pointer, fclose() has a special significance
under pREPC+. It causes pREPC+ to:
■ Close all streams opened by the calling task.
■ Reclaim all memory allocated by pREPC+ on behalf of the calling task, either
implicitly or explicitly by calls to malloc() or calloc() functions.
stream Points to an open pREPC+ stream.
This function returns 0 if successful or end-of-file (EOF) if an error occurs. If an
error occurs, errno is set.
Refer to Appendix B.
3-30 pSOSystem System Calls