std:: basic_string

Шаблон класса 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::value_type отличается от CharT , программа является некорректной.

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

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

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

Члены данных

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

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

Литералы

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

Руководства по выводу (начиная с 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 .

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

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