因为之前每次使用这个函数都要在网上查一遍,觉得很麻烦,这次就认真地整理一下,希望写完之后就记住。
getline函数其实有两个:
一个是全局函数,include<cstring>, 原型是 istream& getline( istream& is, string& str, char delim) 与 istream& getline( istream& is, string& str) , 得到的字符串存在一个string类型的str里。
另一个是iostream类的成员函数, include<iostream>, 原型是 istream& getline( char * str, streamsize n, char delim ) 与 istream& getline( char * str, streamsize n ) , 得到的字符串存在一个C-style字符数组str里。(值得注意的是,这个n应该小于字符数组str的长度,因为至少要留一个位置存放结束符'\0',后面这个还要探讨一下)
以后可以参考的cin.getline源码:
_Myt& getline(_Elem *_Str, streamsize _Count, _Elem _Delim)
{// get up to _Count characters into NTCS, discard _Delim
_DEBUG_POINTER(_Str); //判断传入指针的合法性
ios_base::iostate _State = ios_base::goodbit;
_Chcount = 0; //从输入流中读取的字符数
const sentry _Ok(*this, true);
/*注:上面这句很关键,它关系到下面的if是否执行,也就是是否读输入流。这句从
语法上看,是
sentry是一个class, _Ok是sentry类的一个const对象,构造这个对象时需要传入两个
参数
第一个是流对象自身的引用,第二个表示对空白字符(如空格、制表符)的处理方式
,为true时意味着不忽略空白字符,即一个字符一个字符的从输入流中提取。
*/
if (_Ok && 0 < _Count)
/*
**************************************************************************
* sentry类内部重载了一个类型转换运算符,它把sentry类的实例转换成了一个bool
表达式。
* 这个表达式返回sentry类的私有成员_Ok的值。
bool sentry::operator bool() const
* { // test if _Ipfx succeeded
* return (_Ok);
* }
* _Ok这个成员的值由sentry类的构造函数
* 在初始化时设置,设置的过程比较麻烦,这里不做赘述(其实我也没看十分明白)。
* 但可以肯定的是,当输入流的状态是正常时,这个成员的值也是true,
* 反之,则是false。
*
* _Count是调用者传入的第二个参数,这里用做循环计数器的初值,以后每读一个字
符,
* _Count的值会减一。
****************************************************************************
**/
{
// state okay, use facet to extract
int_type _Metadelim = _Traits::to_int_type(_Delim);
int_type _Meta = _Myios::rdbuf()->sgetc();//从输入流读一个字符
for (; ; _Meta = _Myios::rdbuf()->snextc()) //snextc()从输入流中读取下一
个字符
if (_Traits::eq_int_type(_Traits::eof(), _Meta))
{// end of file, quit
_State |= ios_base::eofbit;
break;
}//注:遇到文件尾,getline结束
else if (_Meta == _Metadelim) {
// got a delimiter, discard it and quit
++_Chcount; //读取字符数+1
_Myios::rdbuf()->sbumpc();
/*注:上面这句把结束符读掉了,如果不指定结束符,那就是把'\n'读掉了
。
但回车符本身并没有拷贝到缓冲区中,
这样下次的读操作将从回车符后面的第一个字符开始,
*/
break;
}/* 注:遇到结束符,getline结束,注意这里的顺序,它是先判断是否遇到结束
符,后判断是否读入了指定个数的。 */
else if (--_Count <= 0)
{// buffer full, quit
_State |= ios_base::failbit;
break;
}
//注:读到了指定个数,执行到这里已经隐含了在指定个数的最后一位仍然不是
结束符,
//因此该部分将输入流状态置为了错误。
//这直接导致了接下来的getline(或者get)以及>>运算符等读操作都不能正确执
行)
else {
// got a character, add it to string
++_Chcount; //读取字符数加1
*_Str++ = _Traits::to_char_type(_Meta);
}//注:这一分支将读取到的单个字符拷贝到缓冲区中
}
*_Str = _Elem(); //
/* add terminating null character /*注:前面这句为字符串加入了终止符'\0'
因为_Elem()构造了一个ascii码为0的字符对象*/
_Myios::setstate(_Chcount == 0 ? _State | ios_base::failbit : _State);
/*注:如果没有读入任何字符,要保持执行这一次getline之前的输入流状态,
否则根据这一次getline执行的情况,设置输入流为相应状态。 */
return (*this); //返回输入流对象本身
}