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)

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

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

Примечания

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

Смотрите также

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