operator>>(std::basic_istream)

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

std::basic_istream

グローバルオブジェクト

cinwcin

メンバ関数

basic_istream::basic_istream

basic_istream::~basic_istream

basic_istream::operator= (C++11)

書式付き入力

basic_istream::operator>>

書式なし入力

basic_istream::get

basic_istream::peek

basic_istream::unget

basic_istream::putback

basic_istream::getline

basic_istream::ignore

basic_istream::read

basic_istream::readsome

basic_istream::gcount

位置付け

basic_istream::tellg

basic_istream::seekg

その他

basic_istream::sync

basic_istream::swap (C++11)

メンバクラス

basic_istream::sentry

非メンバ関数

operator>>(std::basic_istream)

 

ヘッダ<istream>で定義
template< class CharT, class Traits > basic_istream<CharT, Traits>&     operator>>( basic_istream<CharT, Traits>& st, CharT& ch ); template< class Traits > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, signed char& ch ); template< class Traits > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, unsigned char& ch );	(1)
	(2)
template< class CharT, class Traits> basic_istream<CharT, Traits>&     operator>>( basic_istream<CharT, Traits>& st, CharT* s ); template< class Traits > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, signed char* s ); template< class Traits > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, unsigned char* s );			(C++20まで)
template< class CharT, class Traits, std::size_t N > basic_istream<CharT, Traits>&     operator>>( basic_istream<CharT, Traits>& st, CharT (&s)[N] ); template< class Traits, std::size_t N > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, signed char (&s)[N] ); template< class Traits, std::size_t N > basic_istream<char, Traits>&     operator>>( basic_istream<char, Traits>& st, unsigned char (&s)[N] );			(C++20以降)
template< class Istream, class T > Istream&&     operator>>( Istream&& st, T&& value );		(3)	(C++11以降)

1,2) 文字入力操作を実行します。

1) FormattedInputFunctionとして振る舞います。先行する空白をスキップする可能性があるセントリーオブジェクトを構築およびチェックした後、文字を抽出してchに格納します。文字が利用できない場合、FormattedInputFunctionとして必要に応じて設定されるeofbitに加えて、failbitを設定します。

2) FormattedInputFunctionとして振る舞います。先行する空白をスキップする可能性があるセントリーオブジェクトを構築およびチェックした後、連続する文字を抽出し、最初の要素が指されている文字配列の連続する場所に格納します(C++20まで) s。次のいずれかの条件が満たされると抽出は停止します。

• 空白文字（ctype<CharT>ファセットによって決定される）が見つかった。空白文字は抽出されません。

st.width()が0より大きい場合、st.width() - 1文字が格納されます。	(C++20まで)
n - 1文字が格納されます。ここでnは次のように定義されます。 st.width()が0より大きい場合、std::min(std::size_t(st.width()), N); それ以外の場合、nはNです。	(C++20以降)

• 入力シーケンスでファイルの終わりに達した（これもeofbitを設定します）。

いずれの場合も、追加のヌル文字値CharT()が出力の最後に格納されます。文字が抽出されなかった場合、failbitが設定されます（ヌル文字は出力の最初の位置にまだ書き込まれます）。最後に、std::setwの効果がある場合、その効果をキャンセルするためにst.width(0)が呼び出されます。

3) 入力ストリームオブジェクトへの右辺値参照が与えられた場合、適切な抽出演算子を呼び出します（st >> std::forward<T>(value)と等価）。このオーバーロードは、st >> std::forward<T>(value)が適切に形成され、Istreamがstd::ios_baseから公的にかつ曖昧さなく派生したクラス型である場合にのみ、オーバーロード解決に参加します。

備考

ストリームの最後の文字である単一の文字を抽出してもeofbitは設定されません。これは、operator>>で最後の整数を抽出するなどの他のフォーマットされた入力関数とは異なりますが、この動作は"%c"書式指定子を持つstd::scanfの動作と一致します。

パラメータ

st	-	データを抽出する入力ストリーム
文字	-	抽出された文字を格納する文字への参照
s	-	抽出された文字を格納する文字配列へのポインタ(C++20まで)

戻り値

1,2) st

3) std::move(st)

例

このコードを実行

#include <iomanip>
#include <iostream>
#include <sstream>
 
int main()
{
    std::string input = "n greetings";
    std::istringstream stream(input);
 
    char c;
    const int MAX = 6;
    char cstr[MAX];
 
    stream >> c >> std::setw(MAX) >> cstr;
    std::cout << "c = " << c << '\n'
              << "cstr = " << cstr << '\n';
 
    double f;
    std::istringstream("1.23") >> f; // rvalue stream extraction
    std::cout << "f = " << f << '\n';
}

出力

c = n
cstr = greet
f = 1.23

欠陥報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 13	C++98	nの定義に存在しない名前eosが言及されていた	CharT()に置換
LWG 68	C++98	オーバーロード(2)の出力の最後にヌル文字が格納されていなかった	ヌル文字を格納する
LWG 1203	C++98	右辺値ストリームのオーバーロードが基底クラスへの左辺値参照を返していた	右辺値参照を返す 派生クラスへの
LWG 2328	C++98	右辺値ストリームのオーバーロードは、別の引数が左辺値である必要があった	右辺値を受け入れるようにした
LWG 2534	C++98	右辺値ストリームのオーバーロードに制約がなかった	制約付き

関連項目

operator>>

書式付きデータを抽出する (public member function)