basic_istream::get

读取输入流中的一个或多个字符。

int_type get();
basic_istream<Elem, Tr>& get(
    Elem& _Ch
);
basic_istream<Elem, Tr>& get(
    Elem *_Str,
    streamsize _Count
);
basic_istream<Elem, Tr>& get(
    Elem *_Str,
    streamsize _Count,
    Elem _Delim
);
basic_istream<Elem, Tr>& get(
    basic_streambuf<Elem, Tr>& _Strbuf
);
basic_istream<Elem, Tr>& get(
    basic_streambuf<Elem, Tr>& _Strbuf,
    Elem _Delim
);

参数

  • _Count
    将从 strbuf 中读取的字符数。

  • _Delim
    应停止读取的字符,如果它在 _Count之前运行。

  • _Str
    的字符串写入的。

  • _Ch
    获取字符。

  • _Strbuf
    写入的缓冲区的。

返回值

获取参数形式返回文件结束的元素读取为整数或。 剩余的窗体返回流 (*this)。

备注

第一个无格式的输入函数提取元素,如果可能,就像通过返回,rdbuf->sbumpc。 否则,它将返回 traits_type::eof 如果函数不提取元素,它调用 setstate(failbit)。

第二个函数提取元素 int_typemeta 方法相同。 如果 meta 等于比较 traits_type::eof函数,调用 setstate(failbit)。 否则,它将在 _Ch中存储 traits_type::to_char_type(meta)。 函数返回 *this

第三个函数都返回 get(_Str,_Count,widen(“\n')。

第四函数提取到 _Count - 1 元素并将它们存储在数组开头。_Str。 它始终存储它存储的 char_type,只要提取的元素之后。 按照测试的顺序,将终止:

  • 在文件尾。

  • 在函数提取比较与 _Delim的元素后,在这种情况下,元素回到控制放置顺序情况下。

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

如果函数不提取元素,它调用 setstate(failbit)。 在任何情况下,它将返回 *this

第五函数返回 get(strbufwiden(“\n')。

第一个函数。strbuf提取元素以及插入它们。 提取停止对的文件结束在比较或等于_Delim*,*不提取的元素。 它还停止,而提取,相关的元素粘贴,因此,如果失败或引发捕获,但异常不是异常 ()。 如果函数不提取元素,它调用 setstate(failbit)。 在任何情况下,函数返回 *this

示例

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

int main( ) 
{
   char c[10];

   c[0] = cin.get( );
   cin.get( c[1] );
   cin.get( &c[2],3 );
   cin.get( &c[4], 4, '7' );

   cout << c << endl;
}
  

要求

页眉: <istream>

命名空间: std

请参见

参考

basic_istream 类

iostream 编程

iostreams 约定