basic_string< CharT, Traits, Alloc > 模板类 参考

基础字符串模板 更多...

#include <basic_string.hpp>

类 basic_string< CharT, Traits, Alloc > 继承关系图:

Public 类型
using	value_type = CharT
	值类型
using	pointer = CharT*
	指针类型
using	reference = CharT&
	引用类型
using	const_pointer = const CharT*
	常量指针类型
using	const_reference = const CharT&
	常量引用类型
using	size_type = size_t
	大小类型
using	difference_type = ptrdiff_t
	差值类型
using	iterator = basic_string_iterator<false, basic_string>
	迭代器类型
using	const_iterator = basic_string_iterator<true, basic_string>
	常量迭代器类型
using	reverse_iterator = _NEFORCE reverse_iterator<iterator>
	反向迭代器类型
using	const_reverse_iterator = _NEFORCE reverse_iterator<const_iterator>
	常量反向迭代器类型
using	traits_type = Traits
	字符特征类型
using	view_type = basic_string_view<CharT, Traits>
	字符串视图类型
using	allocator_type = Alloc
	分配器类型

Public 成员函数
constexpr	basic_string ()
	默认构造函数
constexpr	basic_string (size_type n)
	构造函数，指定大小
constexpr	basic_string (size_type n, int32_t value)
	构造函数，指定大小和32位整数值
constexpr	basic_string (size_type n, int64_t value)
	构造函数，指定大小和64位整数值
constexpr	basic_string (size_type n, value_type value)
	构造函数，指定大小和填充字符
constexpr	basic_string (const basic_string &other)
	拷贝构造函数
constexpr basic_string &	operator= (const basic_string &other)
	拷贝赋值运算符
constexpr	basic_string (basic_string &&other) noexcept
	移动构造函数
constexpr basic_string &	operator= (basic_string &&other) noexcept
	移动赋值运算符
constexpr	basic_string (view_type view)
	从字符串视图构造
constexpr	basic_string (view_type view, const size_type n)
	从字符串视图构造（指定长度）
constexpr basic_string &	operator= (view_type view)
	字符串视图赋值运算符
constexpr	basic_string (const basic_string &other, size_type position)
	从子串构造
constexpr	basic_string (const basic_string &other, size_type position, size_type n)
	从子串构造（指定长度）
constexpr	basic_string (const_pointer str)
	从C风格字符串构造
constexpr	basic_string (const_pointer str, const size_type n)
	从字符数组构造（指定长度）
constexpr basic_string &	operator= (const_pointer str)
	C风格字符串赋值运算符
template<typename Iterator, enable_if_t<!is_convertible_v< Iterator, value_type >, int > = 0>
constexpr	basic_string (Iterator first, Iterator last)
	从迭代器范围构造
constexpr	basic_string (std::initializer_list< value_type > ilist)
	从初始化列表构造
constexpr basic_string &	operator= (std::initializer_list< value_type > ilist)
	初始化列表赋值运算符
constexpr	~basic_string ()
	析构函数
constexpr iterator	begin () noexcept
	获取起始迭代器
constexpr iterator	end () noexcept
	获取结束迭代器
constexpr const_iterator	begin () const noexcept
	获取常量起始迭代器
constexpr const_iterator	end () const noexcept
	获取常量结束迭代器
constexpr const_iterator	cbegin () const noexcept
	获取常量起始迭代器
constexpr const_iterator	cend () const noexcept
	获取常量结束迭代器
constexpr reverse_iterator	rbegin () noexcept
	获取反向起始迭代器
constexpr reverse_iterator	rend () noexcept
	获取反向结束迭代器
constexpr const_reverse_iterator	rbegin () const noexcept
	获取常量反向起始迭代器
constexpr const_reverse_iterator	rend () const noexcept
	获取常量反向结束迭代器
constexpr const_reverse_iterator	crbegin () const noexcept
	获取常量反向起始迭代器
constexpr const_reverse_iterator	crend () const noexcept
	获取常量反向结束迭代器
constexpr size_type	size () const noexcept
	获取字符数
constexpr size_type	max_size () const noexcept
	获取最大可能大小
constexpr size_type	capacity () const noexcept
	获取容量
constexpr size_type	length () const noexcept
	获取字符串长度
constexpr bool	empty () const noexcept
	检查是否为空
constexpr void	reserve (const size_type n)
	预留容量
constexpr reference	operator[] (const size_type n) noexcept
	下标访问操作符
constexpr const_reference	operator[] (const size_type n) const noexcept
	常量下标访问操作符
constexpr reference	at (const size_type n) noexcept
	带边界检查的访问
constexpr const_reference	at (const size_type n) const noexcept
	带边界检查的常量访问
constexpr reference	front () noexcept
	访问第一个字符
constexpr const_reference	front () const noexcept
	常量访问第一个字符
constexpr reference	back () noexcept
	访问最后一个字符
constexpr const_reference	back () const noexcept
	常量访问最后一个字符
constexpr pointer	data () noexcept
	获取数据指针
constexpr const_pointer	data () const noexcept
	获取常量数据指针
constexpr iterator	insert (iterator position, value_type value)
	插入单个字符
constexpr basic_string &	insert (size_type position, size_type n, value_type value)
	在指定位置插入多个相同字符
template<typename Iterator>
constexpr iterator	insert (iterator position, Iterator first, Iterator last)
	插入迭代器范围
constexpr void	push_back (value_type value)
	在末尾插入字符
constexpr void	pop_back () noexcept
	删除末尾字符
constexpr basic_string &	append (size_type n, value_type value)
	追加多个相同字符
constexpr basic_string &	append (value_type value)
	追加单个字符
constexpr basic_string &	append (const basic_string &other, size_type position, size_type n)
	追加另一个字符串的子串
constexpr basic_string &	append (const basic_string &other)
	追加另一个字符串
constexpr basic_string &	append (const basic_string &other, size_type position)
	追加另一个字符串的子串
constexpr basic_string &	append (basic_string &&other, size_type position, size_type n)
	追加移动字符串的子串
constexpr basic_string &	append (basic_string &&other)
	追加移动字符串
constexpr basic_string &	append (basic_string &&other, size_type position)
	追加移动字符串的子串
constexpr basic_string &	append (view_type view, size_type n)
	追加字符串视图的指定长度
constexpr basic_string &	append (view_type view)
	追加字符串视图
constexpr basic_string &	append (const_pointer str, size_type n)
	追加字符数组的指定长度
constexpr basic_string &	append (const_pointer str)
	追加C风格字符串
template<typename Iterator, enable_if_t< is_iter_v< Iterator >, int > = 0>
constexpr basic_string &	append (Iterator first, Iterator last)
	追加迭代器范围
constexpr basic_string &	append (std::initializer_list< value_type > ilist)
	追加初始化列表
constexpr basic_string &	operator+= (const basic_string &other)
	追加另一个字符串
constexpr basic_string &	operator+= (basic_string &&other)
	追加移动字符串
