c++ std::getline

声明

C++ 98 中的声明格式(1)     istream& getline (istream& is, string& str, char delim);(2)     istream& getline (istream& is, string& str);C++11  增加了两个(3)     istream& getline (istream&& is, string& str, char delim);(4)     istream& getline (istream&& is, string& str);

功能

从is中提取一行字符将其存入str中(没有指定delim)，或者将is中delim字符之前的字符存入str中(指定了delim)。正确执行is跟str都会被修改。

注意：

1.如果到达了流的结尾或者遇到其它错误该提取操作也会停止。

2.如果找到delim字符，该字符将会被丢弃，并不会存入str中，再次操作也会从delim的下一个字符开始。

输入

 is     istream对象

str     存储结果的string对象，调用getline之前str中如果有内容，该内容将会被清除。

返回值

            is做为返回值。

            调用该函数如果发生下列情况，is参数的内部状态可能会被设置。

            1. eofbit       输入源字符集到达了结尾。

            2. failbit  如果获取的输入并不能作为一个有效的文本对象来解释，is将会保持被调用前参数和内容。注意eofbit也有可能会设置failbit标记。

      3.badbit   除了以上以外的其它错误。

       另外，以上情况，如果对应的标记被ios::exceptions设置，ios_base::failure类型的异常将会被抛出。

例子

简单的配置文件的解析:

test.txt内容

a=b

c=d       

e=f  

#include <sstream>#include <iostream>#include <fstream>#include <string>#include <map>//class Config{private:    std::map<std::string,std::string> mapKV;public:    int parser(std::string strfile)    {        std::fstream file;        file.open(strfile.data(),std::ios::in);        if (!file.is_open())        {            std::cout << "open the file failed , file=" << strfile << std::endl;            return -1;        }        std::string strLine;        while(std::getline(file,strLine))        {            std::cout << "get new line , strLine=" << strLine << std::endl;            std::string key,value;            size_t pos = strLine.find("=");            if (pos == std::string::npos)            {                std::cout << "line format error 111, strLine=" << strLine << std::endl;                continue;            }            key   = strLine.substr(0,pos);            value = strLine.substr(pos+1);            if (!key.empty() && !value.empty())            {                mapKV[key] = value;            }            else            {                std::cout << "line format error 222, strLine=" << strLine << std::endl;            }        }        file.close();        return 0;    }};int main(){    Config config;    config.parser("test.txt");    return 0;}

说明  ：  本人由于能力所限如果理解有误或者有重大错误，欢迎大家纠正！

原文地址   http://www.cplusplus.com/reference/string/string/getline/?kw=getline