C++

参考

<string>

basic_string

类模板
<string>

std::basic_string

template < class charT,           class traits = char_traits<charT>,    // basic_string::traits_type           class Alloc = allocator<charT>        // basic_string::allocator_type           > class basic_string;
通用字符串类
要放回的字符的basic_string是 string 类对于任何字符类型的泛化（请参阅 string 以获取描述）。

模板参数

charT
字符类型。
字符串由该类型的字符序列构成。
这应是一个非数组的 POD 类型。
特性 (traits)
字符特性类，它定义了 basic_string 对象所使用的字符的基本属性（请参阅 char_traits）。
traits::char_type应与charT.
别名为成员类型basic_string::traits_type.
Alloc
用于定义存储分配模型的分配器对象类型。默认情况下，使用 allocator 类模板，它定义了最简单的内存分配模型并且与值无关。
别名为成员类型basic_string::allocator_type.

注意：由于第一个模板参数未被别名为任何成员类型，charT在本参考中被用来指代此类型。

sub_match for string literals (class)

string
字符串类 (class)
wstring
宽字符串类 (class)
u16string
16位字符字符串类 (class)
u32string
32位字符字符串类 (class)

成员类型

成员类型定义说明
traits_type第二个模板参数 (特性 (traits))默认为char_traits<charT>
allocator_type第三个模板参数 (Alloc)默认为allocator<charT>
value_typetraits_type::char_type应与charT
引用allocator_type::reference对于默认的 allocatorcharT&
const_referenceallocator_type::const_reference对于默认的 allocatorconst charT&
指针allocator_type::pointer对于默认的 allocatorcharT*
const_pointerallocator_type::const_pointer对于默认的 allocatorconst charT*
iterator一个指向charT的 随机访问迭代器，可转换为const_iterator
const_iterator一个指向const charT
reverse_iteratorreverse_iterator<iterator>
const_reverse_iteratorreverse_iterator<const_iterator>
difference_typeallocator_type::difference_type相同，通常与 ptrdiff_t 一样
size_typeallocator_type::size_type的无符号整数类型，通常与 size_t 一样
成员类型定义说明
traits_type第二个模板参数 (特性 (traits))默认为char_traits<charT>
allocator_type第三个模板参数 (Alloc)默认为allocator<charT>
value_typetraits_type::char_type应与charT
引用value_type&
const_referenceconst value_type&
指针allocator_traits<allocator_type>::pointer对于默认的 allocatorcharT*
const_pointerallocator_traits<allocator_type>::const_pointer对于默认的 allocatorconst charT*
iterator一个指向charT的 随机访问迭代器，可转换为const_iterator
const_iterator一个指向const charT
reverse_iteratorreverse_iterator<iterator>
const_reverse_iteratorreverse_iterator<const_iterator>
difference_typeallocator_traits<allocator_type>::difference_type相同，通常与 ptrdiff_t 一样
size_typeallocator_traits<allocator_type>::size_type的无符号整数类型，通常与 size_t 一样

成员函数

（构造函数）
构造 basic_string 对象 (公共成员函数)
(析构函数)
字符串析构函数 (public member function)
operator=
字符串赋值 (公共成员函数)

迭代器:
begin
返回指向起始位置的迭代器 (公开成员函数)
end
返回指向末尾的迭代器 (公开成员函数)
rbegin
返回指向反向起始位置的反向迭代器 (公开成员函数)
rend
返回指向反向末尾的反向迭代器 (公开成员函数)
cbegin
返回指向起始位置的 const_iterator (公开成员函数)
cend
返回指向末尾的 const_iterator (公开成员函数)
crbegin
返回指向反向起始位置的 const_reverse_iterator (公开成员函数)
crend
返回指向反向末尾的 const_reverse_iterator (公开成员函数)

容量:
size
返回大小 (公开成员函数)
长度
返回字符串的长度 (公共成员函数)
max_size
返回最大大小 (公开成员函数)
resize
调整字符串大小 (公共成员函数)
容量
返回分配存储的大小 (公共成员函数)
reserve
请求更改容量 (公共成员函数)
clear
清除字符串 (公共成员函数)
empty
测试字符串是否为空 (公共成员函数)
shrink_to_fit
缩小到适合 (公共成员函数)

元素访问:
operator[]
获取字符串的字符 (public member function)
at
获取字符串的字符 (public member function)
back
访问最后一个字符 (公共成员函数)
front
访问第一个字符 (public member function)

修改器:
operator+=
追加到字符串 (public member function)
append
追加到字符串 (public member function)
push_back
将字符附加到字符串 (公共成员函数)
assign
将内容分配给字符串 (public member function)
insert
插入到字符串 (public member function)
erase
从字符串中删除字符 (公共成员函数)
replace
替换字符串的一部分 (public member function)
swap
交换字符串值 (公共成员函数)
pop_back
删除最后一个字符 (public member function)

字符串操作:
c_str
获取 C 字符串等效项
data
获取字符串数据 (public member function)
get_allocator
获取分配器 (公开成员函数)
copy
从字符串复制字符序列 (public member function)
find
查找字符串中第一次出现(公共成员函数)
rfind
在字符串中查找最后一次出现 (公共成员函数)
find_first_of
在字符串中查找字符 (公共成员函数)
find_last_of
从字符串末尾查找字符 (公共成员函数)
find_first_not_of
在字符串中查找非匹配字符 (公共成员函数)
find_last_not_of
从字符串末尾查找不匹配的字符 (公共成员函数)
substr
生成子字符串 (公共成员函数)
compare
比较字符串 (公共成员函数)

非成员函数重载

`operator+`
连接字符串 (function template)
关系运算符
basic_string的关系运算符 (函数模板)
swap
交换两个字符串的值(函数模板)
operator>>
从流中提取字符串(函数模板)
operator<<
将字符串插入流 (function template)
getline
从流获取行到字符串 (函数模板)

成员常量

npos
size_type 的最大值 (public static member constant)