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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 风格 I/O

缓冲

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98 中弃用)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98 中弃用)

ostrstream (C++98 中弃用)

strstream (C++98 中弃用)

同步的输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::basic_stringbuf

公开成员函数

basic_stringbuf::basic_stringbuf

basic_stringbuf::operator= (C++11)

basic_stringbuf::swap (C++11)

basic_stringbuf::str

basic_stringbuf::get_allocator (C++20)

basic_stringbuf::view (C++20)

受保护成员函数

basic_stringbuf::underflow

basic_stringbuf::pbackfail

basic_stringbuf::overflow

basic_stringbuf::setbuf

basic_stringbuf::seekoff

basic_stringbuf::seekpos

非成员函数

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

仅用于阐述的成员函数

basic_stringbuf::init_buf_ptrs

 

std::basic_string_view<CharT, Traits> view() const noexcept;		(C++20 起)

创建并返回底层字符序列上的 std::basic_string_view 。

• 对于仅输入流，返回视图表示范围 [eback(), egptr()) 。
• 对于输入/输出或仅输出流，引用从 pbase() 到序列中末字符的字符，不考虑 egptr() 和 epptr() 。
• 若流既非输入亦非输出，则返回 std::basic_string_view<CharT, Traits>{} 。

为写入打开的缓冲区中的成员字符序列能为效率目的过分配。该情况下，仅引用初始化的字符：从构造函数 string 参数获得的字符、最近对 str() 的设置器重载的 string 参数的字符或来自写入操作的字符。典型的使用过分配的实现维护一个高水位指针，以跟踪缓冲区已初始化部分的结尾，而返回的视图引用从 pbase() 到高水位指针的字符。

参数

（无）

返回值

底层字符序列上的视图。

注解

若底层字符序列被销毁或被非法化，则使用返回值是未定义行为，除非返回值为空。

常通过 std::basic_istringstream::view() 、 std::basic_ostringstream::view() 或 std::basic_stringstream::view() 访问此函数。

参阅

str	替换或获得关联字符串的副本 (公开成员函数)
operator basic_string_view (C++17)	返回到整个字符串的不可修改的 basic_string_view (std::basic_string<CharT,Traits,Allocator> 的公开成员函数)