C++ ifstream 类

定义和用法

ifstream 类（即 "input file stream" 的缩写）用于从文件中读取数据。

ifstream 类定义在 <fstream> 头文件中。

要打开文件，请将文件路径传递给构造函数：

ifstream MyReadFile("filename.txt");

ifstream 类有多种方式从文件中读取数据。一种简单的方法是使用 getline() 函数读取直到下一行换行符的所有字符，并将它们写入一个字符串中。

从文件中输出一行文本：

string myText;
getline(MyReadFile, myText);
cout << myText;

实例

使用 ifstream 从文件中读取行：

// 创建一个文本字符串，用于输出文本文件
string myText;

// 从文本文件中读取
ifstream MyReadFile("filename.txt");

// 使用 while 循环和 getline() 函数逐行读取文件
while (getline(MyReadFile, myText)) {
  // 输出文件中的文本
  cout << myText;
}

// 关闭文件
MyReadFile.close();

文件读取函数

文件读取函数从文件中提取字符并移动文件指针。

get()

get() 方法从文件中读取单个字符，并以 int 值的形式返回其 ASCII 值。将其转换为 char 类型以查看字符。文件指针移动到文件中的下一个字符。

char myChar = MyReadFile.get();
cout << myChar;

get(destination, size, delimiter) 方法从文件中读取最多 size 个字符，并将其写入目标位置。它一旦遇到换行符、文件结尾或可选的由 delimiter 参数给定的字符，就会停止读取。写入目标位置的值始终以 \0 空终止字符结尾。此方法将文件指针移动到停止读取的换行符或分隔符处。

char destination[20];
MyReadFile.get(destination, 20);
cout << destination << "\n";

// 当遇到 '.' 时停止读取
MyReadFile.get(destination, 20, '.');
cout << destination << "\n";

getline()

getline(destination, size, delimiter) 方法与 get(destination, size, delimiter) 方法相同，只是换行符或分隔符被丢弃，且文件指针移动到紧随其后的字符。

char destination[20];
MyReadFile.getline(destination, 20);
cout << destination << "\n";

// 当遇到 '.' 时停止读取
MyReadFile.getline(destination, 20, '.');
cout << destination << "\n";

还有一个类似的 getline(stream, destination, delimiter) 函数，它从由 ifstream 对象的 stream 参数指定的文件中读取所有字符，直到下一个换行符（或可选的分隔符），并将它们写入由 destination 指定的字符串中。

string destination;
getline(MyFile, destination);
cout << destination << "\n";

// 当遇到 '.' 时停止读取
getline(MyFile, destination, '.');
cout << destination << "\n";

read()

read(destination, n) 方法从文件中读取 n 个字符，并将它们写入由 destination 参数指定的字符数组中。与其他函数不同，它不会在换行符处停止读取，也不会在数据中添加空终止字符。

char destination[20];
MyReadFile.read(destination, 19);
destination[20] = '\0'; // 确保以空终止字符结尾
cout << destination << "\n";

peek()

peek() 方法从文件中读取单个字符，并以 int 值的形式返回其 ASCII 值。将其转换为 char 类型以查看字符。与 get() 方法不同，此方法不会移动文件指针。

char myChar = MyReadFile.peek();
cout << myChar;

gcount()

gcount() 方法返回最近调用的文件读取方法从文件中提取的字符数。

char destination[20];
MyReadFile.getline(destination, 20);
cout << MyReadFile.gcount() << "\n";

文件处理函数

文件处理函数用于打开、关闭和导航文件。

open()

open(filepath) 方法打开由 filepath 指定的路径处的文件。如果文件已经打开，则此方法无效。

ifstream MyReadFile;
MyReadFile.open("filename.txt");

is_open()

is_open() 方法如果文件已打开，则返回 true；如果没有文件打开，则返回 false。

ifstream MyReadFile;
cout << MyReadFile.is_open(); << "\n"; // 显示 0，因为文件未打开
MyReadFile.open("filename.txt");
cout << MyReadFile.is_open(); << "\n"; // 显示 1，因为文件已打开

close()

close() 方法关闭文件。完成文件操作后关闭文件以释放资源是个好习惯。

MyReadFile.close();

rdbuf()

rdbuf() 方法返回一个指向直接处理文件的内部 filebuf 对象的指针。

filebuf * buf = MyReadFile.rdbuf();

unget()

unget() 方法将文件指针向后移动一个字符。

使用 unget() 方法打印同一个字符两次：

char myChar = MyReadFile.get();
cout << myChar << "\n";
MyReadFile.unget();
myChar = MyReadFile.get();
cout << myChar;

seekg()

seekg(position) 方法将文件指针移动到相对于文件开头的指定位置。

MyReadFile.seekg(6)

seekg(position, origin) 方法将文件指针移动到相对于给定原点的文件中指定位置。origin 有三个可能的值：

• ifstream::beg - 位置相对于文件开头
• ifstream::cur - 位置相对于当前文件位置
• ifstream::end - 位置相对于文件结尾

将文件指针移动到不同位置：

MyReadFile.seekg(6, ifstream::beg);
cout << MyReadFile.tellg(); << "\n";
MyReadFile.seekg(-3, ifstream::cur);
cout << MyReadFile.tellg(); << "\n";
MyReadFile.seekg(-4, ifstream::end);
cout << MyReadFile.tellg(); << "\n";

tellg()

tellg() 方法返回文件中文件指针的当前位置。

cout << MyReadFile.tellg();

提取运算符 (>>)

提取运算符 (>>) 从文件的当前位置读取一定数量的字符，将其解释并将解释后的值写入变量中。然后，文件指针会移动到下一个尚未读取的字符。字符的解释方式取决于变量的数据类型。

语法

MyReadFile >> variable

它也可以多次使用，以逐个读取文件的部分内容：

MyReadFile >> variable1 >> variable2 >> variable3

提取运算符 (>>) 首先会跳过空白字符（空格、制表符和换行符），直到遇到第一个非空白字符。之后，它会根据变量的数据类型按照以下表格中的规则进行读取。

操纵符

操纵符可以代替变量使用。当使用操纵符时，它们会改变 ifstream 对象解释数据的方式。操纵符的效果会一直保持，直到另一个操纵符改变它。

以下表格列出了 ifstream 对象可以使用的操纵符。

实例

使用操纵符改变数据解释方式：

ifstream MyFile("example.txt");
bool myBool;
int myInt;

// 将字符序列 "true" 和 "false" 解释为布尔值
MyFile >> boolalpha >> myBool;

// 恢复为正常读取布尔值
MyFile >> noboolalpha;

// 从文件中读取十六进制数字并将其解释为整数
MyFile >> hex >> myInt;

// 恢复为正常读取整数
MyFile >> dec;

MyFile.close();
return 0;