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_type 元素 meta 方法相同。如果 metatraits_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 Class

iostream编程

(mfc)约定