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 相同。 如果 meta 比較等於 traits_type::eof,函式呼叫 setstate(failbit)。 否則,它指定儲存在 _Chtraits_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