std::basic_stringbuf<CharT,Traits,Allocator>::view

std::basic_string_view<CharT, Traits> view() const noexcept;

Создаёт и возвращает std::basic_string_view для базовой последовательности символов.

• Для потоков только для ввода возвращаемое представление охватывает диапазон [eback(), egptr()).
• Для потоков ввода/вывода или только для вывода ссылается на символы от pbase() до последнего символа последовательности независимо от egptr() и epptr().
• Если поток не предназначен ни для ввода, ни для вывода, возвращает std::basic_string_view<CharT, Traits>{}.

Последовательность символов-членов буфера, открытого для записи, может быть выделена с запасом для повышения эффективности. В этом случае в представление включаются только инициализированные символы: это символы, полученные из строкового аргумента конструктора, строкового аргумента, использованного в последнем вызове перегрузки-сеттера str(), или в результате операции записи. Типичная реализация, использующая выделение памяти с запасом, поддерживает указатель на верхнюю границу, чтобы отслеживать конец инициализированной части буфера; возвращаемое представление ссылается на символы от pbase() до указателя на верхнюю границу.

Параметры

(нет)

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

Представление базовой последовательности символов.

Примечания

Использование возвращаемого значения приводит к неопределённому поведению, если базовая последовательность символов уничтожена или недействительна, за исключением случая, когда возвращаемое значение пусто.

К этой функции обычно обращаются через std::basic_istringstream::view(), std::basic_ostringstream::view() или std::basic_stringstream::view().

См. также