std::basic_string

 

C++

语言

标准库头文件

概念

实用工具库

字符串库

容器库

算法库

迭代器库

数值计算库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

字符串库

空终止字符串

字节字符串

多字节字符串

宽字符串

类

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

成员函数 basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator 元素访问 basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) 迭代器 basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) 容量 basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

操作 basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap 查找 basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of 常量 basic_string::npos

非成员函数 operator+ operator==operator!=operator<operator>operator<=operator>= swap(std::basic_string) operator<<operator>> getline stoistolstoll (C++11) (C++11) (C++11) stoulstoull (C++11) (C++11) stofstodstold (C++11) (C++11) (C++11) to_string (C++11) to_wstring (C++11) operator""s (C++14) 帮助类 hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string> (C++11) (C++11) (C++11) (C++11)

 

定义于头文件 <string>
template<     class CharT,     class Traits = std::char_traits<CharT>,     class Allocator = std::allocator<CharT> > class basic_string;	(1)
namespace pmr {     template <class CharT, class Traits = std::char_traits<CharT>>     using basic_string = std::basic_string< CharT, Traits,                                             std::polymorphic_allocator<CharT>> }	(2)	(C++17 起)

类模板basic_string存储并操作类char对象的序列。该模板既不依赖于字符类型亦不依赖于该类型上的运算本性。运算的定义由Traits模板参数——std::char_traits的一个特化或兼容的特性类提供。

basic_string的元素是连续存储的，即对于一个basic_string s，对于[0, s.size())中任意的n有&*(s.begin() + n) == &*s.begin() + n，等价地，指向s[0]的指针可以传递给期待指向CharT[]首元素的指针的函数。

(C++11 起)

std::basic_string满足具分配器容器（AllocatorAwareContainer）、顺序容器（SequenceContainer）及连续容器（ContiguousContainer） (C++17 起)的要求。

标准为常用字符类型提供数种typedef：

定义于头文件 <string>
类型	定义
std::string	std::basic_string<char>
std::wstring	std::basic_string<wchar_t>
std::u16string (C++11)	std::basic_string<char16_t>
std::u32string (C++11)	std::basic_string<char32_t>
std::pmr::string (C++17)	std::pmr::basic_string<char>
std::pmr::wstring (C++17)	std::pmr::basic_string<wchar_t>
std::pmr::u16string (C++17)	std::pmr::basic_string<char16_t>
std::pmr::u32string (C++17)	std::pmr::basic_string<char32_t>

模板参数

CharT	-	字符类型
Traits	-	指定在字符类型上操作的特性类
Allocator	-	用于分配内部存储的分配器（Allocator）类型

成员类型

成员类型	定义
traits_type	Traits
value_type	Traits::char_type
allocator_type	Allocator
size_type	无符号整型（通常是size_t）
difference_type	有符号整型 (通常是ptrdiff_t)
reference	Allocator::reference (C++11 前) value_type& (C++11 起)
const_reference	Allocator::const_reference (C++11 前) const value_type& (C++11 起)
pointer	Allocator::pointer (C++11 前) std::allocator_traits<Allocator>::pointer (C++11 起)
const_pointer	Allocator::const_pointer (C++11 前) std::allocator_traits<Allocator>::const_pointer (C++11 起)
iterator	随机访问迭代器（RandomAccessIterator）
const_iterator	随机访问常迭代器
reverse_iterator	std::reverse_iterator<iterator>
const_reverse_iterator	std::reverse_iterator<const_iterator>

成员函数

