HOWTO · C++

如何在 C++ 中逐行读取文件

在本文中,我们将探讨在 C++ 中逐行读取文件的四种常见方法:使用 ifstream 搭配 getline()、C 函数库的 getline() 函数、fgets() 函数,以及 istream_iterator。

本页内容

在 C++ 中逐行读取文件是许多编程任务中的一项基本操作,例如数据处理、文本分析和文件解析。无论你处理的是小型文本文件还是大型数据集,知道如何完成这项任务都很重要。

在本文中,我们将探讨在 C++ 中逐行读取文件的四种常见方法:使用 ifstream 搭配 getline()、C 函数库的 getline() 函数、fgets() 函数,以及 istream_iterator。

为什么要逐行读取文件

逐行读取文件通常比一次性读取整个文件更受青睐,尤其是在处理大型文件时。一次处理一行,可以有效管理内存使用量,并处理几乎任何大小的文件。

这种方法特别适用于需要独立处理每一行的任务,例如解析 CSV 文件、日志处理或文本分析。

以下是一个示例 input.txt 文件,其中包含一些示例文本:

This is a sample input file.
It contains multiple lines of text.
Each line demonstrates a different scenario.
For example, this line contains numbers: 12345.
And this line has special characters: !@#$%^&*().

让我们使用这个文件作为输入,来测试后续章节中的文件读取示例。

如何在 C++ 中使用 ifstream 搭配 getline() 函数逐行读取文件

在 C++ 中逐行读取文件时,最直接也最常用的方法之一,是将 ifstream 类与 getline() 函数结合使用。这种方法在处理文件输入时简单又高效,因此成为许多开发者的首选。

getline() 函数是 C++ 标准库的一部分,主要用于从输入流(例如文件或标准输入 cin)中读取行。

其语法如下:

istream& getline(istream& is, string& str, char delim);

其中:

  • is:要从中读取字符的输入流。
  • str:用于存储所提取字符的字符串变量。
  • delim:标记每一行结尾的定界字符(默认为 '\n')。

getline() 函数从输入流中读取字符,直到遇到指定的定界符或到达流的结尾。然后,它将这些字符存储在所提供的字符串变量中,不包含定界符本身。

重要的是,getline() 会返回输入流(is),因此可以串联多个输入操作。

现在,让我们深入看一个示例,演示如何在 C++ 中使用 ifstream 搭配 getline() 逐行读取文件:

#include <fstream>
#include <iostream>
#include <string>

int main() {
  std::ifstream file("input.txt");

  if (!file.is_open()) {
    std::cerr << "Error: Unable to open the file." << std::endl;
    return 1;
  }

  std::string line;

  while (std::getline(file, line)) {
    std::cout << line << std::endl;
  }

  file.close();

  return 0;
}

在这个示例中,我们首先引入所需的头文件:<iostream>、<fstream> 和 <string>。它们分别提供输入/输出、文件流和字符串操作的功能。

接着,我们定义 main 函数。在 main 函数内,创建一个名为 file 的 std::ifstream 实例,它代表输入文件流。

然后,我们尝试使用文件的构造函数打开名为 "input.txt" 的文件。如果文件无法打开,就会将错误消息输出到标准错误流(cerr),程序随即以非零状态退出。

接下来,我们声明一个字符串变量 line,用来存储从文件读取的每一行。在 while 循环中,我们反复调用 std::getline(),并将文件流(file)和字符串变量(line)作为参数传入。

这个函数从文件流中读取一行,直到到达行尾或文件结尾。读取到的每一行随后都会输出到标准输出流(cout)。

最后,在读取完文件的所有行之后,我们使用 close() 方法关闭文件流,以释放系统资源。

输出:

在 C++ 中使用 ifstream 搭配 getline() 逐行读取文件

这演示了如何使用 ifstream 搭配 getline() 在 C++ 中有效地逐行读取文件,为处理文件输入操作提供了一种清晰而简洁的方法。

如何在 C++ 中使用 C 函数库的 getline() 函数逐行读取文件

除了 C++ 标准库之外,C++ 开发者也可以利用 C 函数库提供的 getline() 函数来逐行读取文件。虽然这个函数的运作方式略有不同,但它仍是处理文件输入操作的一个可行替代方案。

