fclose(3s) [ultrix man page]
fclose(3s) fclose(3s) Name fclose, fflush - close or flush a stream Syntax #include <stdio.h> fclose(stream) FILE *stream; fflush(stream) FILE *stream; Description The routine causes any buffers for the named stream to be emptied, and the file to be closed. Buffers allocated by the standard input/out- put system are freed. The routine is performed automatically upon calling The routine causes any buffered data for the named output stream to be written to that file. If stream is NULL, all open output streams are flushed. The stream remains open. Diagnostics These functions return EOF if buffered data cannot be transferred to an output stream. Environment If not called in POSIX mode, these functions return EOF if stream is not associated with an output file. In POSIX mode, if stream is asso- ciated with an input file, the file pointer is positioned following the last byte read from that stream. See Also close(2), fopen(3s), setbuf(3s) fclose(3s)
Check Out this Related Man Page
fclose(3S) fclose(3S) NAME
fclose(), fflush(), fclose_unlocked(), fflush_unlocked() - close or flush a stream SYNOPSIS
Obsolescent Interfaces DESCRIPTION
causes any buffered data for the named stream to be written out, and the stream to be closed. Buffers allocated by the standard input/out- put system may be freed. is performed automatically for all open files upon calling exit(2). If stream points to an output stream or an update stream in which the most recent operation was output, causes any buffered data for the stream to be written to that file; otherwise any buffered data is discarded. The stream remains open. If stream is a null pointer, performs this flushing action on all currently open streams. Obsolescent Interfaces and close or flush a stream. RETURN VALUE
Upon successful completion, and return 0. Otherwise, they return EOF and set to indicate the error. ERRORS
If or fails, is set to one of: The flag is set for the file descriptor underlying stream and the process would be delayed in the write operation. The file descriptor underlying stream is not valid. An attempt was made to write a file that exceeds the process's file size limit or the maximum file size (see ulimit(2)). or was interrupted by a signal. The process is in a background process group and is attempting to write to its controlling terminal, is set, the process is neither ignoring nor blocking the signal, and the process group of the process is orphaned. There was no free space remaining on the device containing the file. An attempt was made to write to a pipe that is not open for reading by any process. A signal is also sent to the process. Additional values may be set by the underlying and functions (see write(2), lseek(2) and close(2)). WARNINGS
and are obsolescent interfaces supported only for compatibility with existing DCE applications. New multithreaded applications should use and SEE ALSO
close(2), exit(2), lseek(2), write(2), flockfile(3S), fopen(3S), setbuf(3S), thread_safety(5). STANDARDS CONFORMANCE
fclose(3S)