定义于头文件 <fstream>
template< class CharT, |
类模板 basic_ifstream 实现文件流上的高层输入操作。它将 std::basic_istream 的高层接口赋予基于文件的流缓冲( std::basic_filebuf )。
std::basic_ifstream 的典型实现仅保有一个非导出数据成员: std::basic_filebuf<CharT, Traits> 的实例。
亦定义二个对于常用字符类型的特化:
类型 | 定义 |
ifstream | basic_ifstream<char> |
wifstream | basic_ifstream<wchar_t> |
成员函数
移动文件流
std::basic_ifstream<CharT,Traits>::operator=
basic_ifstream& operator=( basic_ifstream&& other ); | (C++11 起) |
移动赋值文件流 other
给 *this
,等效地移动赋值 std::basic_istream 基类和关联的 std::basic_filebuf 。
将 other
置为无关联文件。注意基类移动赋值交换 *this 与 other
间的所有流状态变量(除了 rdbuf )。
参数
other | - | 要移动的文件流。 |
返回值
*this
调用示例
#include <fstream>
#include <utility>
#include <string>
#include <iostream>
int main()
{
std::cout << "ifstream1: " << std::endl;
std::ifstream ifstream1("test.txt", std::ios::in);
std::cout << "ifstream1 is: " << (ifstream1 ? "true" : "false") << std::endl;
if (ifstream1.is_open())
{
std::string strLine;
while (std::getline(ifstream1, strLine))
{
std::cout << strLine << std::endl;
break;
}
}
std::cout << std::endl;
std::ifstream ifstream2 = std::move(ifstream1);
std::cout << "ifstream1 is: " << (ifstream1.is_open() ? "true" : "false") << std::endl;
std::cout << "ifstream2 is: " << (ifstream2.is_open() ? "true" : "false") << std::endl;
std::cout << std::endl;
std::cout << "ifstream2: " << std::endl;
if (ifstream2.is_open())
{
std::string strLine;
while (std::getline(ifstream2, strLine))
{
std::cout << strLine << std::endl;
}
}
return 0;
}
输出
交换二个文件流
std::basic_ifstream<CharT,Traits>::swap
void swap( basic_ifstream& other ); | (C++11 起) |
交换流与 other
的状态。
通过调用 basic_istream<CharT, Traits>::swap(other) 和 rdbuf()->swap(other.rdbuf()) 进行。
参数
other | - | 要交换状态的流 |
返回值
(无)
调用示例
#include <fstream>
#include <utility>
#include <string>
#include <iostream>
int main()
{
std::ifstream ifstream1("test1.txt", std::ios::in);
std::cout << "ifstream1: " << std::endl;
if (ifstream1.is_open())
{
std::string strLine;
uint8_t index = 0;
while (std::getline(ifstream1, strLine))
{
std::cout << strLine << std::endl;
if (index > 1)
{
break;
}
index++;
}
}
std::cout << std::endl;
std::ifstream ifstream2("test2.txt", std::ios::in);
std::cout << "ifstream2: " << std::endl;
if (ifstream2.is_open())
{
std::string strLine;
uint8_t index = 0;
while (std::getline(ifstream2, strLine))
{
std::cout << strLine << std::endl;
if (index > 1)
{
break;
}
index++;
}
}
std::cout << std::endl;
ifstream2.swap(ifstream1);
std::cout << "ifstream1: " << std::endl;
if (ifstream1.is_open())
{
std::string strLine;
while (std::getline(ifstream1, strLine))
{
std::cout << strLine << std::endl;
}
}
std::cout << std::endl;
std::cout << "ifstream2: " << std::endl;
if (ifstream2.is_open())
{
std::string strLine;
while (std::getline(ifstream2, strLine))
{
std::cout << strLine << std::endl;
}
}
return 0;
}
输出
返回底层未处理的文件设备对象
std::basic_ifstream<CharT,Traits>::rdbuf
std::basic_filebuf<CharT, Traits>* rdbuf() const; | (C++11 起) |
返回指向底层未处理文件设备对象的指针。
参数
(无)
返回值
指向底层未处理文件设备对象的指针。
调用示例
#include <fstream>
#include <utility>
#include <string>
#include <iostream>
int main()
{
std::ifstream ifstream1("test1.txt", std::ios::in);
std::cout << "ifstream1: " << std::endl;
if (ifstream1.is_open())
{
while (ifstream1)
{
//返回指向底层未处理文件设备对象的指针。
std::cout << ifstream1.rdbuf() << std::endl;
}
}
std::cout << std::endl;
return 0;
}
输出