C++ 参考手册

位置:首页 > C++ 参考手册 >输入/输出库 >std::basic_istream > std::basic_istream<CharT,Traits>::operator>>

basic_istream& operator>>( short& value );
basic_istream& operator>>( unsigned short& value );
(1)
basic_istream& operator>>( int& value );
basic_istream& operator>>( unsigned int& value );
(2)
basic_istream& operator>>( long& value );
basic_istream& operator>>( unsigned long& value );
(3)
basic_istream& operator>>( long long& value );
basic_istream& operator>>( unsigned long long& value );
(4) (C++11 起)
basic_istream& operator>>( float& value );

basic_istream& operator>>( double& value );

basic_istream& operator>>( long double& value );
(5)
basic_istream& operator>>( bool& value );
(6)
basic_istream& operator>>( void*& value );
(7)
basic_istream& operator>>( std::ios_base& (*func)(std::ios_base&) );
(8)
basic_istream& operator>>( std::basic_ios<CharT,Traits>&
                           (*func)(std::basic_ios<CharT,Traits>&) );
(9)
basic_istream& operator>>( basic_istream& (*func)(basic_istream&) );
(10)
basic_istream& operator>>( std::basic_streambuf<CharT,Traits>* sb );
(11)

从输入流释出值。

1-4) 释出整数值,潜在地跳过前导空格。存储值到给定的引用 value
此函数表现为有格式输入函数 (FormattedInputFunction) 。构造并检查 sentry 对象,可能跳过前导空格后,通过调用 std::num_get::get() 释出整数值。
5) 释出浮点值,潜在地跳过前导空格。存储值到给定的引用 value
此函数表现为有格式输入函数 (FormattedInputFunction) 。构造并检查 sentry 对象,可能跳过前导空格后,通过调用 std::num_get::get() 释出浮点值。
6) 释出布尔值,潜在地跳过前导空格。存储值到给定的引用 value
此函数表现为有格式输入函数 (FormattedInputFunction) 。构造并检查 sentry 对象,可能跳过前导空格后,通过调用 std::num_get::get() 释出 bool 值。
7) 释出泛用指针值,潜在地跳过前导空格。存储值到给定的引用 value
此函数表现为有格式输入函数 (FormattedInputFunction) 。构造并检查 sentry 对象,可能跳过前导空格后,通过调用 std::num_get::get() 释出泛用指针值。
8-10) 调用 func(*this) ,其中 func 为 I/O 操纵符。
11) 表现为无格式输入函数 (UnformattedInputFunction) 。在构造并检查 sentry 对象后,从输入流释出所有数据并将它存储到 sb 。若满足下列条件之一则释出停止:
  • 输入序列上出现文件尾;
  • 输出序列中插入失败(该情况下不释出要被插入的字符);
  • 出现异常(该情况下捕捉异常,而仅若 exceptions() 中启用了 failbit 才重抛)。
任一情况下,存储释出的字符数于成员变量中,其值可由对 gcount() 的后继调用访问。若 sb 为空指针或未插入字符到 sb 中,则调用 setstate(failbit) (若启用则会抛出 std::ios_base::failure )。

若释出失败(例如若在期待数位处遇到字母),则保留 value 不修改并设置 failbit

(C++11 前)

若释出失败,则写入零到 value 并设置 failbit 。若释出结果对于 value 过大或过小,则写入 std::numeric_limits<T>::max()std::numeric_limits<T>::min() 并设置 failbit 标志。

(C++11 起)

参数

value - 到要存储释出值到的整数或浮点值的引用
func - 指向 I/O 操纵符函数的指针
sb - 指向要写入全部数据到的流缓冲的指针

返回值

1-9,11) *this
10) func(*this)

示例

#include <iostream>
#include <iomanip>
#include <sstream>
 
int main()
{
    std::string input = "41 3.14 false hello world";
    std::istringstream stream(input);
    int n;
    double f;
    bool b;
 
    stream >> n >> f >> std::boolalpha >> b;
    std::cout << "n = " << n << '\n'
              << "f = " << f << '\n'
              << "b = " << std::boolalpha << b << '\n';
 
    // 用 streambuf 重载释出剩余内容
    stream >> std::cout.rdbuf();
    std::cout << '\n';
}

输出:

n = 41
f = 3.14
b = false
hello world

参阅

提取字符和字符数组
(函数模板)
执行字符串的流输入与输出
(函数模板)
执行 bitset 的流输入和输出
(函数)
复数的序列化和反序列化
(函数模板)
执行伪随机数引擎的流输入和输出
(函数)
执行伪随机数分布的流输入和输出
(函数模板)
读并取走一块字符
(公开成员函数)
读并取走已经可用的字符块
(公开成员函数)
从流中读并取走(移除类似指针向下一个元素移动)一个字符
(公开成员函数)
一直读并取走字符,直至找到给定字符
(公开成员函数)
转换字符序列到整数或浮点值
(函数)