(构造函数)	构造basic_string 原文： constructs a basic_string 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
(析构函数)	销毁字符串，解除分配内部存储，若使用它 (公开成员函数)
operator=	为字符串赋值 (公开成员函数)
assign	为字符串赋值 (公开成员函数)
get_allocator	返回关联的分配器 (公开成员函数)
元素访问
at	访问指定位置的字符，带边界检查 (公开成员函数)
operator[]	访问指定位置的字符 (公开成员函数)
front (C++11)	访问的第一个字符 原文： accesses the first character 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
back (C++11)	访问的最后一个字符 原文： accesses the last character 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
data	返回一个指针，指向一个字符串的第一个字符 原文： returns a pointer to the first character of a string 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
c_str	返回一个不可修改的C风格字符串 原文： returns a non-modifiable standard C character array version of the string 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
operator basic_string_view (C++17)	返回到整个字符串的非可修改的basic_string_view (公开成员函数)
迭代器
begin cbegin (C++11)	返回指向字符串第一个元素的迭代器 原文： returns an iterator to the beginning 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
end cend (C++11)	返回指向字符串尾端的迭代器 原文： returns an iterator to the end 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
rbegin crbegin (C++11)	返回一个指向字符串最后一个元素的反向迭代器 原文： returns a reverse iterator to the beginning 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
rend crend (C++11)	返回一个指向字符串前端的反向迭代器 原文： returns a reverse iterator to the end 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
容量
empty	检查字符串是否为空 原文： checks whether the string is empty 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
size length	返回字符数量 (公开成员函数)
max_size	返回最大字符数量 原文： returns the maximum number of characters 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
reserve	预留存储空间 原文： reserves storage 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
capacity	返回当前分配的存储空间可容纳的最大字符数量 原文： returns the number of characters that can be held in currently allocated storage 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
shrink_to_fit (C++11)	通过释放未使用的内存减少内存使用 原文： reduces memory usage by freeing unused memory 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
操作
clear	删除全部内容 原文： clears the contents 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
insert	插入字符 原文： inserts characters 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
erase	删除字符 (公开成员函数)
push_back	向末尾添加字符 原文： appends a character to the end 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
pop_back (C++11)	删除最后一个字符 原文： removes the last character 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
append	向末尾添加字符（串） 原文： appends characters to the end 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
operator+=	向末尾添加字符（串） 原文： appends characters to the end 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
compare	比较两个字符串 原文： compares two strings 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
replace	替换出现的每一个指定的字符 原文： replaces every occurrence of specified characters 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
substr	返回子字符串 原文： returns a substring 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
copy	复制字符 原文： copies characters 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
resize	改变存储的字符数 原文： changes the number of characters stored 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
swap	交换字符串的内容 原文： swaps the contents 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
查找
find	在字符串中寻找字符（串） (公开成员函数)
rfind	寻找字符（串）最后一次出现的位置 原文： find the last occurrence of a substring 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
find_first_of	寻找字符串中任意字符第一次出现的位置 原文： find first occurrence of characters 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
find_first_not_of	寻找字符串中任意字符第一次缺失的位置 原文： find first absence of characters 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
find_last_of	寻找字符串中任意字符最后一次出现的位置 原文： find last occurrence of characters 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开成员函数)
find_last_not_of	寻找字符串中任意字符最后一次缺失的位置 (公开成员函数)
常量
npos [静态]	特殊值。确切的含义取决于具体情况。 原文： special value. The exact meaning depends on the context 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (公开静态成员常量)

非成员函数

operator+	连接两个字符串或者一个字符串和一个字符 (函数模板)
operator== operator!= operator< operator> operator<= operator>=	按字典顺序比较两个字符串 (函数模板)
std::swap(std::basic_string)	特化 std::swap 算法 (函数模板)
输入/输出
operator<< operator>>	执行字符串的流输入和输出 (函数模板)
getline	从I/O流读入数据到字符串 (函数模板)
数值转换
stoi stol stoll (C++11) (C++11) (C++11)	将字符串转换为有符号整数 原文： converts a string to an signed integer 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (函数)
stoul stoull (C++11) (C++11)	将字符串转换为无符号整数 原文： converts a string to an unsigned integer 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (函数)
stof stod stold (C++11) (C++11) (C++11)	将字符串转换为浮点值 原文： converts a string to an floating point value 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (函数)
to_string (C++11)	将整值或浮点值转换成string (函数)
to_wstring (C++11)	将整值或浮点值转换成wstring (函数)

字面量

定义于内联命名空间 std::literals::string_literals
operator""s (C++14)	将字符数组字面量转换成basic_string (函数)

帮助类

std::hash<std::string> std::hash<std::u16string> std::hash<std::u32string> std::hash<std::wstring> (C++11) (C++11) (C++11) (C++11)

支持字符串的哈希函数 原文： hash support for strings 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (类模板特化)