std::basic_string

 

C++

Язык

Стандартная библиотека

Самостоятельные и принятые реализации

Требования к именованию

Поддержка языка

Библиотека концепций (C++20)

Обработка исключений

Библиотека утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки потоков (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

 

Строки

Байтовые строки с завершающим нулем

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

basic_string_view

char_traits

 

std::basic_string

Функции-члены basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Доступ к элементам basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str basic_string::operator basic_string_view (C++17) Итераторы basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Вместимость basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

Операции basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Поиск basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Константы basic_string::npos

Функции, не являющиеся членами operator+ operator==operator!=operator<operator>operator<=operator>= swap(std::basic_string) operator<<operator>> getline stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11) stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) operator""s (C++14) Вспомогательные классы hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string> (C++11)(C++11)(C++11)(C++11) hash<std::pmr::string>hash<std::pmr::wstring>hash<std::pmr::u32string>hash<std::pmr::u16string> (C++20)(C++20)(C++20)(C++20) Правила вывода типов(C++17)

 

Определён в заголовочном файле <string>
template<     class CharT,     class Traits = std::char_traits<CharT>,     class Allocator = std::allocator<CharT> > class basic_string;	(1)
namespace pmr {     template <class CharT, class Traits = std::char_traits<CharT>>     using basic_string = std::basic_string< CharT, Traits,                                             std::polymorphic_allocator<CharT>> }	(2)	(начиная с C++17)

Шаблон класса basic_string хранит и управляет последовательностью char-подобных объектов. Класс не зависит ни от используемого символьного типа, ни от природы операций над этим типом. Определения этих операций передаются через параметр шаблона Traits, являющийся специализацией std::char_traits или любым другим совместимым классом свойств.

Элементы basic_string хранятся непрерывно, иными словами для basic_string s справедливо &*(s.begin() + n) == &*s.begin() + n для любого n в диапазоне [0, s.size()), или, что идентично, указатель на s[0] может быть передан в функцию, которая ожидает указатель на первый элемент массива charT[].

(начиная с C++11)

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

Заголовочный файл <string>
Type	Definition
std::string	std::basic_string<char>
std::wstring	std::basic_string<wchar_t>
std::u8string (C++20)	std::basic_string<char8_t>
std::u16string (C++11)	std::basic_string<char16_t>
std::u32string (C++11)	std::basic_string<char32_t>
std::pmr::string (C++17)	std::pmr::basic_string<char>
std::pmr::wstring (C++17)	std::pmr::basic_string<wchar_t>
std::pmr::u8string (C++20)	std::pmr::basic_string<char8_t>
std::pmr::u16string (C++17)	std::pmr::basic_string<char16_t>
std::pmr::u32string (C++17)	std::pmr::basic_string<char32_t>

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

CharT	—	символьный тип
Traits	—	класс свойств, устанавливающий операции над символьным типом
Allocator	—	тип-Allocator, используемый для внутреннего выделения памяти

Типы-члены

Тип-член	Определение
traits_type	Traits
value_type	Traits::char_type
allocator_type	Allocator
size_type	Беззнаковый целочисленный тип (обычно size_t)
difference_type	Знаковый целочисленный тип (обычно std::ptrdiff_t)
reference	Allocator::reference (до C++11) value_type& (начиная с C++11)
const_reference	Allocator::const_reference (до C++11) const value_type& (начиная с C++11)
pointer	Allocator::pointer (до C++11) std::allocator_traits<Allocator>::pointer (начиная с C++11)
const_pointer	Allocator::const_pointer (до C++11) std::allocator_traits<Allocator>::const_pointer (начиная с C++11)
iterator	RandomAccessIterator
const_iterator	Константный итератор с произвольным доступом
reverse_iterator	std::reverse_iterator<iterator>
const_reverse_iterator	std::reverse_iterator<const_iterator>

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

