C++ ifstream 类

更新于 2025/12/9 15:32:17

示例

使用 ifstream 从文件中读取行：

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

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

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

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

运行示例 »

定义和用法

ifstream 类（即"输入文件流"）用于读取文件。

ifstream 类定义在头文件中。

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

ifstream MyReadFile("filename.txt");

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

输出文件中的一行文本：

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

文件读取函数

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

get()

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

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

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

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

// 遇到"."时停止阅读。
MyReadFile.get(destination, 20, '.');
cout << destination << "
";

getline()

getline(destination, size, delimiter) 方法与 get(destination, size, delimiter) 方法相同，区别在于前者会丢弃换行符或分隔符，并将文件指针移动到其后的字符。

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

// 遇到"."时停止阅读。
MyReadFile.getline(destination, 20, '.');
cout << destination << "
";

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

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

// 遇到"."时停止阅读。
getline(MyFile, destination, '.');
cout << destination << "
";

read()

read(destination, n) 方法从文件中读取最多 n 个字符，并将它们存储在指定的字符数组中。它不会在换行符处停止，也不会添加空终止符。如果要将结果用作字符串，则必须手动将 '\0' 添加到数组中。

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

peek()

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

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

gcount()

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

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

文件处理功能

文件处理功能用于打开、关闭和浏览文件。

open()

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

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

is_open()

is_open() 方法在文件打开时返回 true，在没有文件打开时返回 false。

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

close()

close() 方法用于关闭文件。使用完毕后，最好关闭文件以释放资源。

MyReadFile.close();

rdbuf()

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

filebuf * buf = MyReadFile.rdbuf();

unget()

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

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

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

seekg()

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

MyReadFile.seekg(6)

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

原点有三个可能的值：

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

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

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

tellg()

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

cout << MyReadFile.tellg();

提取运算符

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

语法

MyReadFile >> variable

它还可以多次使用，逐段读取文件内容。

MyReadFile >> variable1 >> variable2 >> variable3

>>提取运算符首先跳过空白字符（空格、制表符和换行符），直到遇到第一个非空白字符。之后，它会根据变量的数据类型遵循下表所示的规则。

数据类型	描述	示例
`int` `long` `short`	读取一串数字并将其解释为整数。该序列前面可以有一个符号（"+"或"-"）。它会在遇到第一个非数字字符时停止读取。如果未找到有效的序列，`ifstream` 对象将失败并停止读取。	`15 +125 -30`
`bool`	读取整数的方式与上述相同，然后将 0 解释为 false，将 1 解释为 true。任何其他整数值都将被解释为 true，但 `ifstream` 对象将失败并停止读取。下一节中描述的 `boolalpha` 操作符将完全改变此行为。	`0 1 +01`
`float` `double`	读取有效的字符序列并将其解释为浮点数。有效的序列至少包含一个数字，前面可以有符号（"+"或"-"），后面可以有小数点和小数位。也可以使用科学计数法（一个数字后跟"e"或"E"以及一些数字）。如果未找到有效的序列，`ifstream` 对象将失败并停止读取。	`5 -5.46 +2e4 -1.62E-5`
`char`	从文件中读取单个字符。如果文件指针位于文件末尾，则 `ifstream` 对象将失败并停止读取。	`B`
`string` `char *`	读取直到下一个空白字符（空格、制表符或换行符）、空终止字符或文件结尾的所有字符。变量值后将添加一个空终止符（`\0`）。如果文件指针已经指向空终止字符或文件末尾，则 `ifstream` 对象将失败并停止读取。	`Hello`

Manipulators

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

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

操作符	描述
`noskipws`	提取运算符不会跳过空白字符，而是会读取它们。这对于 `char` 类型变量尤其有用，因为对于其他数据类型，它会在遇到空白字符时停止读取。
`skipws`	重置由`noskipws`操纵符所做的更改。
`ws`	将文件指针移动到文件中下一个不包含空白字符的位置。
`hex`	使用整数变量时，请接受十六进制表示（数字 0 到 9 和 A 到 F）。
`oct`	使用整数变量时，请预期数字以八进制（数字 0 到 7）表示。
`dec`	使用整数变量时，请预期数字以十进制（0 到 9）形式表示。这将重置 `hex` 和 `oct` 操作符所做的更改。
`boolalpha`	读取布尔变量的数据时，它不会查找整数，而是查找字符序列"true"或"false"。
`noboolalpha`	重置`boolalpha`操纵符所做的更改。

示例

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

bool myBool;

int myInt;
// 将字符序列"true"和"false"解释为布尔值
MyFile >> boolalpha >> myBool;
// 恢复正常读取布尔值
MyFile >> noboolalpha;
// 从文件中读取十六进制数并将其解释为整数
MyFile >> hex >> myInt;
// 恢复正常读取整数
MyFile >> dec;

❮ fstream 类

C++ 教程

C++ 函数

C++ 面向对象

C++ 错误

C++ 数据结构

C++命名空间

C++ 项目

C++ 如何使用

C++ 关键字与函数参考

C++ 高级教程

C++ 实例

C++ 标准库参考

C++ 模板库参考