std::basic_stringbuf<CharT,Traits,Allocator>:: view
|
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 > { } 。
为提升效率，写入模式下缓冲区的成员字符序列可能会被过量分配。此时仅引用
已初始化字符
：这些字符来自构造函数的字符串参数、最近一次
str()
设置器重载调用使用的字符串参数，或写入操作。典型实现通过维护高水位标记指针来追踪缓冲区初始化部分的末端，返回的视图引用从
pbase
(
)
到高水位标记指针之间的字符。
目录 |
参数
(无)
返回值
对底层字符序列的视图。
注释
如果底层字符序列被销毁或失效，则使用返回值是未定义行为，除非返回值为空。
此函数通常通过 std::basic_istringstream::view() 、 std::basic_ostringstream::view() 或 std::basic_stringstream::view() 进行访问。
参见
|
替换或获取关联字符串的副本
(公开成员函数) |
|
|
(C++17)
|
返回整个字符串的不可修改
basic_string_view
(公开成员函数 of
std::basic_string<CharT,Traits,Allocator>
)
|