Namespaces
Variants

operator>> (std::basic_istream)

From cppreference.net
C++
Input/output library
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) Вызывает соответствующий оператор извлечения, передавая rvalue-ссылку на объект входного потока (эквивалентно 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 перегрузка для rvalue потока возвращала lvalue ссылку на базовый класс возвращает rvalue ссылку
на производный класс
LWG 2328 C++98 перегрузка для rvalue потока требовала, чтобы другой аргумент был lvalue изменена для принятия rvalue
LWG 2534 C++98 перегрузка для rvalue потока не была ограничена ограничена

Смотрите также

извлекает форматированные данные
(public member function)