operator>>(std::basic_istream)
Из ru.cppreference.net
| Определён в заголовочном файле <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] );
|
(начиная с 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>). Пробельный символ не извлекается.
|
(до C++20) |
|
(начиная с 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) |