定义于头文件 <fstream>

template<

class CharT,
class Traits = std::char_traits<CharT>

> class basic_fstream : public std::basic_iostream<CharT, Traits>

类模板 basic_fstream 实现基于文件的流上的高层输入/输出。它将 std::basic_iostream 的高层接口赋予基于文件的缓冲（ std::basic_filebuf ）。

std::basic_fstream 的典型实现只保有一个非导出数据成员： std::basic_filebuf<CharT, Traits> 的实例。

亦定义二个对于常用字符类型的特化：

类型	定义
`fstream`	basic_fstream<char>
`wfstream`	basic_fstream<wchar_t>

文件操作

关闭关联文件

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

void close();

关闭关联文件。

等效地调用 rdbuf()->close() 。若操作期间出现错误，则调用 setstate(failbit) 。

参数

（无）

返回值

（无）

注意

此函数为 basic_fstream 的析构函数在流对象离开作用域时调用，通常不直接调用。

调用示例

#include <fstream>
#include <utility>
#include <string>
#include <iostream>int main()
{std::fstream fstream1("test1.txt", std::ios::in);std::fstream fstream2("test2.txt", std::ios::in);std::fstream fstream3("test3.txt", std::ios::in);std::cout << "fstream1 is: "<< (fstream1.is_open() ? "true" : "false") << std::endl;std::cout << "fstream2 is: "<< (fstream2.is_open() ? "true" : "false") << std::endl;std::cout << "fstream3 is: "<< (fstream3.is_open() ? "true" : "false") << std::endl;std::cout << std::endl;std::cout << "std::fstream close" << std::endl;fstream1.close();fstream2.close();fstream3.close();std::cout << std::endl;std::cout << "fstream1 is: "<< (fstream1.is_open() ? "true" : "false") << std::endl;std::cout << "fstream2 is: "<< (fstream2.is_open() ? "true" : "false") << std::endl;std::cout << "fstream3 is: "<< (fstream3.is_open() ? "true" : "false") << std::endl;std::cout << std::endl;return 0;
}

输出

非成员函数

特化 std::swap 算法

std::swap(std::basic_fstream)

template< class CharT, class Traits >
void swap( basic_fstream<CharT,Traits> &lhs, basic_fstream<CharT,Traits> &rhs );

为 std::basic_fstream 特化 std::swap 算法。交换 lhs 与 rhs 的状态。等效地调用 lhs.swap(rhs) 。

参数

lhs, rhs

要交换状态的流

返回值

（无）

异常

（无）

调用示例

#include <fstream>
#include <utility>
#include <string>
#include <iostream>int main()
{std::fstream fstream1("test1.txt", std::ios::out);std::cout << "fstream1 is: "<< (fstream1 ? "true" : "false") << std::endl;std::fstream fstream2("test2.txt", std::ios::out);std::cout << "fstream2 is: "<< (fstream2 ? "true" : "false") << std::endl;std::cout << std::endl;fstream1 << "hello 1" << " ";fstream2 << "hello 2" << " ";//为 std::basic_fstream 特化 std::swap 算法。//交换 lhs 与 rhs 的状态。等效地调用 lhs.swap(rhs) 。std::cout << "std::swap(fstream1, fstream2) " << std::endl;std::swap(fstream1, fstream2);fstream1 << "hello 1" << " ";fstream2 << "hello 2" << " ";fstream1.close();fstream2.close();std::cout << std::endl;std::fstream fstream3("test1.txt", std::ios::in);std::cout << "fstream3 is: "<< (fstream3.is_open() ? "true" : "false") << std::endl;if (fstream3.is_open()){std::cout << fstream3.rdbuf() << std::endl;}std::cout << std::endl;std::fstream fstream4("test2.txt", std::ios::in);std::cout << "fstream2 is: "<< (fstream4.is_open() ? "true" : "false") << std::endl;if (fstream4.is_open()){std::cout << fstream4.rdbuf() << std::endl;}std::cout << std::endl;return 0;
}