命名空间
变体
操作

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> facet 决定）。空白字符不被提取。
  • 如果 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++ 标准。

缺陷报告 应用于 发布时的行为 正确的行为
LWG 13 C++98 n 的定义提及了不存在的名称 eos 替换为 CharT()
LWG 68 C++98 重载 (2) 的输出末尾未存储空字符 存储一个空字符
LWG 1203 C++98 右值流的重载返回了基类的左值引用 返回右值引用
到派生类
LWG 2328 C++98 右值流的重载要求另一个参数为左值 改为接受右值
LWG 2534 C++98 右值流的重载未受约束 已受约束

[编辑] 参阅

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