std:: basic_stringbuf

Определено в заголовке <sstream>
template < class CharT, class Traits = std:: char_traits < CharT > , class Allocator = std:: allocator < CharT > > class basic_stringbuf : public std:: basic_streambuf < CharT, Traits >

std::basic_stringbuf является std::basic_streambuf , чья связанная символьная последовательность представляет собой резидентную в памяти последовательность произвольных символов, которая может быть инициализирована из экземпляра std::basic_string или представлена в виде такого экземпляра.

Типичные реализации std::basic_stringbuf содержат объект типа std::basic_string или эквивалентный изменяемый контейнер последовательности непосредственно как член данных и используют его как в качестве управляемой последовательности символов (массива, на который указывают шесть указателей std::basic_streambuf ), так и в качестве ассоциированной последовательности символов (источника символов для всех операций ввода и цели для вывода).

Кроме того, типичная реализация содержит элемент данных типа std::ios_base::openmode для указания режима ввода-вывода связанного потока (только ввод, только вывод, ввод/вывод, в конце и т.д.).

Если в функции overflow() используется стратегия избыточного выделения памяти, может сохраняться дополнительный указатель верхнего уровня для отслеживания последнего инициализированного символа.

(since C++11)

Предоставлены несколько typedef для распространённых символьных типов:

Определено в заголовочном файле <sstream>
Тип	Определение
std::stringbuf	std :: basic_stringbuf < char >
std::wstringbuf	std :: basic_stringbuf < wchar_t >

Содержание 1 Типы членов 2 Члены только для демонстрации 3 Публичные функции-члены 4 Защищенные функции-члены 5 Нечленные функции 6 Наследуется от std:: basic_streambuf 6.1 Типы членов 6.2 Функции-члены 6.2.1 Локали 6.2.2 Позиционирование 6.2.3 Область получения 6.2.4 Область записи 6.2.5 Возврат символа 6.3 Защищенные функции-члены 6.3.1 Локали 6.3.2 Позиционирование 6.3.3 Область получения 6.3.4 Область записи 6.3.5 Возврат символа

Типы членов

Тип члена	Определение
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
allocator_type	Allocator

Члены только для экспозиции

buf	буфер std:: basic_string < CharT, Traits, Allocator > используемый в качестве базового буфера ( объект-член только для демонстрации* )
mode	режим std::ios_base::openmode связанного потока ( объект-член только для демонстрации* )
init_buf_ptrs	инициализирует входную и выходную последовательности ( функция-член только для демонстрации* )

Публичные функции-члены

(constructor)	создает объект basic_stringbuf (публичная функция-член)
operator= (C++11)	присваивает объект basic_stringbuf (публичная функция-член)
swap (C++11)	обменивает два объекта basic_stringbuf (публичная функция-член)
(destructor) [virtual] (implicitly declared)	уничтожает объект basic_stringbuf и содержащуюся в нем строку (виртуальная публичная функция-член)
str	заменяет или получает копию связанной строки символов (публичная функция-член)
get_allocator (C++20)	получает копию аллокатора, связанного с внутренним контейнером последовательности (публичная функция-член)
view (C++20)	получает представление (view) базовой последовательности символов (публичная функция-член)

Защищенные функции-члены

underflow [virtual]	возвращает следующий доступный символ во входной последовательности (виртуальная защищённая функция-член)
pbackfail [virtual]	возвращает символ обратно во входную последовательность (виртуальная защищённая функция-член)
overflow [virtual]	добавляет символ в выходную последовательность (виртуальная защищённая функция-член)
setbuf [virtual]	пытается заменить управляемую символьную последовательность массивом (виртуальная защищённая функция-член)
seekoff [virtual]	перемещает следующий указатель во входной последовательности, выходной последовательности или обеих, используя относительную адресацию (виртуальная защищённая функция-член)
seekpos [virtual]	перемещает следующий указатель во входной последовательности, выходной последовательности или обеих, используя абсолютную адресацию (виртуальная защищённая функция-член)

Функции, не являющиеся членами класса

std::swap (std::basic_stringbuf) (C++11)

специализирует алгоритм std::swap (шаблон функции)