constexpr basic_string &	operator+= (const value_type value)
	追加单个字符
constexpr basic_string &	operator+= (const_pointer str)
	追加C风格字符串
constexpr basic_string &	operator+= (std::initializer_list< value_type > ilist)
	追加初始化列表
constexpr basic_string &	operator+= (view_type view)
	追加字符串视图
constexpr basic_string &	assign (const basic_string &other)
	赋值另一个字符串
constexpr basic_string &	assign (basic_string &&other)
	赋值移动字符串
constexpr basic_string &	assign (const_pointer str)
	赋值C风格字符串
constexpr basic_string &	assign (const_pointer str, const size_type n)
	赋值字符数组的指定长度
constexpr basic_string &	assign (const size_type n, value_type value)
	赋值多个相同字符
template<typename Iterator>
constexpr basic_string &	assign (Iterator first, Iterator last)
	赋值迭代器范围
constexpr basic_string &	assign (std::initializer_list< value_type > ilist)
	赋值初始化列表
constexpr basic_string &	assign (const view_type &view)
	赋值字符串视图
constexpr iterator	erase (iterator position) noexcept
	删除指定位置的字符
constexpr basic_string &	erase (size_type position=0, size_type n=npos) noexcept
	删除指定范围内的字符
constexpr iterator	erase (iterator first, const size_type n) noexcept
	删除指定数量的字符
constexpr iterator	erase (iterator first, iterator last) noexcept
	删除迭代器范围
constexpr void	resize (size_type n, value_type value)
	调整大小
constexpr void	resize (const size_type n)
	调整大小（默认填充0）
constexpr void	clear () noexcept
	清空字符串
constexpr void	shrink_to_fit ()
	收缩容量以适应当前大小
constexpr basic_string	repeat (size_type n) const noexcept
	重复当前字符串n次
constexpr basic_string	substr (const size_type off=0, const size_type count=npos) const
	获取子串
constexpr basic_string	head (const size_type count=npos) const
	获取头部子串
constexpr basic_string	tail (const size_type off=0) const
	获取尾部子串
constexpr view_type	view () const noexcept
	获取字符串视图
constexpr view_type	view (const size_type off, size_type count=npos) const noexcept
	获取子串视图
constexpr size_type	copy (pointer dest, const size_type count, size_type position=0) const
	复制字符到目标缓冲区
constexpr int	compare (const basic_string &other) const noexcept
	比较另一个字符串
constexpr int	compare (const size_type off, const size_type n, const basic_string &other) const
	比较子串与另一个字符串
constexpr int	compare (const size_type off, const size_type n, const basic_string &other, const size_type roff, const size_type count) const
	比较子串与另一个字符串的子串
constexpr int	compare (const CharT *str) const noexcept
	比较C风格字符串
constexpr int	compare (const view_type &view) const noexcept
	比较字符串视图
constexpr int	compare (const size_type off, const size_type n, const CharT *str) const
	比较子串与C风格字符串
constexpr int	compare (const size_type off, const size_type n, const CharT *str, size_type count) const
	比较子串与指定长度的字符数组
constexpr int	compare_ignore_case (const view_type view) const noexcept
	忽略大小写三路比较
constexpr int	compare_ignore_case (const_pointer str) const noexcept
	忽略大小写比较另一个字符串
constexpr int	compare_ignore_case (const basic_string &str) const noexcept
	忽略大小写与C风格字符串三路比较
constexpr basic_string &	replace (const size_type position, const size_type n, const basic_string &other)
	替换子串为另一个字符串
constexpr basic_string &	replace (iterator first, iterator last, const basic_string &other)
	替换迭代器范围为另一个字符串
constexpr basic_string &	replace (const size_type position, const size_type n, const_pointer str)
	替换子串为C风格字符串
constexpr basic_string &	replace (iterator first, iterator last, const_pointer str)
	替换迭代器范围为C风格字符串
constexpr basic_string &	replace (const size_type position, const size_type n1, const_pointer str, const size_type n2)
	替换子串为指定长度的字符数组
constexpr basic_string &	replace (iterator first, iterator last, const_pointer str, const size_type n)
	替换迭代器范围为指定长度的字符数组
constexpr basic_string &	replace (const size_type position, const size_type n1, const size_type n2, const value_type value)
	替换子串为多个相同字符
constexpr basic_string &	replace (iterator first, iterator last, const size_type n, const value_type value)
	替换迭代器范围为多个相同字符
constexpr basic_string &	replace (const size_type position1, const size_type n1, const basic_string &str, const size_type position2, const size_type n2=npos)
	替换子串为另一个字符串的子串
template<typename Iterator>
constexpr basic_string &	replace (iterator first, iterator last, Iterator first2, Iterator last2)
	替换迭代器范围为另一个迭代器范围
constexpr void	reverse () noexcept
	反转字符串
constexpr size_type	find (const basic_string &other, const size_type n=0) const noexcept
	查找子串
constexpr size_type	find (const CharT value, const size_type n=0) const noexcept
	查找字符
constexpr size_type	find (const CharT *str, const size_type off, const size_type count) const noexcept
	查找指定长度的子串
constexpr size_type	find (const CharT *str, const size_type off=0) const noexcept
	查找C风格字符串
constexpr size_type	find (const view_type &view, const size_type off, const size_type count) const noexcept
	查找指定长度的字符串视图
constexpr size_type	find (const view_type &view, const size_type off=0) const noexcept
	查找字符串视图
constexpr size_type	rfind (const basic_string &other, const size_type off=npos) const noexcept
	从后向前查找子串
constexpr size_type	rfind (const CharT value, const size_type n=npos) const noexcept
	从后向前查找字符
constexpr size_type	rfind (const CharT *str, const size_type off, const size_type n) const noexcept
	从后向前查找指定长度的子串
constexpr size_type	rfind (const CharT *str, const size_type off=npos) const noexcept
	从后向前查找C风格字符串
constexpr size_type	rfind (const view_type &view, const size_type off, const size_type count) const noexcept
	从后向前查找指定长度的字符串视图
constexpr size_type	rfind (const view_type &view, const size_type off=npos) const noexcept
	从后向前查找字符串视图
constexpr size_type	find_first_of (const basic_string &other, const size_type off=0) const noexcept
	查找第一个出现在字符集合中的字符
constexpr size_type	find_first_of (const CharT value, const size_type off=0) const noexcept
	查找第一个等于指定字符的位置
constexpr size_type	find_first_of (const CharT *str, const size_type off, const size_type n) const noexcept
	查找第一个出现在指定字符数组中的字符
constexpr size_type	find_first_of (const CharT *str, const size_type off=0) const noexcept
	查找第一个出现在C风格字符串中的字符
constexpr size_type	find_first_of (const view_type &view, const size_type off, const size_type n) const noexcept
	查找第一个出现在字符串视图中的字符
constexpr size_type	find_first_of (const view_type &view, const size_type off=0) const noexcept
	查找第一个出现在字符串视图中的字符
