std::basic_fstream<CharT,Traits>::close

< cpp‎ | io‎ | basic fstream

 
C++
 
Input/output library
I/O manipulators
C-style I/O
Buffers
(deprecated in C++98)
(C++20)
Streams
Abstractions
File I/O
String I/O
Array I/O
(deprecated in C++98)
(deprecated in C++98)
(deprecated in C++98)
Synchronized Output
(C++20)
Types
Error category interface
(C++11)
(C++11)
 
std::basic_fstream
 
void close();

Closes the associated file.

Effectively calls rdbuf()->close(). If an error occurs during operation, setstate(failbit) is called.

Parameters

(none)

Return value

(none)

Notes

This function is called by the destructor of basic_fstream when the stream object goes out of scope and is not usually invoked directly.

Example

Run this code
#include <string>
#include <fstream>
#include <iostream>
 
int main()
{
    std::fstream f1("example1", std::ios::out),
                 f2("example2", std::ios::out),
                 f3("example3", std::ios::out);
 
    std::cout << std::boolalpha
              << f1.is_open() << '\n'
              << f2.is_open() << '\n'
              << f3.is_open() << '\n';
 
    f1.close();
    f2.close();
 
    std::cout << f1.is_open() << '\n'
              << f2.is_open() << '\n'
              << f3.is_open() << '\n';
}

Possible output: 

true
true
true
false
false
true

See also

 checks if the stream has an associated file
(public member function)
opens a file and associates it with the stream
(public member function)
flushes the put area buffer and closes the associated file
(public member function of std::basic_filebuf<CharT,Traits>)