operator>>(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)
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 );	(2)	(до 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] );	(2)		(начиная с C++20)
template< class Istream, class T > Istream&& operator>>( Istream&& st, T&& value );	(3)	(начиная с C++11)

1,2) Выполняет операции посимвольного ввода.

1) Ведёт себя как FormattedInputFunction. После создания и проверки объекта sentry, который может пропустить начальные пробельные символы, извлекает символ и сохраняет его в ch. Если символ недоступен, устанавливает failbit (в дополнение к eofbit, который устанавливается согласно требованиям к FormattedInputFunction).

2) Ведёт себя как FormattedInputFunction. После создания и проверки объекта sentry, который может пропустить начальные пробельные символы, извлекает последовательные символы и сохраняет их в последовательных позициях массива символов, на первый элемент которого указывает(до 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 не имела ограничений	добавлены ограничения

См. также

operator>>

извлекает форматированные данные
(открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/basic_istream/operator_gtgt2