读取输入流中的一个或多个字符。
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 方法相同。如果 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(strbuf,widen(“\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