Spec-Zone.ru › C++

std::istrstream

Определено в заголовке <strstream>
class istrstream : public std::istream
(устарело в C++98)

Класс istrstream реализует операции ввода на потоках с поддержкой массивов. По существу, он оборачивает реализацию устройства ввода-вывода для массивов (std::strstreambuf) в интерфейс более высокого уровня std::basic_istream.

Типичная реализация istrstream содержит только один член данных без наследования: объект типа std::strstreambuf.

Примечания

istrstream устарело с C++98. std::istringstream и boost::iostreams::array_source рекомендуются в качестве замены.

Члены-функции

(конструктор)
создаёт объект istrstream, при необходимости выделяя буфер
(публичный член-функция)
(деструктор)
[виртуальный]
уничтожает объект istrstream, при необходимости освобождая буфер
(виртуальная публичная член-функция)
rdbuf
получает указатель на связанный буфер strstreambuf
(публичная член-функция)
str
получает доступ к буферу вывода
(публичная член-функция)

Наследуется от std::basic_istream

Члены-функции

Форматированный ввод
operator>>
извлекает отформатированные данные
(публичная член-функция std::basic_istream<CharT,Traits>)
Неформатированный ввод
get
извлекает символы
(публичная член-функция std::basic_istream<CharT,Traits>)
peek
считывает следующий символ без его извлечения
(публичная член-функция std::basic_istream<CharT,Traits>)
unget
отменяет извлечение символа
(публичная член-функция std::basic_istream<CharT,Traits>)
putback
возвращает символ в поток ввода
(публичная член-функция std::basic_istream<CharT,Traits>)
getline
извлекает символы до тех пор, пока не будет найден заданный символ
(публичная член-функция std::basic_istream<CharT,Traits>)
ignore
извлекает и отбрасывает символы до тех пор, пока не будет найден заданный символ
(публичная член-функция std::basic_istream<CharT,Traits>)
read
извлекает блоки символов
(публичная член-функция std::basic_istream<CharT,Traits>)
readsome
извлекает уже доступные блоки символов
(публичная член-функция std::basic_istream<CharT,Traits>)
gcount
возвращает количество символов, извлечённых последней операцией неформатированного ввода
(публичная член-функция std::basic_istream<CharT,Traits>)
Управление позицией
tellg
возвращает указатель на позицию ввода
(публичная член-функция std::basic_istream<CharT,Traits>)
seekg
устанавливает указатель на позицию ввода
(публичная член-функция std::basic_istream<CharT,Traits>)
Разное
sync
синхронизируется с базовым устройством хранения
(публичная член-функция std::basic_istream<CharT,Traits>)

Вложенные классы

sentry
реализует базовую логику подготовки потока для операций ввода
(публичный вложенный класс std::basic_istream<CharT,Traits>)

Наследуется от std::basic_ios

Типы членов

Тип члена Определение
char_type CharT
traits_type Traits
int_type Traits::int_type
pos_type Traits::pos_type
off_type Traits::off_type

Члены-функции

Функции состояния
good
проверяет, не произошло ли ошибку, т.е. доступны операции ввода-вывода
(общедоступная функция-член std::basic_ios<CharT,Traits>)
eof
проверяет, достигнут ли конец файла
(общедоступная функция-член std::basic_ios<CharT,Traits>)
fail
проверяет, произошла ли ошибка
(общедоступная функция-член std::basic_ios<CharT,Traits>)
bad
проверяет, произошла ли неисправимая ошибка
(общедоступная функция-член std::basic_ios<CharT,Traits>)
operator!
проверяет, произошла ли ошибка (синоним fail())
(общедоступная функция-член std::basic_ios<CharT,Traits>)
operator bool
проверяет, не произошла ли ошибка (синоним !fail())
(общедоступная функция-член std::basic_ios<CharT,Traits>)
rdstate
возвращает флаги состояния
(общедоступная функция-член std::basic_ios<CharT,Traits>)
setstate
устанавливает флаги состояния
(общедоступная функция-член std::basic_ios<CharT,Traits>)
clear
изменяет флаги состояния
(общедоступная функция-член std::basic_ios<CharT,Traits>)
Форматирование
copyfmt
копирует информацию о форматировании
(общедоступная функция-член std::basic_ios<CharT,Traits>)
fill
управляет символом заполнения
(общедоступная функция-член std::basic_ios<CharT,Traits>)
Разное
exceptions
управляет маской исключений
(общедоступная функция-член std::basic_ios<CharT,Traits>)
imbue
устанавливает локаль
(общедоступная функция-член std::basic_ios<CharT,Traits>)
rdbuf
управляет связанным буфером потока
(общедоступная функция-член std::basic_ios<CharT,Traits>)
tie
управляет связанным потоком
(общедоступная функция-член std::basic_ios<CharT,Traits>)
narrow
сужает символы
(общедоступная функция-член std::basic_ios<CharT,Traits>)
widen
расширяет символы
(общедоступная функция-член std::basic_ios<CharT,Traits>)