constexpr size_type	find_last_of (const basic_string &other, const size_type off=npos) const noexcept
	查找最后一个出现在字符集合中的字符
constexpr size_type	find_last_of (const CharT value, const size_type off=npos) const noexcept
	查找最后一个等于指定字符的位置
constexpr size_type	find_last_of (const CharT *str, const size_type off, const size_type n) const noexcept
	查找最后一个出现在指定字符数组中的字符
constexpr size_type	find_last_of (const CharT *str, const size_type off=npos) const noexcept
	查找最后一个出现在C风格字符串中的字符
constexpr size_type	find_last_of (const view_type &view, const size_type off, const size_type n) const noexcept
	查找最后一个出现在字符串视图中的字符
constexpr size_type	find_last_of (const view_type &view, const size_type off=npos) const noexcept
	查找最后一个出现在字符串视图中的字符
constexpr size_type	find_first_not_of (const basic_string &other, const size_type off=0) const noexcept
	查找第一个不在字符集合中的字符
constexpr size_type	find_first_not_of (const CharT value, const size_type off=0) const noexcept
	查找第一个不等于指定字符的位置
constexpr size_type	find_first_not_of (const CharT *str, const size_type off, const size_type n) const noexcept
	查找第一个不在指定字符数组中的字符
constexpr size_type	find_first_not_of (const CharT *str, const size_type off=0) const noexcept
	查找第一个不在C风格字符串中的字符
constexpr size_type	find_first_not_of (const view_type &view, const size_type off, const size_type n) const noexcept
	查找第一个不在字符串视图中的字符
constexpr size_type	find_first_not_of (const view_type &view, const size_type off=0) const noexcept
	查找第一个不在字符串视图中的字符
constexpr size_type	find_last_not_of (const basic_string &other, const size_type off=npos) const noexcept
	查找最后一个不在字符集合中的字符
constexpr size_type	find_last_not_of (const CharT value, const size_type off=npos) const noexcept
	查找最后一个不等于指定字符的位置
constexpr size_type	find_last_not_of (const CharT *str, const size_type off, const size_type n) const noexcept
	查找最后一个不在指定字符数组中的字符
constexpr size_type	find_last_not_of (const CharT *str, const size_type off=npos) const noexcept
	查找最后一个不在C风格字符串中的字符
constexpr size_type	find_last_not_of (const view_type &view, const size_type off, const size_type n) const noexcept
	查找最后一个不在字符串视图中的字符
constexpr size_type	find_last_not_of (const view_type &view, const size_type off=npos) const noexcept
	查找最后一个不在字符串视图中的字符
constexpr size_type	count (value_type value, const size_type position=0) const noexcept
	统计指定字符出现的次数
constexpr bool	starts_with (const basic_string &other) const noexcept
	检查是否以另一个字符串开头
constexpr bool	starts_with (view_type view) const noexcept
	检查是否以字符串视图开头
constexpr bool	starts_with (const value_type value) const noexcept
	检查是否以指定字符开头
constexpr bool	starts_with (const_pointer str) const noexcept
	检查是否以C风格字符串开头
constexpr bool	ends_with (const basic_string &other) const noexcept
	检查是否以另一个字符串结尾
constexpr bool	ends_with (view_type view) const noexcept
	检查是否以字符串视图结尾
constexpr bool	ends_with (value_type value) const noexcept
	检查是否以指定字符结尾
constexpr bool	ends_with (const_pointer str) const noexcept
	检查是否以C风格字符串结尾
constexpr bool	contains (const basic_string &other) const noexcept
	检查是否包含另一个字符串
constexpr bool	contains (view_type view) const noexcept
	检查是否包含字符串视图
constexpr bool	contains (value_type value) const noexcept
	检查是否包含指定字符
constexpr bool	contains (const_pointer str) const noexcept
	检查是否包含C风格字符串
constexpr basic_string &	trim_left () noexcept
	去除左侧空白字符
constexpr basic_string &	trim_right () noexcept
	去除右侧空白字符
constexpr basic_string &	trim () noexcept
	去除两侧空白字符
template<typename Pred>
constexpr basic_string &	trim_left_if (Pred pred)
	根据谓词去除左侧字符
template<typename Pred>
constexpr basic_string &	trim_right_if (Pred pred)
	根据谓词去除右侧字符
template<typename Predicate>
constexpr basic_string &	trim_if (Predicate pred)
	根据谓词去除两侧字符
constexpr bool	equal_to (const basic_string &other) const noexcept
	相等比较
constexpr bool	equal_to (const view_type view) const noexcept
	与字符串视图相等比较
constexpr bool	equal_to (const CharT *str) const noexcept
	与C风格字符串相等比较
constexpr basic_string &	lowercase () noexcept(noexcept(_NEFORCE transform(begin(), end(), begin(), _NEFORCE to_lowercase< CharT >)))
	转换为小写
constexpr basic_string &	uppercase () noexcept(noexcept(_NEFORCE transform(begin(), end(), begin(), _NEFORCE to_uppercase< CharT >)))
	转换为大写
constexpr void	swap (basic_string &other) noexcept
	交换两个字符串
constexpr bool	less_than (const basic_string &rhs) const noexcept
	小于比较操作符
constexpr size_t	to_hash () const noexcept
	计算哈希值
Public 成员函数 继承自 icomparable< T >
constexpr bool	operator== (const T &rhs) const noexcept(noexcept(derived().equal_to(rhs)))
	相等比较运算符
constexpr bool	operator!= (const T &rhs) const noexcept(noexcept(!(derived().equal_to(rhs))))
	不等比较运算符
constexpr bool	operator< (const T &rhs) const noexcept(noexcept(derived().less_than(rhs)))
	小于比较运算符
constexpr bool	operator> (const T &rhs) const noexcept(noexcept(rhs.less_than(derived())))
	大于比较运算符
constexpr bool	operator<= (const T &rhs) const noexcept(noexcept(!(rhs.less_than(derived()))))
	小于等于比较运算符
constexpr bool	operator>= (const T &rhs) const noexcept(noexcept(!(derived().less_than(rhs))))
	大于等于比较运算符
Public 成员函数 继承自 ihashable< T >
constexpr size_t	to_ihash () const noexcept(noexcept(derived().to_hash()))
	获取对象的哈希值

静态 Public 属性
static constexpr size_type	npos = string_view::npos
	特殊值，表示未找到或"直到末尾"

详细描述

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>
class basic_string< CharT, Traits, Alloc >

基础字符串模板

模板参数

CharT	字符类型
Traits	字符特征类型，默认为char_traits<CharT>
Alloc	分配器类型，默认为allocator<CharT>

basic_string是一个动态字符序列容器，针对字符串操作进行了优化。 支持小字符串优化（SSO）减少动态分配。

在文件 basic_string.hpp 第 173 行定义.

构造及析构函数说明

