C++ std::getline

### C++ 中 `std::getline` 的用法与示例 `std::getline` 是 C++ 标准库中的一个非成员函数，位于头文件 `<string>` 中。它可以从输入流中读取一整行字符串，直到遇到指定的分隔符为止，默认情况下该分隔符为换行符 `\n`。 #### 函数原型 以下是 `std::getline` 的两种重载形式： ```cpp std::istream& getline(std::istream& is, std::string& str); std::istream& getline(std::istream& is, std::string& str, char delim); ``` - 参数解释： - `is`: 输入流对象（如 `cin`, 文件流等）。 - `str`: 存储读取结果的目标字符串。 - `delim`: 可选参数，自定义分隔符，默认为换行符 `\n`。 --- #### 示例代码展示 以下是一些常见的使用场景和示例代码： ##### 示例 1：从标准输入读取一行文本 ```cpp #include <iostream> #include <string> using namespace std; int main() { string input; cout << "请输入您的姓名：" << flush; getline(cin, input); // 使用默认分隔符 '\n' cout << "您输入的姓名是：" << input << endl; return 0; } ``` 在这个例子中，`std::getline` 被用来捕获用户输入的一整行文字，包括空格在内的所有字符都会被存储到变量 `input` 中[^1]。 --- ##### 示例 2：带有自定义分隔符的读取 ```cpp #include <iostream> #include <string> using namespace std; int main() { string sentence; cout << "请输入一段话，以句号 '.' 结束：" << flush; getline(cin, sentence, '.'); // 自定义分隔符为 '.' cout << "您输入的内容是：" << sentence << endl; return 0; } ``` 这里展示了如何通过传递第三个参数来改变默认分隔符的行为。当用户输入结束于特定字符时，读取过程即告终止[^1]。 --- ##### 示例 3：从文件中逐行读取内容 假设有一个名为 `example.txt` 的文件，其中包含若干行文本数据。我们可以利用循环配合 `std::getline` 实现逐行读取的功能。 ```cpp #include <iostream> #include <fstream> #include <string> using namespace std; int main() { ifstream inputFile("example.txt"); if (!inputFile.is_open()) { cerr << "无法打开文件 example.txt" << endl; return 1; } string line; int lineNumber = 1; while (getline(inputFile, line)) { // 按行读取直至 EOF cout << "第 " << lineNumber++ << " 行: " << line << endl; } inputFile.close(); return 0; } ``` 这段代码片段首先打开了一个文件流，并检查是否成功开启。随后进入一个 `while` 循环结构，不断调用 `std::getline` 提取出每一行的数据打印至屏幕，直到到达文件末尾停止[^1]。 --- #### 注意事项 1. **处理多余空白** 当前行为不会移除结尾处可能存在的回车符或者制表符等内容。因此如果后续需要进一步解析这些字符串的话，应当考虑去除不必要的前后缀空白区域[^1]。 2. **错误检测机制** 若发生 I/O 错误或提前抵达文件末端，则返回值将是对应流本身处于失效状态的对象。此时可借助诸如 `.fail()` 或者 `.eof()` 成员方法加以判断[^1]。 3. **与其他提取运算符的区别** 不同于常规 >> 运算子会依据空白间隔分割字段，`std::getline` 则能够保留整个连续序列作为单一单元对待。 --- ###