std::basic_istream<CharT,Traits>::operator>>

basic_istream& operator>>( unsigned short& value );

basic_istream& operator>>( unsigned int& value );

basic_istream& operator>>( long& value );

basic_istream& operator>>( unsigned long& value );

basic_istream& operator>>( long long& value );

basic_istream& operator>>( unsigned long long& value );

basic_istream& operator>>( float& value );

basic_istream& operator>>( double& value );

basic_istream& operator>>( long double& value );

basic_istream& operator>>( bool& value );

basic_istream& operator>>( void*& value );

basic_istream& operator>>( short& value );

basic_istream& operator>>( int& value );

basic_istream& operator>>( /* extended-floating-point-type */& value );

basic_istream& operator>>( std::ios_base& (*func)(std::ios_base&) );

basic_istream& operator>>( std::basic_ios<CharT, Traits>& 
                               (*func)(std::basic_ios<CharT, Traits>&) );

basic_istream& operator>>( basic_istream& (*func)(basic_istream&) );

basic_istream& operator>>( std::basic_streambuf<CharT, Traits>* sb );

Извлекает значения из входного потока.

• Если lval < std::numeric_limits<short>::min(), устанавливает failbit и сохраняет std::numeric_limits<short>::min() в val.
• Иначе, если std::numeric_limits<short>::max() < lval, устанавливает failbit и сохраняет std::numeric_limits<short>::max() в val.
• В противном случае сохраняет static_cast<short>(lval) в val.

• Если lval < std::numeric_limits<int>::min(), устанавливает failbit и сохраняет std::numeric_limits<int>::min() в val.
• Иначе, если std::numeric_limits<int>::max() < lval, устанавливает failbit и сохраняет std::numeric_limits<int>::max() в val.
• В противном случае сохраняет static_cast<int>(lval) в val.

• Если ранг преобразования типа с плавающей точкой для /* extended-floating-point-type */ меньше или равен рангу типа float, то FP — это float.
• Иначе, если ранг преобразования типа с плавающей точкой для /* extended-floating-point-type */ меньше или равен рангу типа double, то FP — это double.
• В противном случае FP — это longdouble.

• Если fval < -std::numeric_limits</* extended-floating-point-type */>::max(), устанавливает failbit и сохраняет -std::numeric_limits</* extended-floating-point-type */>::max() в val.
• Иначе, если std::numeric_limits</* extended-floating-point-type */>::max() < fval, устанавливает failbit и сохраняет std::numeric_limits</* extended-floating-point-type */>::max() в val.
• В противном случае сохраняет static_cast</* extended-floating-point-type */>(fval) в val.

Если извлечение завершается неудачей (например, если вместо цифры введена буква), в value записывается ноль и устанавливается failbit. Для знаковых целых чисел, если в результате извлечения получено значение, слишком большое или слишком маленькое для представления в value, записывается соответственно std::numeric_limits<T>::max() или std::numeric_limits<T>::min() и устанавливается флаг failbit. Для беззнаковых целых чисел, если в результате извлечения получено значение, слишком большое или слишком маленькое для представления в value, записывается std::numeric_limits<T>::max() и устанавливается флаг failbit.

Параметры

Возвращаемое значение

Примечания

Для перегрузки (14), если ранг преобразования расширенного типа с плавающей точкой не совпадает с рангом ни одного стандартного типа с плавающей точкой, двойное округление при преобразовании может привести к неточным результатам. В ситуациях, когда важна максимальная точность, можно использовать std::from_chars().

Пример

#include <iomanip>
#include <iostream>
#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';
    
    // extract the rest using the streambuf overload
    stream >> std::cout.rdbuf();
    std::cout << '\n';
}

n = 41
f = 3.14
b = false
hello world

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

См. также