basic_string() [1/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( )

inlineconstexpr

默认构造函数

构造一个空字符串。

在文件 basic_string.hpp 第 742 行定义.

被这些函数引用 basic_string< char >::substr().

basic_string() [2/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( size_type n )

inlineexplicitconstexpr

构造函数，指定大小

参数

n

字符数

在文件 basic_string.hpp 第 755 行定义.

basic_string() [3/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( size_type n, int32_t value )

inlineexplicitconstexpr

构造函数，指定大小和32位整数值

参数

n	字符数
value	整数值

在文件 basic_string.hpp 第 763 行定义.

basic_string() [4/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( size_type n, int64_t value )

inlineexplicitconstexpr

构造函数，指定大小和64位整数值

参数

n	字符数
value	整数值

在文件 basic_string.hpp 第 771 行定义.

basic_string() [5/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( size_type n, value_type value )

inlineexplicitconstexpr

构造函数，指定大小和填充字符

参数

n	字符数
value	填充字符

在文件 basic_string.hpp 第 779 行定义.

basic_string() [6/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( const basic_string< CharT, Traits, Alloc > & other )

inlineconstexpr

拷贝构造函数

参数

other

源字符串

在文件 basic_string.hpp 第 809 行定义.

basic_string() [7/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( basic_string< CharT, Traits, Alloc > && other )

inlineconstexprnoexcept

移动构造函数

参数

other

源字符串

在文件 basic_string.hpp 第 882 行定义.

basic_string() [8/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( view_type view )

inlineconstexpr

从字符串视图构造

参数

view

字符串视图

在文件 basic_string.hpp 第 962 行定义.

basic_string() [9/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( view_type view, const size_type n )

inlineconstexpr

从字符串视图构造（指定长度）

参数

view	字符串视图
n	字符数

在文件 basic_string.hpp 第 969 行定义.

basic_string() [10/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( const basic_string< CharT, Traits, Alloc > & other, size_type position )

inlineconstexpr

从子串构造

参数

other	源字符串
position	起始位置

在文件 basic_string.hpp 第 1027 行定义.

basic_string() [11/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( const basic_string< CharT, Traits, Alloc > & other, size_type position, size_type n )

inlineconstexpr

从子串构造（指定长度）

参数

other	源字符串
position	起始位置
n	字符数

在文件 basic_string.hpp 第 1038 行定义.

basic_string() [12/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( const_pointer str )

inlineconstexpr

从C风格字符串构造

参数

str

C风格字符串

在文件 basic_string.hpp 第 1048 行定义.

basic_string() [13/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( const_pointer str, const size_type n )

inlineconstexpr

从字符数组构造（指定长度）

参数

str	字符指针
n	字符数

在文件 basic_string.hpp 第 1055 行定义.

basic_string() [14/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

template<typename Iterator, enable_if_t<!is_convertible_v< Iterator, value_type >, int > = 0>

basic_string< CharT, Traits, Alloc >::basic_string ( Iterator first, Iterator last )

inlineconstexpr

从迭代器范围构造

模板参数

Iterator

迭代器类型

参数

first	起始迭代器
last	结束迭代器

在文件 basic_string.hpp 第 1113 行定义.

basic_string() [15/15]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string< CharT, Traits, Alloc >::basic_string ( std::initializer_list< value_type > ilist )

inlineconstexpr

从初始化列表构造

参数

ilist

初始化列表

在文件 basic_string.hpp 第 1121 行定义.

成员函数说明

append() [1/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( basic_string< CharT, Traits, Alloc > && other )

inlineconstexpr

追加移动字符串

参数

other

源字符串

返回

自身引用

在文件 basic_string.hpp 第 1663 行定义.

append() [2/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( basic_string< CharT, Traits, Alloc > && other, size_type position )

inlineconstexpr

追加移动字符串的子串

参数

other	源字符串
position	起始位置

返回

自身引用

在文件 basic_string.hpp 第 1674 行定义.

append() [3/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( basic_string< CharT, Traits, Alloc > && other, size_type position, size_type n )

inlineconstexpr

追加移动字符串的子串

参数

other	源字符串
position	起始位置
n	字符数

返回

自身引用

在文件 basic_string.hpp 第 1647 行定义.

append() [4/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( const basic_string< CharT, Traits, Alloc > & other )

inlineconstexpr

追加另一个字符串

参数

other

源字符串

返回

自身引用

在文件 basic_string.hpp 第 1628 行定义.

被这些函数引用 basic_string< char >::append().

append() [5/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( const basic_string< CharT, Traits, Alloc > & other, size_type position )

inlineconstexpr

追加另一个字符串的子串

参数

other	源字符串
position	起始位置

返回

自身引用

在文件 basic_string.hpp 第 1636 行定义.

append() [6/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( const basic_string< CharT, Traits, Alloc > & other, size_type position, size_type n )

inlineconstexpr

追加另一个字符串的子串

参数

other	源字符串
position	起始位置
n	字符数

返回

自身引用

在文件 basic_string.hpp 第 1614 行定义.

append() [7/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( const_pointer str )

inlineconstexpr

追加C风格字符串

参数

str

C风格字符串

返回

自身引用

在文件 basic_string.hpp 第 1742 行定义.

被这些函数引用 basic_string< char >::append().

append() [8/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( const_pointer str, size_type n )

inlineconstexpr

追加字符数组的指定长度

参数

str	字符指针
n	字符数

返回

自身引用

在文件 basic_string.hpp 第 1700 行定义.

append() [9/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

template<typename Iterator, enable_if_t< is_iter_v< Iterator >, int > = 0>

basic_string & basic_string< CharT, Traits, Alloc >::append ( Iterator first, Iterator last )

inlineconstexpr

追加迭代器范围

模板参数

Iterator

迭代器类型

参数

first	源起始
last	源结束

返回

自身引用

在文件 basic_string.hpp 第 1752 行定义.

append() [10/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( size_type n, value_type value )

inlineconstexpr

追加多个相同字符

参数

n	字符数量
value	要追加的字符

返回

自身引用

在文件 basic_string.hpp 第 1560 行定义.

被这些函数引用 basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::assign(), basic_string< char >::assign(), basic_string< char >::assign(), basic_string< char >::operator+=(), basic_string< char >::operator+=(), basic_string< char >::operator+=(), basic_string< char >::operator+=(), basic_string< char >::operator+=(), basic_string< char >::operator+=(), basic_string< char >::push_back(), basic_string< char >::resize() , 以及 basic_string< char >::shrink_to_fit().

append() [11/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( std::initializer_list< value_type > ilist )

inlineconstexpr

追加初始化列表

参数

ilist

初始化列表

返回

自身引用

在文件 basic_string.hpp 第 1804 行定义.

append() [12/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( value_type value )

inlineconstexpr

追加单个字符

参数

value

要追加的字符

返回

自身引用

在文件 basic_string.hpp 第 1605 行定义.

被这些函数引用 basic_string< char >::append().

append() [13/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( view_type view )

inlineconstexpr

追加字符串视图

参数

view

字符串视图

返回

自身引用

在文件 basic_string.hpp 第 1692 行定义.

被这些函数引用 basic_string< char >::append().

append() [14/14]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::append ( view_type view, size_type n )

inlineconstexpr

追加字符串视图的指定长度

参数

view	字符串视图
n	字符数

返回

自身引用

在文件 basic_string.hpp 第 1685 行定义.

被这些函数引用 basic_string< char >::append().

assign() [1/8]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::assign ( basic_string< CharT, Traits, Alloc > && other )

inlineconstexpr

赋值移动字符串

参数

other

源字符串

返回

自身引用

在文件 basic_string.hpp 第 1842 行定义.

assign() [2/8]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::assign ( const basic_string< CharT, Traits, Alloc > & other )

inlineconstexpr

赋值另一个字符串

参数

other

源字符串

返回

自身引用

在文件 basic_string.hpp 第 1835 行定义.

assign() [3/8]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::assign ( const size_type n, value_type value )

inlineconstexpr

赋值多个相同字符

参数

n	字符数
value	填充字符

返回

自身引用

在文件 basic_string.hpp 第 1868 行定义.

assign() [4/8]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::assign ( const view_type & view )

inlineconstexpr

赋值字符串视图

参数

view

字符串视图

返回

自身引用

在文件 basic_string.hpp 第 1898 行定义.

assign() [5/8]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::assign ( const_pointer str )

inlineconstexpr

赋值C风格字符串

参数

str

C风格字符串

返回

自身引用

在文件 basic_string.hpp 第 1849 行定义.

assign() [6/8]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::assign ( const_pointer str, const size_type n )

inlineconstexpr

赋值字符数组的指定长度

参数

str	字符指针
n	字符数

返回

自身引用

在文件 basic_string.hpp 第 1857 行定义.

assign() [7/8]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

template<typename Iterator>

basic_string & basic_string< CharT, Traits, Alloc >::assign ( Iterator first, Iterator last )

inlineconstexpr

赋值迭代器范围

模板参数

Iterator

迭代器类型

参数

first	源起始
last	源结束

返回

自身引用

在文件 basic_string.hpp 第 1881 行定义.

assign() [8/8]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::assign ( std::initializer_list< value_type > ilist )

inlineconstexpr

赋值初始化列表

参数

ilist

初始化列表

返回

自身引用

在文件 basic_string.hpp 第 1891 行定义.

at() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_reference basic_string< CharT, Traits, Alloc >::at ( const size_type n ) const

inlinenodiscardconstexprnoexcept

带边界检查的常量访问

参数

n

索引

返回

指定位置的字符常量引用

在文件 basic_string.hpp 第 1323 行定义.

at() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

reference basic_string< CharT, Traits, Alloc >::at ( const size_type n )

inlinenodiscardconstexprnoexcept

带边界检查的访问

参数

n

索引

返回

指定位置的字符引用

在文件 basic_string.hpp 第 1316 行定义.

back() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_reference basic_string< CharT, Traits, Alloc >::back ( ) const

inlinenodiscardconstexprnoexcept

常量访问最后一个字符

返回

最后一个字符的常量引用

在文件 basic_string.hpp 第 1356 行定义.

back() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

reference basic_string< CharT, Traits, Alloc >::back ( )

inlinenodiscardconstexprnoexcept

访问最后一个字符

返回

最后一个字符的引用

在文件 basic_string.hpp 第 1347 行定义.

被这些函数引用 basic_string< char >::ends_with().

begin() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_iterator basic_string< CharT, Traits, Alloc >::begin ( ) const

inlinenodiscardconstexprnoexcept

获取常量起始迭代器

返回

指向第一个字符的常量迭代器

在文件 basic_string.hpp 第 1156 行定义.

begin() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

iterator basic_string< CharT, Traits, Alloc >::begin ( )

inlinenodiscardconstexprnoexcept

获取起始迭代器

返回

指向第一个字符的迭代器

在文件 basic_string.hpp 第 1144 行定义.

被这些函数引用 basic_string< char >::erase(), basic_string< char >::erase(), basic_string< char >::erase(), basic_string< char >::insert(), basic_string< char >::insert(), basic_string< char >::insert(), basic_string< char >::lowercase(), basic_string< char >::operator=(), basic_string< char >::rend(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::resize(), basic_string< char >::reverse(), basic_string< char >::trim_left_if() , 以及 basic_string< char >::uppercase().

capacity()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

size_type basic_string< CharT, Traits, Alloc >::capacity ( ) const

inlinenodiscardconstexprnoexcept

获取容量

返回

当前分配的存储可容纳的字符数

在文件 basic_string.hpp 第 1238 行定义.

被这些函数引用 basic_string< char >::reserve().

cbegin()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_iterator basic_string< CharT, Traits, Alloc >::cbegin ( ) const

inlinenodiscardconstexprnoexcept

获取常量起始迭代器

返回

指向第一个字符的常量迭代器

在文件 basic_string.hpp 第 1168 行定义.

被这些函数引用 basic_string< char >::begin() , 以及 basic_string< char >::crend().

cend()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_iterator basic_string< CharT, Traits, Alloc >::cend ( ) const

inlinenodiscardconstexprnoexcept

获取常量结束迭代器

返回

指向最后一个字符之后位置的常量迭代器

在文件 basic_string.hpp 第 1174 行定义.

被这些函数引用 basic_string< char >::crbegin() , 以及 basic_string< char >::end().

compare() [1/7]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare ( const basic_string< CharT, Traits, Alloc > & other ) const

inlinenodiscardconstexprnoexcept

比较另一个字符串

参数

other

另一个字符串

返回

比较结果

在文件 basic_string.hpp 第 2165 行定义.

被这些函数引用 basic_string< char >::compare(), basic_string< char >::compare() , 以及 basic_string< char >::less_than().

compare() [2/7]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare ( const CharT * str ) const

inlinenodiscardconstexprnoexcept

比较C风格字符串

参数

str

C风格字符串

返回

比较结果

在文件 basic_string.hpp 第 2200 行定义.

compare() [3/7]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare ( const size_type off, const size_type n, const basic_string< CharT, Traits, Alloc > & other ) const

inlinenodiscardconstexpr

比较子串与另一个字符串

参数

off	起始偏移
n	长度
other	另一个字符串

返回

比较结果

在文件 basic_string.hpp 第 2176 行定义.

compare() [4/7]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare ( const size_type off, const size_type n, const basic_string< CharT, Traits, Alloc > & other, const size_type roff, const size_type count ) const

inlinenodiscardconstexpr

比较子串与另一个字符串的子串

参数

off	起始偏移
n	长度
other	另一个字符串
roff	目标起始偏移
count	目标长度

返回

比较结果

在文件 basic_string.hpp 第 2190 行定义.

compare() [5/7]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare ( const size_type off, const size_type n, const CharT * str ) const

inlinenodiscardconstexpr

比较子串与C风格字符串

参数

off	起始偏移
n	长度
str	C风格字符串

返回

比较结果

在文件 basic_string.hpp 第 2220 行定义.

compare() [6/7]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare ( const size_type off, const size_type n, const CharT * str, size_type count ) const

inlinenodiscardconstexpr

比较子串与指定长度的字符数组

参数

off	起始偏移
n	长度
str	字符指针
count	字符数组长度

返回

比较结果

在文件 basic_string.hpp 第 2232 行定义.

compare() [7/7]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare ( const view_type & view ) const

inlinenodiscardconstexprnoexcept

比较字符串视图

参数

view

字符串视图

返回

比较结果

在文件 basic_string.hpp 第 2209 行定义.

compare_ignore_case() [1/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare_ignore_case ( const basic_string< CharT, Traits, Alloc > & str ) const

inlinenodiscardconstexprnoexcept

忽略大小写与C风格字符串三路比较

参数

str

C风格字符串

返回

比较结果

在文件 basic_string.hpp 第 2274 行定义.

compare_ignore_case() [2/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare_ignore_case ( const view_type view ) const

inlinenodiscardconstexprnoexcept

忽略大小写三路比较

参数

view

要比较的视图

返回

负值（*this < view）、0（相等）、正值（*this > view）

在文件 basic_string.hpp 第 2242 行定义.

被这些函数引用 basic_string< char >::compare_ignore_case() , 以及 basic_string< char >::compare_ignore_case().

compare_ignore_case() [3/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

int basic_string< CharT, Traits, Alloc >::compare_ignore_case ( const_pointer str ) const

inlinenodiscardconstexprnoexcept

忽略大小写比较另一个字符串

参数

str

字符串

返回

比较结果

在文件 basic_string.hpp 第 2265 行定义.

copy()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

size_type basic_string< CharT, Traits, Alloc >::copy ( pointer dest, const size_type count, size_type position = 0 ) const

inlineconstexpr

复制字符到目标缓冲区

参数

dest	目标缓冲区
count	要复制的字符数
position	起始位置

返回

实际复制的字符数

在文件 basic_string.hpp 第 2153 行定义.

count()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

size_type basic_string< CharT, Traits, Alloc >::count ( value_type value, const size_type position = 0 ) const

inlinenodiscardconstexprnoexcept

统计指定字符出现的次数

参数

value	要统计的字符
position	起始位置

返回

字符出现的次数

在文件 basic_string.hpp 第 2580 行定义.

crbegin()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_reverse_iterator basic_string< CharT, Traits, Alloc >::crbegin ( ) const

inlinenodiscardconstexprnoexcept

获取常量反向起始迭代器

返回

指向最后一个字符的常量反向迭代器

在文件 basic_string.hpp 第 1204 行定义.

被这些函数引用 basic_string< char >::rbegin().

crend()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_reverse_iterator basic_string< CharT, Traits, Alloc >::crend ( ) const

inlinenodiscardconstexprnoexcept

获取常量反向结束迭代器

返回

指向第一个字符之前位置的常量反向迭代器

在文件 basic_string.hpp 第 1212 行定义.

被这些函数引用 basic_string< char >::rend().

data() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_pointer basic_string< CharT, Traits, Alloc >::data ( ) const

inlinenodiscardconstexprnoexcept

获取常量数据指针

返回

指向底层字符数组的常量指针

在文件 basic_string.hpp 第 1380 行定义.

data() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

pointer basic_string< CharT, Traits, Alloc >::data ( )

inlinenodiscardconstexprnoexcept

获取数据指针

返回

指向底层字符数组的指针

在文件 basic_string.hpp 第 1365 行定义.

被这些函数引用 basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::back(), basic_string< char >::back(), basic_string< char >::basic_string(), basic_string< char >::basic_string(), basic_string< char >::basic_string(), basic_string< char >::begin(), basic_string< char >::cbegin(), basic_string< char >::cend(), basic_string< char >::compare(), basic_string< char >::compare_ignore_case(), basic_string< char >::copy(), basic_string< char >::count(), basic_string< char >::end(), basic_string< char >::ends_with(), basic_string< char >::ends_with(), basic_string< char >::equal_to(), basic_string< char >::erase(), basic_string< char >::erase(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::front(), basic_string< char >::front(), basic_string< char >::operator=(), basic_string< char >::operator[](), basic_string< char >::operator[](), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::starts_with(), basic_string< char >::starts_with(), basic_string< char >::substr(), basic_string< char >::to_hash(), basic_string< char >::view(), basic_string< char >::view(), XOR_decrypt() , 以及 XOR_encrypt().

empty()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

bool basic_string< CharT, Traits, Alloc >::empty ( ) const

inlinenodiscardconstexprnoexcept

检查是否为空

返回

是否为空

在文件 basic_string.hpp 第 1256 行定义.

被这些函数引用 basic_string< char >::back(), basic_string< char >::back(), basic_string< char >::ends_with(), basic_string< char >::front(), basic_string< char >::front(), basic_string< char >::pop_back(), basic_string< char >::starts_with(), basic_string< char >::trim_left_if() , 以及 basic_string< char >::trim_right_if().

end() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_iterator basic_string< CharT, Traits, Alloc >::end ( ) const

inlinenodiscardconstexprnoexcept

获取常量结束迭代器

返回

指向最后一个字符之后位置的常量迭代器

在文件 basic_string.hpp 第 1162 行定义.

end() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

iterator basic_string< CharT, Traits, Alloc >::end ( )

inlinenodiscardconstexprnoexcept

获取结束迭代器

返回

指向最后一个字符之后位置的迭代器

在文件 basic_string.hpp 第 1150 行定义.

被这些函数引用 basic_string< char >::erase(), basic_string< char >::erase(), basic_string< char >::erase(), basic_string< char >::lowercase(), basic_string< char >::rbegin(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::resize(), basic_string< char >::reverse(), basic_string< char >::trim_left_if(), basic_string< char >::trim_right_if() , 以及 basic_string< char >::uppercase().

equal_to() [1/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

bool basic_string< CharT, Traits, Alloc >::equal_to ( const basic_string< CharT, Traits, Alloc > & other ) const

inlinenodiscardconstexprnoexcept

相等比较

参数

other

另一个字符串

返回

是否相等

在文件 basic_string.hpp 第 2732 行定义.

被这些函数引用 basic_string< char >::equal_to() , 以及 basic_string< char >::equal_to().

equal_to() [2/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

bool basic_string< CharT, Traits, Alloc >::equal_to ( const CharT * str ) const

inlinenodiscardconstexprnoexcept

与C风格字符串相等比较

参数

str

C风格字符串

返回

是否相等

在文件 basic_string.hpp 第 2750 行定义.

equal_to() [3/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

bool basic_string< CharT, Traits, Alloc >::equal_to ( const view_type view ) const

inlinenodiscardconstexprnoexcept

与字符串视图相等比较

参数

view

字符串视图

返回

是否相等

在文件 basic_string.hpp 第 2741 行定义.

erase() [1/4]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

iterator basic_string< CharT, Traits, Alloc >::erase ( iterator first, const size_type n )

inlineconstexprnoexcept

删除指定数量的字符

参数

first	起始位置
n	字符数

返回

指向被删除区域之后位置的迭代器

在文件 basic_string.hpp 第 1956 行定义.

erase() [2/4]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

iterator basic_string< CharT, Traits, Alloc >::erase ( iterator first, iterator last )

inlineconstexprnoexcept

删除迭代器范围

参数

first	起始位置
last	结束位置

返回

指向被删除区域之后位置的迭代器

在文件 basic_string.hpp 第 1970 行定义.

erase() [3/4]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

iterator basic_string< CharT, Traits, Alloc >::erase ( iterator position )

inlineconstexprnoexcept

删除指定位置的字符

参数

position

要删除的位置

返回

指向被删除字符之后位置的迭代器

在文件 basic_string.hpp 第 1905 行定义.

被这些函数引用 basic_string< char >::erase(), basic_string< char >::erase(), basic_string< char >::resize(), basic_string< char >::trim_left_if() , 以及 basic_string< char >::trim_right_if().

erase() [4/4]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::erase ( size_type position = 0, size_type n = npos )

inlineconstexprnoexcept

删除指定范围内的字符

参数

position	起始位置
n	字符数

返回

自身引用

在文件 basic_string.hpp 第 1941 行定义.

front() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_reference basic_string< CharT, Traits, Alloc >::front ( ) const

inlinenodiscardconstexprnoexcept

常量访问第一个字符

返回

第一个字符的常量引用

在文件 basic_string.hpp 第 1338 行定义.

front() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

reference basic_string< CharT, Traits, Alloc >::front ( )

inlinenodiscardconstexprnoexcept

访问第一个字符

返回

第一个字符的引用

在文件 basic_string.hpp 第 1329 行定义.

被这些函数引用 basic_string< char >::starts_with().

head()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string basic_string< CharT, Traits, Alloc >::head ( const size_type count = npos ) const

inlinenodiscardconstexpr

获取头部子串

参数

count

长度

返回

子串

在文件 basic_string.hpp 第 2117 行定义.

insert() [1/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

template<typename Iterator>

iterator basic_string< CharT, Traits, Alloc >::insert ( iterator position, Iterator first, Iterator last )

inlineconstexpr

插入迭代器范围

模板参数

Iterator

迭代器类型

参数

position	插入位置
first	源起始
last	源结束

返回

指向插入起始的迭代器

在文件 basic_string.hpp 第 1486 行定义.

insert() [2/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

iterator basic_string< CharT, Traits, Alloc >::insert ( iterator position, value_type value )

inlineconstexpr

插入单个字符

参数

position	插入位置
value	要插入的字符

返回

指向插入字符的迭代器

在文件 basic_string.hpp 第 1397 行定义.

被这些函数引用 basic_string< char >::insert() , 以及 basic_string< char >::operator=().

insert() [3/3]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::insert ( size_type position, size_type n, value_type value )

inlineconstexpr

在指定位置插入多个相同字符

参数

position	插入位置
n	插入数量
value	插入字符

返回

自身引用

在文件 basic_string.hpp 第 1435 行定义.

length()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

size_type basic_string< CharT, Traits, Alloc >::length ( ) const

inlinenodiscardconstexprnoexcept

获取字符串长度

返回

字符串长度

在文件 basic_string.hpp 第 1250 行定义.

max_size()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

size_type basic_string< CharT, Traits, Alloc >::max_size ( ) const

inlinenodiscardconstexprnoexcept

获取最大可能大小

返回

最大长度

在文件 basic_string.hpp 第 1232 行定义.

被这些函数引用 basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append() , 以及 basic_string< char >::reserve().

operator=() [1/5]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::operator= ( basic_string< CharT, Traits, Alloc > && other )

inlineconstexprnoexcept

移动赋值运算符

参数

other

源字符串

返回

自身引用

在文件 basic_string.hpp 第 916 行定义.

operator=() [2/5]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::operator= ( const basic_string< CharT, Traits, Alloc > & other )

inlineconstexpr

拷贝赋值运算符

参数

other

源字符串

返回

自身引用

在文件 basic_string.hpp 第 836 行定义.

operator=() [3/5]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::operator= ( const_pointer str )

inlineconstexpr

C风格字符串赋值运算符

参数

str

C风格字符串

返回

自身引用

在文件 basic_string.hpp 第 1062 行定义.

operator=() [4/5]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::operator= ( std::initializer_list< value_type > ilist )

inlineconstexpr

初始化列表赋值运算符

参数

ilist

初始化列表

返回

自身引用

在文件 basic_string.hpp 第 1129 行定义.

operator=() [5/5]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::operator= ( view_type view )

inlineconstexpr

字符串视图赋值运算符

参数

view

字符串视图

返回

自身引用

在文件 basic_string.hpp 第 976 行定义.

operator[]() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_reference basic_string< CharT, Traits, Alloc >::operator[] ( const size_type n ) const

inlinenodiscardconstexprnoexcept

常量下标访问操作符

参数

n

索引

返回

指定位置的字符常量引用

在文件 basic_string.hpp 第 1306 行定义.

operator[]() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

reference basic_string< CharT, Traits, Alloc >::operator[] ( const size_type n )

inlinenodiscardconstexprnoexcept

下标访问操作符

参数

n

索引

返回

指定位置的字符引用

在文件 basic_string.hpp 第 1296 行定义.

push_back()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

void basic_string< CharT, Traits, Alloc >::push_back ( value_type value )

inlineconstexpr

在末尾插入字符

参数

value

要插入的字符

在文件 basic_string.hpp 第 1532 行定义.

被这些函数引用 codepoint::append_to(), getline(), getline(), bitset< N >::to_string() , 以及 wcharacter::to_u16string().

rbegin() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_reverse_iterator basic_string< CharT, Traits, Alloc >::rbegin ( ) const

inlinenodiscardconstexprnoexcept

获取常量反向起始迭代器

返回

指向最后一个字符的常量反向迭代器

在文件 basic_string.hpp 第 1192 行定义.

rbegin() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

reverse_iterator basic_string< CharT, Traits, Alloc >::rbegin ( )

inlinenodiscardconstexprnoexcept

获取反向起始迭代器

返回

指向最后一个字符的反向迭代器

在文件 basic_string.hpp 第 1180 行定义.

被这些函数引用 basic_string< char >::trim_right_if().

rend() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

const_reverse_iterator basic_string< CharT, Traits, Alloc >::rend ( ) const

inlinenodiscardconstexprnoexcept

获取常量反向结束迭代器

返回

指向第一个字符之前位置的常量反向迭代器

在文件 basic_string.hpp 第 1198 行定义.

rend() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

reverse_iterator basic_string< CharT, Traits, Alloc >::rend ( )

inlinenodiscardconstexprnoexcept

获取反向结束迭代器

返回

指向第一个字符之前位置的反向迭代器

在文件 basic_string.hpp 第 1186 行定义.

被这些函数引用 basic_string< char >::trim_right_if().

repeat()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string basic_string< CharT, Traits, Alloc >::repeat ( size_type n ) const

inlinenodiscardconstexprnoexcept

重复当前字符串n次

参数

n

重复次数

返回

新字符串

在文件 basic_string.hpp 第 2090 行定义.

reserve()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

void basic_string< CharT, Traits, Alloc >::reserve ( const size_type n )

inlineconstexpr

预留容量

参数

n

要预留的字符数

在文件 basic_string.hpp 第 1262 行定义.

被这些函数引用 address_string(), basic_string< char >::basic_string(), escape(), format(), basic_string< char >::repeat(), basic_string< char >::shrink_to_fit(), bitset< N >::to_string(), u8character::to_string(), character::to_u16string(), u16character::to_u16string(), u32character::to_u16string(), u8character::to_u16string(), wcharacter::to_u16string(), character::to_u32string(), u16character::to_u32string(), u8character::to_u32string(), wcharacter::to_u32string(), character::to_u8string(), u16character::to_u8string(), u32character::to_u8string(), character::to_wstring(), u16character::to_wstring(), u32character::to_wstring() , 以及 u8character::to_wstring().

resize() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

void basic_string< CharT, Traits, Alloc >::resize ( const size_type n )

inlineconstexpr

调整大小（默认填充0）

参数

n

新大小

在文件 basic_string.hpp 第 2024 行定义.

resize() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

void basic_string< CharT, Traits, Alloc >::resize ( size_type n, value_type value )

inlineconstexpr

调整大小

参数

n	新大小
value	填充值

在文件 basic_string.hpp 第 2012 行定义.

被这些函数引用 basic_string< char >::resize().

size()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

size_type basic_string< CharT, Traits, Alloc >::size ( ) const

inlinenodiscardconstexprnoexcept

获取字符数

返回

字符串长度

在文件 basic_string.hpp 第 1220 行定义.

被这些函数引用 basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::append(), basic_string< char >::back(), basic_string< char >::back(), basic_string< char >::basic_string(), basic_string< char >::basic_string(), basic_string< char >::basic_string(), basic_string< char >::cend(), basic_string< char >::compare(), basic_string< char >::compare_ignore_case(), basic_string< char >::copy(), basic_string< char >::count(), basic_string< char >::empty(), basic_string< char >::end(), basic_string< char >::ends_with(), basic_string< char >::ends_with(), basic_string< char >::equal_to(), basic_string< char >::erase(), basic_string< char >::erase(), basic_string< char >::erase(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_not_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_first_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_not_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::find_last_of(), basic_string< char >::insert(), basic_string< char >::insert(), basic_string< char >::length(), basic_string< char >::operator=(), basic_string< char >::operator[](), basic_string< char >::operator[](), basic_string< char >::pop_back(), basic_string< char >::repeat(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::replace(), basic_string< char >::reserve(), basic_string< char >::resize(), basic_string< char >::reverse(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::rfind(), basic_string< char >::shrink_to_fit(), basic_string< char >::starts_with(), basic_string< char >::starts_with(), basic_string< char >::substr(), basic_string< char >::to_hash(), basic_string< char >::view(), basic_string< char >::view(), XOR_decrypt() , 以及 XOR_encrypt().

substr()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string basic_string< CharT, Traits, Alloc >::substr ( const size_type off = 0, const size_type count = npos ) const

inlinenodiscardconstexpr

获取子串

参数

off	起始偏移
count	长度

返回

子串

在文件 basic_string.hpp 第 2105 行定义.

被这些函数引用 basic_string< char >::head() , 以及 basic_string< char >::tail().

swap()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

void basic_string< CharT, Traits, Alloc >::swap ( basic_string< CharT, Traits, Alloc > & other )

inlineconstexprnoexcept

交换两个字符串

参数

other

另一个字符串

在文件 basic_string.hpp 第 2776 行定义.

被这些函数引用 basic_string< char >::shrink_to_fit().

tail()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string basic_string< CharT, Traits, Alloc >::tail ( const size_type off = 0 ) const

inlinenodiscardconstexpr

获取尾部子串

参数

off

起始偏移

返回

子串

在文件 basic_string.hpp 第 2126 行定义.

trim()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::trim ( )

inlineconstexprnoexcept

去除两侧空白字符

返回

自身引用

在文件 basic_string.hpp 第 2668 行定义.

trim_if()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

template<typename Predicate>

basic_string & basic_string< CharT, Traits, Alloc >::trim_if ( Predicate pred )

inlineconstexpr

根据谓词去除两侧字符

模板参数

Predicate

谓词类型

参数

pred

谓词函数

返回

自身引用

在文件 basic_string.hpp 第 2723 行定义.

trim_left()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::trim_left ( )

inlineconstexprnoexcept

去除左侧空白字符

返回

自身引用

在文件 basic_string.hpp 第 2652 行定义.

被这些函数引用 basic_string< char >::trim().

trim_left_if()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

template<typename Pred>

basic_string & basic_string< CharT, Traits, Alloc >::trim_left_if ( Pred pred )

inlineconstexpr

根据谓词去除左侧字符

模板参数

Pred

谓词类型

参数

pred

谓词函数

返回

自身引用

在文件 basic_string.hpp 第 2677 行定义.

被这些函数引用 basic_string< char >::trim_if() , 以及 basic_string< char >::trim_left().

trim_right()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

basic_string & basic_string< CharT, Traits, Alloc >::trim_right ( )

inlineconstexprnoexcept

去除右侧空白字符

返回

自身引用

在文件 basic_string.hpp 第 2660 行定义.

被这些函数引用 basic_string< char >::trim().

trim_right_if()

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

template<typename Pred>

basic_string & basic_string< CharT, Traits, Alloc >::trim_right_if ( Pred pred )

inlineconstexpr

根据谓词去除右侧字符

模板参数

Pred

谓词类型

参数

pred

谓词函数

返回

自身引用

在文件 basic_string.hpp 第 2700 行定义.

被这些函数引用 basic_string< char >::trim_if() , 以及 basic_string< char >::trim_right().

view() [1/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

view_type basic_string< CharT, Traits, Alloc >::view ( ) const

inlinenodiscardconstexprnoexcept

获取字符串视图

返回

字符串视图

在文件 basic_string.hpp 第 2132 行定义.

被这些函数引用 color::color(), basic_string< char >::compare(), basic_string< char >::compare(), basic_string< char >::compare(), basic_string< char >::compare(), escape(), boolean::parse(), to_string(), to_u16string(), to_u32string(), to_u8string() , 以及 to_wstring().

view() [2/2]

template<typename CharT, typename Traits = char_traits<CharT>, typename Alloc = allocator<CharT>>

view_type basic_string< CharT, Traits, Alloc >::view ( const size_type off, size_type count = npos ) const

inlinenodiscardconstexprnoexcept

获取子串视图

参数

off	起始偏移
count	长度

返回

字符串视图

在文件 basic_string.hpp 第 2140 行定义.

---

该类的文档由以下文件生成:

• basic_string.hpp