std:: basic_string

类模板 basic_string 存储并操作类字符对象序列，这些对象是 字符 类型的非数组对象，且满足 TrivialType 和 StandardLayoutType 要求。该类的定义既不依赖于字符类型，也不依赖于对该类型的操作性质。操作的具体定义通过 Traits 模板参数提供——该参数是 std::char_traits 的特化或兼容的特征类。

basic_string 的元素是连续存储的，也就是说，对于任意 basic_string 对象 s ， 满足 &*(s.begin() + n) == &*s.begin() + n 对任意 n 在区间 [ ​ 0 ​ , s. size ( ) ) 内成立 ， 且 *(s.begin() + s.size()) 的值为 CharT ( ) （空终止符） (C++11 起) ； 或者等效地说，指向 s[ 0 ] 的指针可以传递给期望指向 数组首元素 (C++11 前) 空终止数组首元素 (C++11 起) 的函数，该数组元素类型为 CharT 。

std::basic_string 满足 AllocatorAwareContainer 的要求（但元素的构造/析构不使用自定义的 construct / destroy 方法）、 SequenceContainer 以及 ContiguousContainer (C++17 起) 。

如果 Traits::char_type 和 Allocator::value_type 中有任何一个与 CharT 不同，则程序格式错误。

提供了用于常见字符类型的多个类型定义：

模板参数

嵌套类型

数据成员

成员函数

非成员函数

字面量

辅助类

推导指引 (C++17 起)

迭代器失效

指向 basic_string 元素的引用、指针和迭代器可能因以下操作而失效：任何接受非常量 basic_string 引用参数的标准库函数（例如 std::getline 、 std::swap 或 operator>> ），以及调用非常量成员函数（但以下成员函数除外： operator[] 、 at 、 data 、 front 、 back 、 begin 、 rbegin 、 end 和 rend ）。

注释

尽管在 C++23 之前要求构造或销毁 std::basic_string 元素时必须使用自定义的 construct 或 destroy 方法，但所有实现均仅采用默认机制。 P1072R10 已根据现有实践对此要求进行了修正。

示例

#include <iostream>
#include <string>
int main()
{
    using namespace std::literals;
    // 从 const char* 创建字符串
    std::string str1 = "hello";
    // 使用字符串字面量创建字符串
    auto str2 = "world"s;
    // 连接字符串
    std::string str3 = str1 + " " + str2;
    // 输出结果
    std::cout << str3 << '\n';
    std::string::size_type pos = str3.find(" ");
    str1 = str3.substr(pos + 1); // 空格后的部分
    str2 = str3.substr(0, pos);  // 空格前的部分
    std::cout << str1 << ' ' << str2 << '\n';
    // 使用下标运算符[]访问元素
    std::cout << str1[0] << '\n';
    str1[0] = 'W';
    std::cout << str1 << '\n';
}

hello world
world hello
w
World

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

1. ↑ Traits::char_type 的情况已在 P1148R0 中修复。

另请参阅

外部链接