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().

См. также