fclose

Defined in header <stdio.h>
int fclose( FILE *stream );

Closes the given file stream. Any unwritten buffered data are flushed to the OS. Any unread buffered data are discarded.

Whether or not the operation succeeds, the stream is no longer associated with a file, and the buffer allocated by setbuf or setvbuf, if any, is also disassociated and deallocated if automatic allocation was used.

Parameters

stream - the file stream to close

Return value

​0​ on success, EOF otherwise.

Example

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    FILE* fp = fopen("test.txt", "r");
    if(!fp) {
        perror("File opening failed");
        return EXIT_FAILURE;
    }
 
    int c; // note: int, not char, required to handle EOF
    while ((c = fgetc(fp)) != EOF) { // standard C I/O file reading loop
       putchar(c);
    }
 
    if (ferror(fp))
        puts("I/O error when reading");
    else if (feof(fp))
        puts("End of file reached successfully");
 
    fclose(fp);
}

References

  • C11 standard (ISO/IEC 9899:2011):
    • 7.21.5.1 The fclose function (p: 304)
  • C99 standard (ISO/IEC 9899:1999):
    • 7.19.5.1 The fclose function (p: 270)
  • C89/C90 standard (ISO/IEC 9899:1990):
    • 4.9.5.1 The fclose function

See also

opens a file
(function)
open an existing stream with a different name
(function)
C++ documentation for fclose
doc_C_Language
2016-10-10 18:35:09
Comments
Leave a Comment

Please login to continue.