std:: basic_string

类模板 basic_string 用于存储和操作类字符对象序列，这些对象是 平凡类型 和 标准布局类型 的非数组对象。该类的定义既不依赖于字符类型，也不依赖于对该类型的操作性质。操作的具体定义通过 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 起) 首元素的函数。

std::basic_string 满足 分配器感知容器 的要求（但元素的构造/析构不使用自定义的 construct / destroy ）， 顺序容器 以及 连续容器 (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 中修复。

参见

外部链接