定义于头文件 <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;
}

输出