次の方法で共有

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) を呼び出します。

2 番目の関数は、int_type の要素を meta と同じ方法で配置します。meta が traits_type::eofに等しいを比較する場合、関数呼び出し setstate (failbit)。それ以外の場合は _Chで traits_type::to_char_type (meta) を格納します。関数は *thisを返します。

3 番目の関数は、get (_Str、_Count、widen (「\n」) を返します)。

4 番目の関数は、_Count まで、1 要素を展開し、配列の先頭で _Str に値を格納します。これは、格納、配置された要素の後に char_type を常に格納します。テストの順序で、抽出:の停止

  • ファイルの終端。

  • 関数が _Delimに等しいを比較する要素を配置すると、要素が被制御シーケンスに設定されます。

  • 関数の後に _Count - 1 要素を配置します。

関数に要素を配置しない場合 setstate (failbit) を呼び出します。いずれの場合も、その後、*thisを返します。

5 番目の関数は、get (strbuf、widen (「\n」) を返します)。

6 番目の関数は、要素を展開し、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

入出力ストリームのプログラミング

入出力ストリームの規則