basic_istream::getline

输入流获取行。

basic_istream<Elem, Tr>& getline(
    char_type *_Str, 
    streamsize _Count
);
basic_istream<Elem, Tr>& getline(
    char_type *_Str, 
    streamsize _Count, 
    char_type _Delim
);

参数

  • _Count
    读取的字符数从 strbuf

  • _Delim
    应停止读取的字符是否在 _Count之前遇到。

  • _Str
    的字符串写入。

返回值

流(*this)。

备注

第一个非格式化输入函数返回 getline(_Str,_Count,widen(“\n”)。

第二个函数在数组开头提取到 _Count - 1元素并将其存储在_Str。 它始终存储它存储的字符串终止字符,在任何提取的元素之后。 跟踪测试的顺序,提取终止:

  • 在文件末尾。

  • 在函数提取与 _Delim相等的元素后,在元素不会使也不会追加到控件序列情况下。

  • 在函数后提取 _Count - 1元素。

如果函数不提取元素或 _Count - 1组件,它调用 setstate(failbit)。 在任一情况下,它将返回 *this

示例

// basic_istream_getline.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;

int main( ) 
{
   char c[10];

   cin.getline( &c[0], 5, '2' );
   cout << c << endl;
}
  

要求

标头: <istream>

命名空间: std

请参见

参考

basic_istream Class

iostream编程

(mfc)约定