ヘッダー ファイル <istream> で定義
| テンプレート< クラス CharT、 |
クラス テンプレートbasic_istream文字ストリームに対する高レベルの入力サポートを提供します。サポートされている操作には、フォーマットされた入力 (整数値や空白で区切られた文字や文字列など) とフォーマットされていない入力 (生の文字や文字配列など) が含まれます。この機能は、基本クラスbasic_iosを介してアクセスされる基礎となるクラスbasic_streambufによって提供されるインターフェイスに実装されます。ほとんどのライブラリ実装には、basic_istream非継承データ メンバーが 1 つあります。これは、basic_istream::gcount() によって返される値を格納するために使用されます。
非メンバー関数
文字と文字配列を抽出する
operator>>(std::basic_istream)| テンプレート< クラスCharT、クラスTraits > Basic_istream<CharT,Traits>& 演算子>>( Basic_istream<CharT,Traits>& st, CharT& ch ); |
(1) | |||
| テンプレート<クラスCharT、クラスTraits> Basic_istream<CharT,Traits>& 演算子>>( Basic_istream<CharT,Traits>& st, CharT* s ); |
(2) | (3) | (C++20まで) | |
| テンプレート< クラス CharT、クラス Traits、std::size_t N > Basic_istream<CharT,Traits>& 演算子>>( Basic_istream<CharT,Traits>& st, CharT (&s)[N] ); |
(C++20以降) | |||
| template< class CharT, class Traits, class T > |
(C++11以降) (C++17まで) |
|||
| template< class CharT, class Traits, class T > |
(C++17 起) |
1-2) 进行字符输入操作。
1) 表现为有格式输入函数 (FormattedInputFunction) 。在构造并检查 sentry 对象，因而可能跳过前导空白符后，释出一个字符并存储之到 ch。若无字符可用，则设置 failbit （在有格式输入函数 (FormattedInputFunction) 所要求的设置 eofbit 外）。
2) 表现为有格式输入函数 (FormattedInputFunction) 。在构造并检查 sentry 对象，因而可能跳过前导空白后，释出相继字符，并存储它们到 s 指向其首元素的字符数组 (C++20 前)的相继位置。若满足下列条件之一，则释出停止：
- 找到空白字符（以 ctype<CharT> 平面确定）。不释出该空白字符。
|
(C++20 前) |
|
(C++20 起) |
- 输入序列中出现文件尾（也会设置 eofbit ）
任一情况下，存储额外的空字符值 CharT() 于输出结尾。若未释出字符，则设置 failbit （仍写入空字符到输出的首位置）。最后调用 st.width(0) 取消 std::setw 的效果，若存在。
3)
| 给定到输入流对象的右值引用，调用适合的释出运算符（等价于 st >> value ）。 |
(C++11 起) (C++17 前) |
| 给定到输入流对象的右值引用，调用适合的释出运算符（等价于 st >> std::forward<T>(value) ）。此重载仅若表达式 st >> std::forward<T>(value) 为良式才参与重载决议。 |
(C++17 起) |
注意
释出作为流的最末字符的单个字符不会设置 eofbit ：这异于有格式输入函数，例如以 operator>> 释出最末的整数，但此行为匹配 std::scanf 用 "%c" 格式指定符的行为。
参数
| st | - | 要自之释出数据的输入流 |
| ch | - | 到要存储释出字符的字符的引用 |
| s | - | 指向 (C++20 前)要存储释出字符的字符数组的指针 |
返回值
st
调用示例
#include <iostream>
#include <iomanip>
#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; // 右值流释出
std::cout << "f = " << f << '\n';
return 0;
}输出
