std::basic_string

template< 
    class CharT, 
    class Traits = std::char_traits<CharT>, 
    class Allocator = std::allocator<CharT>
> class basic_string;

namespace pmr {
template<
    class CharT,
    class Traits = std::char_traits<CharT>
> using basic_string =
    std::basic_string<CharT, Traits, std::pmr::polymorphic_allocator<CharT>>;
}

類模板 basic_string 存儲和處理字符式對象的序列，這種對象是滿足平凡類型 (TrivialType) 和標準佈局類型 (StandardLayoutType) 的非數組對象。該類既不依賴字符類型，也不依賴該類型上的原生操作。操作的定義通過 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) （但不使用定製的 construct/destroy 構造/析構元素）、���列容器 (SequenceContainer) 及連續���器 (ContiguousContainer) (C++17 起)。

如果 Traits::char_type 或者 Allocator::char_type 與 CharT 不同，那麼程序非良構。

提供數個對於常用字符類型的 typedef：

模板形參

嵌套類型

數據成員

成員函數

非成員函數

字面量

輔助類

推導指引 (C++17 起)

迭代器失效

指代 basic_string 元素的引用、指針和迭代器，可能會因任何接受非 const basic_string 的引用的標準庫函數而失效，比如 std::getline、std::swap 或 operator>>，或因調用除了 operator[]、at、data、front、back、begin、rbegin、end 和 rend 之外的非 const 成員函數而失效。

註解

儘管在 C++23 前要求在構造或銷毀 std::basic_string 的元素時使用定製的 construct 或 destroy，所有實現都使用默認機制。P1072R10 更正了該要求以匹配既存實踐。

示例

#include <iostream>
#include <string>

int main()
{
    using namespace std::literals;
    
    // 从 const char* 创建 string
    std::string str1 = "hello";
    
    // 从字符串字面量创建 string
    auto str2 = "world"s;
    
    // 拼接 string
    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';

    // 用下标运算符 operator[] 访问元素
    std::cout << str1[0] << '\n';
    str1[0] = 'W';
    std::cout << str1 << '\n';
}

hello world
world hello
w
World

缺陷報告

下列更���行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

參閱

外部連結