std::experimental::basic_string_view

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行性扩展 (并行性 TS)

并行性扩展 2 (并行性 TS v2)

并发性扩展 (并发性 TS)

并发扩展 2 (concurrency TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 TR)

实验性非 TS

模式匹配

线性代数

std::execution

契约

2D 图形

 

库基础

experimental::optional

experimental::any

experimental::basic_string_view

experimental::sample

experimental::shared_ptr

experimental::weak_ptr

experimental::apply

experimental::invocation_typeexperimental::raw_invocation_type

experimental::search

experimental::default_searcherexperimental::make_default_searcher

experimental::boyer_moore_searcherexperimental::make_boyer_moore_searcher

experimental::boyer_moore_horspool_searcherexperimental::make_boyer_moore_horspool_searcher

类型擦除和多态分配器

类型特征的变量模板

 

std::experimental::basic_string_view

成员函数 basic_string_view::basic_string_view basic_string_view::operator= 迭代器 basic_string_view::beginbasic_string_view::cbegin basic_string_view::endbasic_string_view::cend basic_string_view::rbeginbasic_string_view::crbegin basic_string_view::rendbasic_string_view::crend 元素访问 basic_string_view::at basic_string_view::operator[] basic_string_view::front basic_string_view::back basic_string_view::data 容量 basic_string_view::sizebasic_string_view::length basic_string_view::max_size basic_string_view::empty 修改器 basic_string_view::remove_prefix basic_string_view::remove_suffix basic_string_view::swap

操作 basic_string_view::to_stringbasic_string_view::operator basic_string basic_string_view::copy basic_string_view::substr basic_string_view::compare basic_string_view::find basic_string_view::rfind basic_string_view::find_first_of basic_string_view::find_last_of basic_string_view::find_first_not_of basic_string_view::find_last_not_of 常量 basic_string_view::npos 非成员函数 operator==operator!=operator<operator>operator<=operator>= operator<< 辅助类 hash<std::string_view>hash<std::wstring_view>hash<std::u16string_view>hash<std::u32string_view>

 

定义于头文件 <experimental/string_view>
template<     class CharT,     class Traits = std::char_traits<CharT> > class basic_string_view;		(库基础 TS)

类模板 basic_string_view 描述了一个对象，该对象可以引用一个常量连续的类字符对象序列，序列的第一个元素位于位置零。

典型的实现只包含两个成员：一个指向常量 CharT 的指针和一个大小。

提供了用于常见字符类型的几个 typedef

定义于头文件 <experimental/string_view>
类型	定义
std::experimental::string_view	std::experimental::basic_string_view<char>
std::experimental::wstring_view	std::experimental::basic_string_view<wchar_t>
std::experimental::u16string_view	std::experimental::basic_string_view<char16_t>
std::experimental::u32string_view	std::experimental::basic_string_view<char32_t>

模板参数

CharT	-	字符类型
特性	-	特性类，指定字符类型的操作

成员类型

成员类型	定义
traits_type	特性
value_type	CharT
pointer	CharT*
const_pointer	const CharT*
reference	CharT&
const_reference	const CharT&
const_iterator	实现定义的 LegacyRandomAccessIterator
iterator	const_iterator
reverse_iterator	const_reverse_iterator
const_reverse_iterator	std::reverse_iterator<const_iterator>
size_type	std::size_t
difference_type	std::ptrdiff_t

注意：iterator 和 const_iterator 是同一类型，因为字符串视图是对常量字符序列的视图。

成员函数

(构造函数)	构造 basic_string_view (public member function)
operator=	赋值视图 (public member function)
迭代器
begincbegin	返回指向起始的迭代器 (public member function)
endcend	返回指向末尾的迭代器 (public member function)
rbegincrbegin	返回指向起始的逆向迭代器 (public member function)
rendcrend	返回指向末尾的逆向迭代器 (public member function)
元素访问
operator[]	访问指定的字符 (public member function)
at	带边界检查的访问指定字符 (public member function)
front	访问第一个字符 (public member function)
back	访问最后一个字符 (public member function)
data	返回指向视图首字符的指针 (public member function)
容量
sizelength	返回字符数 (public member function)
max_size	返回字符的最大数量 (public member function)
empty	检查视图是否为空 (public member function)
修改器
remove_prefix	通过前移其起始位置来收缩视图 (public member function)
remove_suffix	通过后移其末尾位置来收缩视图 (public member function)
swap	交换内容 (public member function)
操作
to_stringoperator basic_string	从视图创建字符串 (public member function)
copy	复制字符 (public member function)
substr	返回子字符串 (public member function)
compare	比较两个视图 (public member function)
find	在视图中查找字符 (public member function)
rfind	查找子串的最后一次出现 (public member function)
find_first_of	查找字符的首次出现 (public member function)
find_last_of	查找字符的最后一次出现 (public member function)
find_first_not_of	查找字符的首次缺席 (public member function)
find_last_not_of	查找字符的最后一次缺席 (public member function)
常量
npos [静态]	特殊值。确切含义取决于上下文 (public static member constant)

非成员函数

operator==operator!=operator<operator>operator<=operator>=	按字典序比较两个视图 (function template)
输入/输出
operator<<	对视图执行流输出 (function template)

辅助类

std::hash<std::experimental::string_view>std::hash<std::experimental::wstring_view>std::hash<std::experimental::u16string_view>std::hash<std::experimental::u32string_view>

对视图的哈希支持 (class template specialization)

特性测试宏

__cpp_lib_experimental_string_view

值至少为 201411 表示支持 basic_string_view 模板 (宏常量)