std::basic_string

来自cppreference.com
< cpp‎ | string
 
C++
 
字符串库
 
std::basic_string
 
定义于头文件 <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 的一种特化或兼容的特性类。 Traits::char_type 与 CharT 必须指名同一类型；否则行为未定义。

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 CharT
allocator_type Allocator [编辑]
size_type
Allocator::size_type (C++11 前)
std::allocator_traits<Allocator>::size_type (C++11 起)
[编辑]
difference_type
Allocator::difference_type (C++11 前)
std::allocator_traits<Allocator>::difference_type (C++11 起)
[编辑]
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
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
(析构函数)
 销毁字符串，若使用内部存储则解分配它
(公开成员函数)
为字符串赋值
(公开成员函数) [编辑]
为字符串赋值
(公开成员函数) [编辑]
返回关联的分配器
(公开成员函数) [编辑]
元素访问
访问指定位置的字符，带边界检查
(公开成员函数) [编辑]
访问指定位置的字符
(公开成员函数) [编辑]
(C++11)
访问的第一个字符
原文：
accesses the first character
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
(C++11)
访问的最后一个字符
原文：
accesses the last character
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
返回一个指针，指向一个字符串的第一个字符
原文：
returns a pointer to the first character of a string
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
返回一个不可修改的C风格字符串
原文：
returns a non-modifiable standard C character array version of the string
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
(C++17)
 返回到整个字符串的非可修改的basic_string_view
(公开成员函数) [编辑]
迭代器

(C++11)
返回指向字符串第一个元素的迭代器
原文：
returns an iterator to the beginning
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]

(C++11)
返回指向字符串尾端的迭代器
原文：
returns an iterator to the end
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]

(C++11)
返回一个指向字符串最后一个元素的反向迭代器
原文：
returns a reverse iterator to the beginning
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]

(C++11)
返回一个指向字符串前端的反向迭代器
原文：
returns a reverse iterator to the end
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
容量
检查字符串是否为空
原文：
checks whether the string is empty
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
返回字符数量
(公开成员函数) [编辑]
返回最大字符数量
原文：
returns the maximum number of characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
预留存储空间
原文：
reserves storage
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
返回当前分配的存储空间可容纳的最大字符数量
原文：
returns the number of characters that can be held in currently allocated storage
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
(C++11)
通过释放未使用的内存减少内存使用
原文：
reduces memory usage by freeing unused memory
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
操作
删除全部内容
原文：
clears the contents
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
插入字符
原文：
inserts characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
删除字符
(公开成员函数) [编辑]
向末尾添加字符
原文：
appends a character to the end
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
(C++11)
删除最后一个字符
原文：
removes the last character
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
向末尾添加字符（串）
原文：
appends characters to the end
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
向末尾添加字符（串）
原文：
appends characters to the end
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
比较两个字符串
原文：
compares two strings
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
替换出现的每一个指定的字符
原文：
replaces every occurrence of specified characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
返回子字符串
原文：
returns a substring
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
复制字符
原文：
copies characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
改变存储的字符数
原文：
changes the number of characters stored
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
交换字符串的内容
原文：
swaps the contents
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
查找
在字符串中寻找字符（串）
(公开成员函数) [编辑]
寻找字符（串）最后一次出现的位置
原文：
find the last occurrence of a substring
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
寻找字符串中任意字符第一次出现的位置
原文：
find first occurrence of characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
寻找字符串中任意字符第一次缺失的位置
原文：
find first absence of characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
寻找字符串中任意字符最后一次出现的位置
原文：
find last occurrence of characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
寻找字符串中任意字符最后一次缺失的位置
(公开成员函数) [编辑]

常量

[静态]
特殊值。确切的含义取决于具体情况。
原文：
special value. The exact meaning depends on the context
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开静态成员常量) [编辑]

[编辑] 非成员函数

 连接两个字符串或者一个字符串和一个字符
(函数模板) [编辑]
按字典顺序比较两个字符串
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
Input/output
执行字符串的流输入和输出
(函数模板) [编辑]
从I/O流读入数据到字符串
(函数模板) [编辑]
数值转换
(C++11)
(C++11)
(C++11)
将字符串转换为有符号整数
原文：
converts a string to an signed integer
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(函数) [编辑]
(C++11)
(C++11)
将字符串转换为无符号整数
原文：
converts a string to an unsigned integer
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(函数) [编辑]
(C++11)
(C++11)
(C++11)
将字符串转换为浮点值
原文：
converts a string to an floating point value
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(函数) [编辑]
(C++11)
 将整值或浮点值转换成string
(函数) [编辑]
(C++11)
 将整值或浮点值转换成wstring
(函数) [编辑]

[编辑] 字面量

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

[编辑] 帮助类

(C++11)
(C++11)
(C++11)
(C++11)
支持字符串的哈希函数
原文：
hash support for strings
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(类模板特化) [编辑]

[编辑] 推导指引(C++17 起)

来自“http://zh.cppreference.com/mwiki/index.php?title=cpp/string/basic_string&oldid=44394”