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, &*(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::char_type отличается от CharT, программа некорректна.

Предоставляются несколько определений типов для общих типов символов:

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

Типы-члены

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

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

Литералы

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

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

Примечания

Хотя требуется, чтобы настраиваемые construct или destroy использовались при создании или уничтожении элементов std::basic_string до C++23, все реализации использовали только механизм по умолчанию. Требование исправлено в 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++.

1. Случай Traits::char_type исправлен в P1148R0.

См. также

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