C 函数库的 getline() 函数主要用于从输入流中读取行,与其在 C++ 标准库中的对应函数类似。其语法如下:

ssize_t getline(char** lineptr, size_t* n, FILE* stream);

这里,

  • lineptr:指向用于存储该行的缓冲区的指针。
  • n:指向保存缓冲区大小的变量的指针(必要时会调整大小)。
  • stream:要从中读取该行的文件流。

与 C++ 标准库的 getline() 函数不同,C 函数库版本返回一个 ssize_t 值,表示读取的字符数;若发生错误或到达文件结尾,则返回 -1。

让我们看一个示例,演示如何在 C++ 中使用 C 函数库的 getline() 逐行读取文件:

#include <cstdio>
#include <cstdlib>
#include <iostream>

int main() {
  FILE* file = fopen("input.txt", "r");

  if (!file) {
    std::cerr << "Error: Unable to open the file." << std::endl;
    return 1;
  }

  char* line = nullptr;
  size_t len = 0;

  ssize_t read;
  while ((read = getline(&line, &len, file)) != -1) {
    std::cout << line;
  }

  free(line);

  fclose(file);

  return 0;
}

首先引入所需的头文件:<iostream> 用于输入/输出操作,<cstdio> 用于 C 风格的输入/输出,<cstdlib> 用于内存分配函数。

在 main 函数中,我们声明一个名为 file 的 FILE* 指针,并尝试使用 fopen() 函数以读取模式打开文件 "input.txt"。如果文件无法打开,就会输出错误消息,程序随即以非零状态退出。

接着,我们声明一个字符指针 line 和一个 size_t 变量 len,分别用来存储从文件读取的每一行及其长度。在 while 循环中,我们反复调用 getline(),并传入文件流(file)、line 指针的地址,以及 len 变量的地址。

这个函数从文件流中读取一行,根据需要动态分配内存,并将该行存储在 line 所指向的缓冲区中。读取到的每一行随后都会输出到标准输出流(cout)。

在读取完文件的所有行之后,我们使用 free() 函数释放为 line 缓冲区动态分配的内存,并使用 fclose() 函数关闭文件流,以释放系统资源。

输出:

在 C++ 中使用 C 函数库的 getline() 逐行读取文件

这演示了另一种在 C++ 中逐行读取文件的方法,即利用 C 函数库的 getline() 函数。

如何在 C++ 中使用 fgets() 函数逐行读取文件

在 C++ 中逐行读取文件的另一种方法是使用 fgets() 函数,它是 C 标准库的一部分。虽然与 C++ 基于流的方法相比,fgets() 可能显得不那么直观,但它简单易用,并且兼容旧有代码库,或适合偏好 C 风格输入/输出的场景。

fgets() 的语法如下:

char *fgets(char *str, int size, FILE *stream);

这里,

  • str:指向用于存储该行的字符数组(缓冲区)的指针。
  • size:要读取的字符数上限(包含空终止符)。
  • stream:要从中读取该行的文件流。

此函数在成功时返回 str;若发生错误或到达文件结尾,则返回 NULL。

接下来,我们来看一个示例,说明如何在 C++ 中使用 fgets() 逐行读取文件:

#include <cstdio>
#include <iostream>

int main() {
  FILE* file = fopen("input.txt", "r");

  if (!file) {
    std::cerr << "Error: Unable to open the file." << std::endl;
    return 1;
  }

  char line[256];

  while (fgets(line, sizeof(line), file) != NULL) {
    std::cout << line;
  }

  fclose(file);

  return 0;
}

在这个示例中,我们首先引入所需的头文件:<iostream> 用于输入/输出操作,<cstdio> 用于 C 风格的输入/输出。

在 main 函数内,我们声明一个名为 file 的 FILE* 指针,并尝试使用 fopen() 函数以读取模式打开文件 "input.txt"。如果文件无法打开,就会输出错误消息,程序随即以非零状态退出。

接着,我们定义一个大小为 256 个字符的字符数组 line,用来存储从文件读取的每一行。在 while 循环中,我们反复调用 fgets(),并传入文件流(file)、line 数组的地址,以及数组的大小。

