Класс basic_ostringstreambasic_ostringstream Class

Описывает объект, управляющий вставкой элементов и закодированных объектов в буфер потока класса basic_stringbuf < elem, tr Alloc>.Describes an object that controls insertion of elements and encoded objects into a stream buffer of class basic_stringbuf< Elem, Tr, Alloc>.

СинтаксисSyntax

template <class Elem, class Tr = char_traits<Elem>, class Alloc = allocator<Elem>>
class basic_ostringstream : public basic_ostream<Elem, Tr>

ПараметрыParameters

ИдентификаторAlloc
Класс распределителя.The allocator class.

ElemElem
Тип основного элемента строки.The type of the basic element of the string.

ТСTr
Признаки символа, соответствующие основному элементу строки.The character traits specialized on the basic element of the string.

КомментарииRemarks

Класс описывает объект, управляющий вставкой элементов и закодированных объектов в буфер потока с элементами типа Elem , признаки символов которых определяются классом Tr и элементы, выделенные распределителем класса Alloc .The class describes an object that controls insertion of elements and encoded objects into a stream buffer, with elements of type Elem, whose character traits are determined by the class Tr, and whose elements are allocated by an allocator of class Alloc. Этот объект сохраняет объект класса basic_stringbuf< Elem, Tr, Alloc>.The object stores an object of class basic_stringbuf< Elem, Tr, Alloc>.

КонструкторыConstructors

КонструкторConstructor ОписаниеDescription
basic_ostringstreambasic_ostringstream Создает объект типа basic_ostringstream.Constructs an object of type basic_ostringstream.

Определения типовTypedefs

Имя типаType name ОписаниеDescription
allocator_typeallocator_type Тип является синонимом для выделения параметра шаблона.The type is a synonym for the template parameter Alloc.

Функции элементовMember functions

Функция-членMember function ОписаниеDescription
rdbufrdbuf Возвращает адрес буфера сохраненного потока типа pointer для basic_stringbuf < Elem , Tr Alloc>.Returns the address of the stored stream buffer of type pointer to basic_stringbuf< Elem, Tr, Alloc>.
strstr Задает или получает текст в буфере строк без изменения позиции записи.Sets or gets the text in a string buffer without changing the write position.

ТребованияRequirements

Заголовок:<sstream>Header: <sstream>

Пространство имен: stdNamespace: std

basic_ostringstream:: allocator_typebasic_ostringstream::allocator_type

Тип является синонимом для выделения параметра шаблона.The type is a synonym for the template parameter Alloc.

typedef Alloc allocator_type;

basic_ostringstream:: basic_ostringstreambasic_ostringstream::basic_ostringstream

Создает объект типа basic_ostringstream.Constructs an object of type basic_ostringstream.

explicit basic_ostringstream(ios_base::openmode _Mode = ios_base::out);

explicit basic_ostringstream(const basic_string<Elem, Tr, Alloc>& str, ios_base::openmode _Mode = ios_base::out);

ПараметрыParameters

_Mode_Mode
Одно из перечислений в ios_base::openmode.One of the enumerations in ios_base::openmode.

strstr
Объект типа basic_string.An object of type basic_string.

КомментарииRemarks

Первый конструктор инициализирует базовый класс путем вызова basic_ostream( SB), где sb — это сохраненный объект класса basic_stringbuf < elem, tr, Alloc>.The first constructor initializes the base class by calling basic_ostream( sb), where sb is the stored object of class basic_stringbuf< Elem, Tr, Alloc>. Он также инициализирует sb путем вызова basic_stringbuf< Elem, Tr, Alloc>( _Mode | ios_base::out).It also initializes sb by calling basic_stringbuf< Elem, Tr, Alloc>( _Mode | ios_base::out).

Второй конструктор инициализирует базовый класс путем вызова basic_ostream( sb).The second constructor initializes the base class by calling basic_ostream( sb). Он также инициализируется sb путем вызова basic_stringbuf< elem, tr, Alloc> (_ str, _Mode | ios_base::out ).It also initializes sb by calling basic_stringbuf< Elem, Tr, Alloc>(_ Str, _Mode | ios_base::out).

basic_ostringstream:: rdbufbasic_ostringstream::rdbuf

Возвращает адрес буфера сохраненного потока типа pointer для basic_stringbuf < elem, tr Alloc>.Returns the address of the stored stream buffer of type pointer to basic_stringbuf< Elem, Tr, Alloc>.

basic_stringbuf<Elem, Tr, Alloc> *rdbuf() const;

Возвращаемое значениеReturn Value

Адрес буфера сохраненного потока типа pointer для basic_stringbuf< elem, tr, Alloc>.The address of the stored stream buffer, of type pointer to basic_stringbuf< Elem, Tr, Alloc>.

КомментарииRemarks

Функция – член возвращает адрес буфера сохраненного потока типа pointer в basic_stringbuf< elem, tr Alloc>.The member function returns the address of the stored stream buffer of type pointer to basic_stringbuf< Elem, Tr, Alloc>.

ПримерExample

Пример, в котором используется rdbuf, см. в разделе basic_filebuf::close.See basic_filebuf::close for an example that uses rdbuf.

basic_ostringstream:: strbasic_ostringstream::str

Задает или получает текст в буфере строк без изменения позиции записи.Sets or gets the text in a string buffer without changing the write position.

basic_string<Elem, Tr, Alloc> str() const;

void str(
    const basic_string<Elem, Tr, Alloc>& _Newstr);

ПараметрыParameters

_Newstr_Newstr
Новая строка.The new string.

Возвращаемое значениеReturn Value

Возвращает объект класса basic_string < elem, tr Alloc>, управляемой последовательностью которого является копия последовательности, управляемой * этим объектом.Returns an object of class basic_string< Elem, Tr, Alloc>, whose controlled sequence is a copy of the sequence controlled by *this.

КомментарииRemarks

Первая функция – член возвращает rdbuf -> str.The first member function returns rdbuf -> str. Вторая функция-член вызывает rdbuf -> str( _Newstr ).The second member function calls rdbuf -> str( _Newstr).

ПримерExample

Пример, в котором используется, см. в разделе basic_stringbuf:: str str .See basic_stringbuf::str for an example that uses str.

См. также разделSee also

Безопасность потоков в стандартной библиотеке C++Thread Safety in the C++ Standard Library
Программирование iostreamiostream Programming
Соглашения iostreamiostreams Conventions