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 равно long double.

• Если 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++.

См. также