这个函数从文件流中读取一行,并将其存储在 line 缓冲区中。读取到的每一行随后都会输出到标准输出流(cout)。

在读取完文件的所有行之后,我们使用 fclose() 函数关闭文件流,以释放系统资源。

输出:

在 C++ 中使用 fgets() 逐行读取文件

这展示了在 C++ 中逐行读取文件的另一种方法。虽然在语法和用法上略有不同,fgets() 仍为处理文件输入操作提供了一个可行的选择,并具备与 C 风格编程范式兼容且熟悉的特点。

如何在 C++ 中使用 istream_iterator 逐行读取文件

istream_iterator 提供了一种优雅而现代的方式,从包括文件在内的输入流中读取数据,它将流视为一连串元素。虽然它通常用于读取格式化数据,例如整数或字符串,但也可以通过将每一行视为一个字符串元素,来逐行读取文件。

这种方法使代码简洁易读,因此成为许多开发者方便的选择。

istream_iterator 的语法如下:

istream_iterator<T> it(istream& is);

这里,

  • T:要读取的数据类型。
  • is:要从中读取数据的输入流。

istream_iterator 构造函数会初始化一个迭代器(it),用来迭代从输入流(is)中提取的元素。它通常与 istream_iterator 的解引用和递增运算符(分别为 *it 和 ++it)搭配使用,以访问流中的元素并向前移动。

请看以下代码示例,它演示了如何在 C++ 中使用 istream_iterator 逐行读取文件:

#include <fstream>
#include <iostream>
#include <iterator>
#include <string>

int main() {
  std::ifstream file("input.txt");

  if (!file.is_open()) {
    std::cerr << "Error: Unable to open the file." << std::endl;
    return 1;
  }

  std::istream_iterator<std::string> it(file);
  std::istream_iterator<std::string> end;

  if (it == end) {
    std::cerr << "Error: Empty file." << std::endl;
    return 1;
  }

  std::cout << *it++;

  while (it != end) {
    std::cout << " " << *it++;
  }
  std::cout << std::endl;

  file.close();

  return 0;
}

首先引入所需的头文件:<iostream> 用于输入/输出操作,<fstream> 用于文件流,<iterator> 用于迭代器操作,<string> 用于字符串操作。

在 main 函数中,我们声明一个名为 file 的 ifstream 对象,并尝试打开文件 "input.txt"。如果文件无法打开,就会输出错误消息,程序随即以非零状态退出。

接着,我们创建一个名为 it 的 istream_iterator,以文件流 file 初始化,用来从文件中读取字符串。此外,我们还创建一个名为 end 的流结尾迭代器,用来表示文件的结尾。

在 while 循环内,我们使用 it 迭代器遍历文件内容,直到它到达流结尾迭代器 end 为止。在每次迭代中,我们解引用迭代器(*it)以取得当前的行,将其输出到控制台,然后推进迭代器(++it)。

在处理完文件的所有行之后,我们使用 close() 方法关闭文件流,以释放系统资源。

输出:

在 C++ 中使用 istream_iterator 逐行读取文件

这演示了另一种在 C++ 中逐行读取文件的方法,即利用 istream_iterator 将文件内容视为一连串字符串。这种方法为处理文件输入操作提供了一种现代而简洁的解决方案,提升了代码的可读性和可维护性。

结论

我们探讨了在 C++ 中逐行读取文件的几种方法,每种方法都有其优势,并根据程序员的具体需求和偏好而适用。无论是使用 C++ 标准库的 getline() 函数、C 函数库的 getline()、fgets(),还是 istream_iterator,开发者都有多种选择。

C++ 和 C 函数库中的 getline() 函数都提供了直接的方法,而 fgets() 则具备与 C 风格编程兼容的特点。另一方面,istream_iterator 则提供了一种现代而简洁的解决方案,将文件内容作为一连串字符串进行迭代。

无论选择哪种方法,核心目标都相同:高效且准确地逐行读取文件内容。通过理解每种方法的语法和运作机制,我们可以为自己的项目选择最合适的方法,确保高效的文件处理和最佳的代码可读性。