std::fclose
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Input/output library
Print functions (C++23)
Buffers
(C++23)
(C++98/26*)
(C++20)
Streams
Abstractions
File I/O
String I/O
Array I/O
(C++23)
(C++23)
(C++23)
(C++98/26*)
(C++98/26*)
(C++98/26*)
Synchronized Output
(C++20)
Types
Error category interface
(C++11)
(C++11)
C-style I/O
Types and objects
Functions
File access
Direct input/output
Unformatted input/output
Formatted input
(C++11)(C++11)(C++11)
(C++11)(C++11)(C++11)
Formatted output
(C++11)
(C++11)
File positioning
Error handling
Operations on files
Defined in header
<cstdio>
int fclose( std::FILE * stream );
Closes the given file stream and writes any unwritten data from stream's buffer to the associated output device. 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 std::setbuf or std::setvbuf , if any, is also disassociated and deallocated if automatic allocation was used.
If any data are written to an output device, returning from std::fclose establishes an observable checkpoint.
The behavior is undefined if the value of the pointer stream is used after std::fclose returns.
Contents
[edit] Parameters
stream
-
the file stream to close
[edit] Return value
0 on success, EOF otherwise.
[edit] Example
Run this code
#include <cstdio> #include <cstdlib> int main() { int is_ok = EXIT_FAILURE ; FILE* fp = std::fopen ("/tmp/test.txt", "w+"); if (!fp) { std::perror ("File opening failed"); return is_ok; } int c; // Note: int, not char, required to handle EOF while ((c = std::fgetc (fp)) != EOF ) // Standard C I/O file reading loop std::putchar (c); if (std::ferror (fp)) std::puts ("I/O error when reading"); else if (std::feof (fp)) { std::puts ("End of file reached successfully"); is_ok = EXIT_SUCCESS ; } std::fclose(fp); return is_ok; }
Output:
End of file reached successfully
[edit] See also
flushes the put area buffer and closes the associated file
(public member function of
(public member function of
std::basic_filebuf<CharT,Traits>) [edit]
C documentation for fclose