std::basic_string_view
| 
 在标头  
<string_view> 定义 | 
||
| (C++17 起) | ||
类模板 basic_string_view 描述一个能指代 CharT 的常量连续序列的对象,序列首元素在零位置。
对于 basic_string_view str,当有操作使得范围 [str.data(), str.data() + str.size()) 中的指针失效时,到 str 的元素的指针、迭代器和引用也会失效。
| 
 
  | 
(C++23 起) | 
典型的实现仅保有两个成员:指向常量 CharT 的指针和大小。
提供数种对常用字符类型的 typedef:
| 
 在标头  
<string_view> 定义 | 
|
| 类型 | 定义 | 
| std::string_view (C++17) | std::basic_string_view<char> | 
| std::wstring_view (C++17) | std::basic_string_view<wchar_t> | 
| std::u8string_view (C++20) | std::basic_string_view<char8_t> | 
| std::u16string_view (C++17) | std::basic_string_view<char16_t> | 
| std::u32string_view (C++17) | std::basic_string_view<char32_t> | 
模板形参
| CharT | - | 字符类型 | 
| Traits | - | 指定字符类型上的操作的字符特征 (CharTraits) 类。同 std::basic_string,Traits::char_type 必须指名相同的 CharT 类型,否则程序非良构。 | 
成员类型
| 嵌套类型 | 定义 | ||||
traits_type | 
Traits | 
||||
value_type | 
CharT | 
||||
pointer | 
CharT* | ||||
const_pointer | 
const CharT* | ||||
reference | 
CharT& | ||||
const_reference | 
const CharT& | ||||
const_iterator | 
实现定义的常量老式随机访问迭代器 (LegacyRandomAccessIterator)
 ,它的   | 
||||
iterator | 
const_iterator | 
||||
const_reverse_iterator | 
std::reverse_iterator<const_iterator> | ||||
reverse_iterator | 
const_reverse_iterator | 
||||
size_type | 
std::size_t | ||||
difference_type | 
std::ptrdiff_t | 
注意:iterator 与 const_iterator 是同一类型,因为 std::string_view 是到常量字符序列中的视图。
容器 (Container) 的迭代器类型上的所有要求同样适用于 std::basic_string_view 的 iterator 和 const_iterator 类型。
成员函数
构造函数和赋值 | 
|
构造 basic_string_view(公开成员函数)  | 
|
| 对视图赋值 (公开成员函数)  | 
|
迭代器 | 
|
| 返回指向起始位置的迭代器 (公开成员函数)  | 
|
| 返回指向结尾的迭代器 (公开成员函数)  | 
|
| 返回指向起始的反向迭代器 (公开成员函数)  | 
|
| 返回指向结尾的反向迭代器 (公开成员函数)  | 
|
元素访问 | 
|
| 访问指定字符 (公开成员函数)  | 
|
| 访问指定字符,带有边界检查 (公开成员函数)  | 
|
| 访问首个字符 (公开成员函数)  | 
|
| 访问最末字符 (公开成员函数)  | 
|
| 返回指向视图首字符的指针 (公开成员函数)  | 
|
容量 | 
|
| 返回字符数 (公开成员函数)  | 
|
| 返回最大字符数 (公开成员函数)  | 
|
| 检查视图是否为空 (公开成员函数)  | 
|
修改器 | 
|
| 通过向前移动起点收缩视图 (公开成员函数)  | 
|
| 通过向后移动末尾收缩视图 (公开成员函数)  | 
|
| 交换内容 (公开成员函数)  | 
|
操作 | 
|
| 复制字符 (公开成员函数)  | 
|
| 返回子串 (公开成员函数)  | 
|
| 比较两个视图 (公开成员函数)  | 
|
| 
 (C++20) 
 | 
检查字符串视图是否始于给定前缀 (公开成员函数)  | 
| 
 (C++20) 
 | 
检查字符串视图是否终于给定后缀 (公开成员函数)  | 
| 
 (C++23) 
 | 
检查字符串视图是否含有给定的子串或字符 (公开成员函数)  | 
| 在视图中查找字符 (公开成员函数)  | 
|
| 寻找子串的最后一次出现 (公开成员函数)  | 
|
| 查找字符的首次出现 (公开成员函数)  | 
|
| 查找字符的最后一次出现 (公开成员函数)  | 
|
| 查找字符的首次不出现 (公开成员函数)  | 
|
| 查找字符的最后一次不出现 (公开成员函数)  | 
|
常量 | 
|
| 
 [静态] 
 | 
特殊值。确切含义依赖于语境。 (公开静态成员常量)  | 
非成员函数
| 
 (C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20) 
 | 
以字典序比较两个字符串视图 (函数模板)  | 
输入/输出 | 
|
| 
 (C++17) 
 | 
进行字符串视图的流输出 (函数模板)  | 
字面量
| 
 (C++17) 
 | 
创建一个字符数组字面量的字符串视图 (函数)  | 
辅助类
| 
 (C++17)(C++17)(C++20)(C++17)(C++17) 
 | 
字符串视图的散列支持 (类模板特化)  | 
辅助模板
| 
 template<class CharT, class Traits> 
inline constexpr bool  | 
(C++20 起) | |
std::ranges::enable_borrowed_range 的此特化使得 basic_string_view 满足 borrowed_range。
| 
 template<class CharT, class Traits> 
inline constexpr bool  | 
(C++20 起) | |
std::ranges::enable_view 的此特化使得 std::basic_string_view 满足 view。
推导指引 | 
(C++20 起) | 
注解
程序员负责确保 std::basic_string_view 不在被指向数组的生存期外继续生存:
std::string_view good{"a string literal"}; // “好”的情况:"good" 指向静态数组。 // 字符串字面量位于持久数据存储中。 std::string_view bad{"a temporary string"s}; // “不好”的情况:"bad" 保有悬垂指针,由于 std::operator""s 所创建的 // std::string 临时量将在语句末尾销毁。
在 C++23 中引入的正式要求前,所有既存实现中 std::basic_string_view 的特化已经为可平凡复制类型。
| 功能特性测试宏 | 值 | 标准 | 功能特性 | 
|---|---|---|---|
__cpp_lib_string_view | 
201606L | (C++17) | std::string_view | 
| 201803L | (C++20) | 常量表达式迭代器 (ConstexprIterator) | |
__cpp_lib_string_contains | 
202011L | (C++23) | contains | 
示例
输出:
▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─ ▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─ ▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄ ▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀ ▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─▀▄─ ▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─▄▀─
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 | 
|---|---|---|---|
| LWG 3203 | C++17 | 只有从 basic_string_view 的成员函数返回的指针、迭代器和引用才会失效  | 
所有到 basic_string_view 的元素的指针、迭代器和引用都会失效  | 
参阅
| 存储并操作字符序列 (类模板)  | 
|
| 连接两个字符串,一个字符串和一个 char,或者一个字符串和一个 string_view (函数模板)  | 
|
| 
 (C++20) 
 | 
连续的对象序列上的无所有权视图 (类模板)  | 
| 
 (C++11) 
 | 
在列表初始化中创建临时数组然后引用它 (类模板)  |