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 или совместимым классом 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 не является CharT или Allocator::value_type не является CharT.

Для распространённых типов символов предоставлены несколько псевдонимов типов:

Параметры шаблона

Инвалидация итераторов

Ссылки, указатели и итераторы, указывающие на элементы basic_string, могут стать недействительными при вызове любой функции стандартной библиотеки, принимающей в качестве аргумента ссылку на неконстантный basic_string, например std::getline, std::swap или operator>>, а также при вызове неконстантных функций-членов, за исключением operator[], at, data, front, back, begin, rbegin, end и rend.

Вложенные типы

Члены-данные

Функции-члены

Функции, не являющиеся членами

Литералы

Вспомогательные классы

Руководства по выводу типов (начиная с C++17)

Примечания

Хотя до C++23 требовалось использовать пользовательские construct или destroy при создании или уничтожении элементов std::basic_string, все реализации использовали только механизм по умолчанию. Это требование исправлено в P1072R10 в соответствии с существующей практикой.

Пример

#include <iostream>
#include <string>

int main()
{
    using namespace std::literals;
    
    // Creating a string from const char*
    std::string str1 = "hello";
    
    // Creating a string using string literal
    auto str2 = "world"s;
    
    // Concatenating strings
    std::string str3 = str1 + " " + str2;
    
    // Print out the result
    std::cout << str3 << '\n';
    
    std::string::size_type pos = str3.find(" ");
    str1 = str3.substr(pos + 1); // the part after the space
    str2 = str3.substr(0, pos);  // the part till the space
    
    std::cout << str1 << ' ' << str2 << '\n';
    
    // Accessing an element using subscript operator[]
    std::cout << str1[0] << '\n';
    str1[0] = 'W';
    std::cout << str1 << '\n';
}

hello world
world hello
w
World

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

См. также

Внешние ссылки