operator>>(std::basic_istream)
ja.cppreference.net より
| ヘッダ <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) | |
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 );
|
(2) | (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 として振る舞います。先頭の空白をスキップする可能性のある sentry オブジェクトを構築しチェックした後、文字を抽出し、
ch に格納します。文字が利用できない場合、failbit を設定します (eofbit の設定に加えて。これは FormattedInputFunction として要求されるものです)。2) FormattedInputFunction として振る舞います。先頭の空白をスキップする可能性のある sentry オブジェクトを構築しチェックした後、連続する文字を抽出し、最初の要素が によって指される文字配列
s(C++20まで) の連続する位置に格納します。抽出は以下のいずれかの条件が満たされた場合に停止します：
- 空白文字（ctype<CharT> ファセットによって決定される）が見つかった。その空白文字は抽出されません。
|
(C++20まで) |
|
(C++20以降) |
- 入力シーケンスでファイルの終わりが発生した場合（これにより eofbit も設定されます）。
CharT() が格納されます。文字が抽出されなかった場合は、failbit を設定します (ヌル文字は出力の最初の位置に書き込まれます)。最後に、st.width(0) を呼び出して、std::setw の効果（もしあれば）を取り消します。3) 入力ストリームオブジェクトへの右辺値参照が与えられた場合、適切な抽出演算子を呼び出します (
st >> std::forward<T>(value) と同等)。このオーバーロードは、st >> std::forward<T>(value) が well-formed であり、Istream が std::ios_base から public かつ曖昧でない派生クラス型である場合にのみ、オーバーロード解決に参加します。注記
ストリームの最後の文字である単一の文字を抽出しても、
eofbit
は設定されません: これは、最後の整数を
operator
>>
で抽出するといった他の書式付き入力関数とは異なりますが、この動作は
std::scanf
の
"%c"
書式指定子を用いた場合の動作と一致します。
パラメータ
| st | - | データを抽出する入力ストリーム |
| ch | - | 抽出された文字を格納するための文字への参照 |
| 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)で出力の末尾にnull文字が格納されなかった | null文字を格納する |
| LWG 1203 | C++98 | 右辺値ストリーム用オーバーロードが基底クラスへの左辺値参照を返した |
派生クラスへの右辺値参照を返す
|
| LWG 2328 | C++98 | 右辺値ストリーム用オーバーロードが他の引数に左辺値を要求した | 右辺値を受け入れるように変更 |
| LWG 2534 | C++98 | 右辺値ストリーム用オーバーロードが制約されていなかった | 制約を追加 |
関連項目
|
書式化データを抽出
(公開メンバ関数) |