命名空间
变体
操作

operator>>(std::basic_istream)

来自 cppreference.cn
< cpp‎ | io‎ | basic istream
 
C++
 
输入/输出库
 
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。如果没有字符可用，则设置 failbit (除了 eofbit，这是 FormattedInputFunction 的要求)。
2) 行为如同 FormattedInputFunction。在构造和检查哨兵对象（可能跳过前导空白符）之后，提取连续的字符，并将它们存储在 字符数组的连续位置，该字符数组的第一个元素由(直到 C++20) s 指向。如果满足以下任何条件，则提取停止
  • 找到空白字符（由 ctype<CharT> 刻面确定）。空白字符不被提取。
  • 如果 st.width() 大于零，则存储 st.width() - 1 个字符。
 (直到 C++20)
  • 存储 n - 1 个字符，其中 n 定义如下
  • 如果 st.width() 大于零，则为 std::min(std::size_t(st.width()), N)；
  • 否则，n 为 N。
 (自 C++20 起)
  • 输入序列中发生文件结束 (这也设置 eofbit)。
在任何一种情况下，都会在输出的末尾存储一个额外的空字符值 CharT()。如果没有提取到字符，则设置 failbit (空字符仍然被写入，写入到输出的第一个位置)。最后，调用 st.width(0) 以取消 std::setw 的效果（如果有）。
3) 调用适当的提取运算符，给定输入流对象的右值引用 (等效于 st >> std::forward<T>(value))。仅当 st >> std::forward<T>(value) 形式良好，且 Istream 是公开且明确地从 std::ios_base 派生的类类型时，此重载才参与重载决议。

目录

[编辑] 注释

提取作为流的最后一个字符的单个字符不会设置 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) 的输出末尾未存储空字符 存储一个空字符
LWG 1203 C++98 用于右值流的重载返回了基类的左值引用 返回右值引用
到派生类
LWG 2328 C++98 用于右值流的重载要求另一个参数为左值 使其接受右值
LWG 2534 C++98 用于右值流的重载未受约束 已约束

[编辑] 参见

 提取格式化数据
(公共成员函数) [编辑]
Retrieved from "https://cppreference.cn/mwiki/index.php?title=cpp/io/basic_istream/operator_gtgt2&oldid=158522"