Наследуется от std::ios_base

Члены-функции

Форматирование
flags
управляет флагами форматирования
(общедоступная функция-член std::ios_base)
setf
устанавливает конкретный флаг форматирования
(общедоступная функция-член std::ios_base)
unsetf
сбрасывает конкретный флаг форматирования
(общедоступная функция-член std::ios_base)
precision
управляет десятичной точностью операций с плавающей запятой
(общедоступная функция-член std::ios_base)
width
управляет шириной поля
(общедоступная функция-член std::ios_base)
Локали
imbue
устанавливает локаль
(общедоступная функция-член std::ios_base)
getloc
возвращает текущую локаль
(общедоступная функция-член std::ios_base)
Внутренний расширяемый массив
xalloc
[static]
возвращает уникальное целое число в масштабе всей программы, которое безопасно использовать в качестве индекса для pword() и iword()
(общедоступная статическая функция-член std::ios_base)
iword
при необходимости перераспределяет частное хранилище и предоставляет доступ к элементу типа long по данному индексу
(общедоступная функция-член std::ios_base)
pword
при необходимости перераспределяет частное хранилище и предоставляет доступ к элементу типа void* по данному индексу
(общедоступная функция-член std::ios_base)
Разное
register_callback
регистрирует функцию обратного вызова события
(общедоступная функция-член std::ios_base)
sync_with_stdio
[static]
устанавливает, будут ли C++ и C библиотеки ввода-вывода взаимосвязаны
(общедоступная статическая функция-член std::ios_base)
Вложенные классы
failure
исключение потока
(общедоступный вложенный класс std::ios_base)
Init
инициализирует стандартные объекты потока
(общедоступный вложенный класс std::ios_base)
END_OF_DOCUMENT_MARKER

Типы и константы членов

Тип Объяснение
openmode
тип режима открытия потока

Также определены следующие константы:

Константа Объяснение
app переход к концу потока перед каждым записью
binary открытие в двоичном режиме
in открытие для чтения
out открытие для записи
trunc удаление содержимого потока при открытии
ate переход к концу потока сразу после открытия
noreplace (C++23) открытие в эксклюзивном режиме

(typedef)
fmtflags
тип флагов форматирования

Также определены следующие константы:

Константа Объяснение
dec использование десятичной системы счисления для целочисленных ввода/вывода: см. std::dec
oct использование восьмеричной системы счисления для целочисленных ввода/вывода: см. std::oct
hex использование шестнадцатеричной системы счисления для целочисленных ввода/вывода: см. std::hex
basefield dec | oct | hex. Полезно для операций маскирования
left выравнивание по левому краю (добавляет символы заполнения справа): см. std::left
right выравнивание по правому краю (добавляет символы заполнения слева): см. std::right
internal внутреннее выравнивание (добавляет символы заполнения во внутреннюю заданную точку): см. std::internal
adjustfield left | right | internal. Полезно для операций маскирования
scientific генерация типов с плавающей точкой в научной нотации или шестнадцатеричной нотации, если объединено с fixed: см. std::scientific
fixed генерация типов с плавающей точкой в фиксированной нотации или шестнадцатеричной нотации, если объединено с scientific: см. std::fixed
floatfield scientific | fixed. Полезно для операций маскирования
boolalpha вставка и извлечение типа bool в алфавитно-цифровом формате: см. std::boolalpha
showbase генерация префикса, указывающего на систему счисления для целочисленного вывода, требует указателя валюты при денежном вводе/выводе: см. std::showbase
showpoint безусловное создание разделителя десятичных знаков для вывода чисел с плавающей точкой: см. std::showpoint
showpos генерация символа + для неотрицательного числового вывода: см. std::showpos
skipws пропускать начальные пробелы перед определенными операциями ввода: см. std::skipws
unitbuf выполнить сброс вывода после каждой операции вывода: см. std::unitbuf
uppercase замена определенных строчных букв их прописными аналогами в некоторых операциях вывода: см. std::uppercase

(typedef)
iostate
тип состояния потока

Также определены следующие константы:

Константа Объяснение
goodbit нет ошибки
badbit неисправимая ошибка потока
failbit операция ввода/вывода завершилась неудачей (ошибка форматирования или извлечения)
eofbit связанная последовательность ввода достигла конца файла

(typedef)
seekdir
тип направления поиска

Также определены следующие константы:

Константа Объяснение
beg начало потока
end конец потока
cur текущее положение указателя позиции потока

(typedef)
event
указывает на тип события
(enum)
event_callback
тип обратного вызова функции
(typedef)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API