(конструктор)	создаёт basic_string (public функция-член)
operator=	присваивает значения строке (public функция-член)
assign	назначает символы строке (public функция-член)
get_allocator	Возвращает связанный аллокатор (public функция-член)
Доступ к элементам
at	получение указанного символа с проверкой выхода индекса за границы (public функция-член)
operator[]	получение указанного символа (public функция-член)
front (C++11)	получение первого символа (public функция-член)
back (C++11)	получение последнего символа (public функция-член)
data	возвращает указатель на первый символ строки (public функция-член)
c_str	возвращает немодифицируемый массив символов С, содержащий символы строки (public функция-член)
operator basic_string_view (C++17)	возвращает string_view (public функция-член)
Итераторы
begin cbegin (C++11)	Возвращает итератор на первый элемент (public функция-член)
end cend (C++11)	Возвращает итератор на элемент, следующий за последним (public функция-член)
rbegin crbegin (C++11)	Возвращает обратный итератор на первый элемент (public функция-член)
rend crend (C++11)	Возвращает обратный итератор на элемент, следующий за последним (public функция-член)
Вместимость
empty	проверяет, является ли строка пустой (public функция-член)
size length	возвращает количество символов в строке (public функция-член)
max_size	возвращает максимальное количество символов (public функция-член)
reserve	резервирует место под хранение (public функция-член)
capacity	возвращает количество символов, которые могут содержаться в текущем выделенном хранилище (public функция-член)
shrink_to_fit (C++11)	уменьшает использование памяти, освобождая неиспользуемую память (public функция-член)
Операции
clear	очищает содержимое строки (public функция-член)
insert	вставка символов (public функция-член)
erase	удаление символов (public функция-член)
push_back	добавление символа в конец строки (public функция-член)
pop_back (C++11)	удаляет последний символ (public функция-член)
append	добавляет символы в конец строки (public функция-член)
operator+=	добавляет символы в конец строки (public функция-член)
compare	сравнивает две строки (public функция-член)
replace	заменяет каждое вхождение указанного символа (public функция-член)
substr	возвращает подстроку (public функция-член)
copy	копирует символы (public функция-член)
resize	изменяет количество хранимых символов (public функция-член)
swap	обменивает содержимое (public функция-член)
Поиск
find	поиск подстроки в строке (public функция-член)
rfind	поиск последнего вхождения подстроки (public функция-член)
find_first_of	поиск первого вхождения символов (public функция-член)
find_first_not_of	найти первое вхождение отсутствия символов в строку (public функция-член)
find_last_of	найти последнее вхождение символов (public функция-член)
find_last_not_of	найти последнее вхождение отсутствия символов (public функция-член)
Константы
npos [static]	специальное значение. Точный смысл зависит от контекста (public static константа-член)

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

operator+	объединяет две строки или строку и символ (шаблон функции)
operator== operator!= operator< operator> operator<= operator>=	лексикографическое сравнение двух строк (шаблон функции)
std::swap(std::basic_string)	специализированный для строк std::swap алгоритм (шаблон функции)
Ввод/вывод
operator<< operator>>	выполняют потоковый вывод/ввод строк std::basic_string (шаблон функции)
getline	считывает данные из потока ввода/вывода в строку (функция)
Числовые преобразования
stoi stol stoll (C++11) (C++11) (C++11)	преобразует строку в знаковое целое число (функция)
stoul stoull (C++11) (C++11)	преобразует строку в беззнаковое целое число (функция)
stof stod stold (C++11) (C++11) (C++11)	преобразует строку в число с плавающей точкой (функция)
to_string (C++11)	преобразует целое число или число с плавающей точкой в string (функция)
to_wstring (C++11)	преобразует целое число или число с плавающей точкой в wstring (функция)

Литералы

Пространство имён std::literals::string_literals
operator""s (C++14)	Возвращает basic_string из строки с завершающим нулём (функция)

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

std::hash<std::string> std::hash<std::u16string> std::hash<std::u32string> std::hash<std::wstring> (C++11) (C++11) (C++11) (C++11)	хеширование строк (специализация шаблона класса)