std::basic_string

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

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

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

Потоки (C++11)

 

Строки

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

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

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

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

Классы

basic_string

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::begin basic_string::cbegin (C++11)

basic_string::end basic_string::cend (C++11)

basic_string::rbegin basic_string::crbegin (C++11)

basic_string::rend basic_string::crend (C++11)

Вместимость

basic_string::empty

basic_string::size

basic_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::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

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)

to_wstring (C++11)

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

hash<std::string> hash<std::wstring> hash<std::u32string> hash<std::u16string> (C++11)

 

Определено в заголовочном файле <string>
template<     class CharT,     class Traits = std::char_traits<CharT>,     class Allocator = std::allocator<CharT> > class basic_string;

Шаблон класса 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>
Тип	Определение
std::string	std::basic_string<char>
std::wstring	std::basic_string<wchar_t>
std::u16string (C++11)	std::basic_string<char16_t>
std::u32string (C++11)	std::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 функция-член)
Итераторы
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>>	выполнение потоков ввода/вывода на строках (шаблон функции)
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 (функция)

Литералы

Defined in namespace 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)	хеширование строк (специализация шаблона класса)