std::basic_istream
Определено в заголовке <istream> | ||
|---|---|---|
template<
class CharT,
class Traits = std::char_traits<CharT>
> class basic_istream : virtual public std::basic_ios<CharT, Traits>
|
Шаблон класса basic_istream обеспечивает поддержку операций ввода высокого уровня для потоков символов. Поддерживаемые операции включают форматированный ввод (например, целочисленные значения или символы и строки символов, разделенные пробелами) и неформатированный ввод (например, символы и массивы символов). Эта функциональность реализуется с использованием интерфейса, предоставляемого базовым классом basic_streambuf, доступ к которому осуществляется через базовый класс basic_ios. Единственный не наследуемый член данных basic_istream, в большинстве реализаций, — это значение, возвращаемое функцией basic_istream::gcount().
Диаграмма наследования
Предоставлены несколько определений типов для распространённых типов символов:
Определено в заголовке <istream> |
|
|---|---|
| Тип | Определение |
std::istream | std::basic_istream<char> |
std::wistream | std::basic_istream<wchar_t> |
Глобальные объекты
Библиотека стандартной библиотеки предоставляет два глобальных объекта basic_istream.
Определено в заголовке <iostream> |
|
|---|---|
считывает данные из стандартного потока ввода C stdin;(глобальный объект) |
|
Типы членов
| Тип члена | Определение |
|---|---|
char_type | CharT |
traits_type | Traits; программа некорректна, если Traits::char_type не является CharT. |
int_type | Traits::int_type |
pos_type | Traits::pos_type |
off_type | Traits::off_type |
Члены-функции
| конструирует объект (публичный член-функция) |
|
|
[виртуальный] | деструктирует объект (виртуальная публичная член-функция) |
|
(C++11) | перемещающее присваивание из другого basic_istream (защищённый член-функция) |
Форматированный ввод |
|
| извлекает форматированные данные (публичный член-функция) |
|
Неформатированный ввод |
|
| извлекает символы (публичный член-функция) |
|
| читает следующий символ без его извлечения (публичный член-функция) |
|
| возвращает символ назад в поток ввода (публичный член-функция) |
|
| помещает символ в поток ввода (публичный член-функция) |
|
| извлекает символы до тех пор, пока не встретится заданный символ (публичный член-функция) |
|
| извлекает и игнорирует символы до тех пор, пока не встретится заданный символ (публичный член-функция) |
|
| извлекает блоки символов (публичный член-функция) |
|
| извлекает уже доступные блоки символов (публичный член-функция) |
|
| возвращает количество символов, извлечённых последней операцией неформатированного ввода (публичный член-функция) |
|
Управление позицией |
|
| возвращает указатель позиции ввода (публичный член-функция) |
|
| устанавливает указатель позиции ввода (публичный член-функция) |
|
Разное |
|
| синхронизирует с базовым устройством хранения данных (публичный член-функция) |
|
|
(C++11) | обменивается объектами потока, за исключением связанного буфера (защищённый член-функция) |
Вложенные классы
| реализует базовые логические элементы для подготовки потока к операциям ввода (публичный вложенный класс) |
Нечлены-функции
| извлекает символы и массивы символов (шаблон функции) |
Наследуется от std::basic_ios
Типы членов
| Тип члена | Определение |
|---|---|
char_type | CharT |
traits_type | Traits |
int_type | Traits::int_type |
pos_type | Traits::pos_type |
off_type | Traits::off_type |
Члены-функции
Функции состояния |
|
| проверяет, не возникла ли ошибка, т.е. доступны операции ввода-вывода (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| проверяет, достигнут ли конец файла (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| проверяет, возникла ли ошибка (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| проверяет, возникла ли невосстановимая ошибка (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
проверяет, возникла ли ошибка (синоним fail()) (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
проверяет, не возникла ли ошибка (синоним !fail()) (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| возвращает флаги состояния (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| устанавливает флаги состояния (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| изменяет флаги состояния (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
Форматирование |
|
| копирует информацию о форматировании (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| управляет символом заполнения (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
Разное |
|
| управляет маской исключений (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| задаёт локаль (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| управляет ассоциированным буфером потока (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| управляет связанным потоком (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| сужает символы (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
| расширяет символы (общедоступная функция-член std::basic_ios<CharT,Traits>) |
|
Наследуется от std::ios_base
Члены-функции
Форматирование |
|
| управляет флагами форматирования (общедоступная функция-член std::ios_base) |
|
| устанавливает определённый флаг форматирования (общедоступная функция-член std::ios_base) |
|
| сбрасывает определённый флаг форматирования (общедоступная функция-член std::ios_base) |
|
| управляет десятичной точностью операций с плавающей точкой (общедоступная функция-член std::ios_base) |
|
| управляет шириной поля (общедоступная функция-член std::ios_base) |
|
Локали |
|
| устанавливает локаль (общедоступная функция-член std::ios_base) |
|
| возвращает текущую локаль (общедоступная функция-член std::ios_base) |
|
Внутренний расширяемый массив |
|
|
[static] | возвращает уникальный целочисленный идентификатор, пригодный для использования в качестве индекса к pword() и iword() (общедоступная статическая функция-член std::ios_base) |
| при необходимости изменяет размер частного хранилища и обеспечивает доступ к элементу типа long по заданному индексу (общедоступная функция-член std::ios_base) |
|
| при необходимости изменяет размер частного хранилища и обеспечивает доступ к элементу типа void* по заданному индексу (общедоступная функция-член std::ios_base) |
|
Разное |
|
| регистрирует функцию обратного вызова событий (общедоступная функция-член std::ios_base) |
|
|
[static] | задаёт, будут ли C++ и C библиотеки ввода-вывода взаимодействовать (общедоступная статическая функция-член std::ios_base) |
Вложенные классы |
|
| исключение потока (общедоступный вложенный класс std::ios_base) |
|
| инициализирует стандартные объекты потоков (общедоступный вложенный класс std::ios_base) |
|
Типы и константы членов |
|||||||||||||||||||||||||||||||||||||||
| Тип | Объяснение | ||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Тип режима открытия потока Также определены следующие константы:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
| Тип флагов форматирования Также определены следующие константы:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
| Тип состояния потока Также определены следующие константы:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
| Тип направления поиска Также определены следующие константы:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
| Указывает тип события (перечисление) |
|||||||||||||||||||||||||||||||||||||||
| Тип обратной функции (typedef) |
|||||||||||||||||||||||||||||||||||||||
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/basic_istream
