operator>>(std::basic_istream)
定义于头文件 <istream>
|
||
template< class CharT, class Traits > basic_istream<CharT,Traits>& operator>>( basic_istream<CharT,Traits>& st, CharT& ch ); |
(1) | |
(2) | ||
template< class CharT, class Traits> basic_istream<CharT,Traits>& operator>>( basic_istream<CharT,Traits>& st, CharT* 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] ); |
(C++20 起) | |
template< class Istream, class T > Istream&& operator>>( Istream&& st, T&& value ); |
(3) | (C++11 起) |
ch
。若无字符可用,则设置 failbit (在有格式输入函数 (FormattedInputFunction) 所要求的设置 eofbit 外)。s
指向其首元素的字符数组 (C++20 前)的相继位置。若满足下列条件之一,则释出停止:
- 找到空白字符(以 ctype<CharT> 平面确定)。不释出该空白字符。
|
(C++20 前) |
|
(C++20 起) |
- 输入序列中出现文件尾(也会设置 eofbit )
Istream
为公开且无歧义派生自 std::ios_base 的类类型才参与重载决议。注解
释出作为流的最末字符的单个字符不会设置 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'; }
输出:
c = n cstr = greet f = 1.23
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
DR | 应用于 | 出版时的行为 | 正确行为 |
---|---|---|---|
LWG 1203 | C++11 | 右值流的重载返回到基类的左值引用 | 返回到派生类的右值引用 |
LWG 2328 | C++11 | 右值流的重载要求另一参数为左值 | 使之接受右值 |
LWG 2534 | C++11 | 右值流的重载未被制约 | 已制约 |
参阅
提取带格式数据 (公开成员函数) |