basic_string Class

Статья
03/15/2013

Последовательности, контролируемого объекта шаблона basic_string класса являются стандарта C++ класс string и обычно называют строками, но они не следует путать с C-нули в стандартной библиотеке C++.Класс string является контейнером, который позволяет использовать строки как обычные типы, например, с помощью операций сравнения и сцепления, итераторы и алгоритмы библиотеки STL и копирование и назначение с помощью класса распределителя управляемой памяти.

template <
   class CharType,
   class Traits=char_traits<CharType>, 
   class Allocator=allocator<CharType> 
>
class basic_string

Параметры

CharType
Тип данных одного символа для хранения в строке.Стандартная библиотека C++ предоставляет две специализации данного класса шаблона с помощью определения типа строка, для элементов типа char, и wstring, для элементов типа wchar_t.
Traits
Различные важные свойства CharType элементов в специализации basic_string описаны с помощью класса признаков.
Allocator
Тип, представляющий сохраненную распределителя объект, инкапсулирующий сведения о строке выделение и освобождение памяти.Значение по умолчанию — распределитель*<Type>.*

Многие функции-члены требуют операнд последовательность элементов.Можно задать такой операнд последовательности несколькими способами.

Элемент	Описание
_Ch	Один элемент со значением символа _Ch.
_Count, _Ch	Повторение _Count элементов каждого со значением _Ch.
_Ptr	Последовательность нулем, например c строка с CharType типа char, начиная с _Ptr (который не должен быть указателем null), где завершающий элемент является значение value_type и не является частью последовательности операнд.
_Ptr, _Count	Последовательность _Count элементов, начиная с _Ptr.
_Str	Порядковый номер, указанный объектом basic_string.
_Str, _Off, _Count	Подстрока объекта basic_string _Str с до _Count элементов (или до конца строки, встречена) начиная с позиции _Off.
_First, _Last	Последовательность элементов, разделенных итераторы _First и _Last, в диапазоне [_First, _Last), который может накладываться на последовательности, контролируемых строковый объект, для которого функция-член вызывается.

Если аргумент позиции (такие как _Off) выходит за пределы строки при вызове basic_string функция-член, функция сообщает об ошибке вне диапазона, создавая объект типа out_of_range класса.

Если функция запрашивается для создания последовательности более чем max_size элементы, функция сообщает об ошибке длины, создавая объект типа length_error класса.

Ссылки, указатели и итераторы, назначение элементов управляемой последовательности могут стать недействительными после любого вызова функции, которая изменяет управляемой последовательности или после первого вызова не-const функции-члена.

Конструкторы

basic_string

Создает строку, пустой или инициализация с помощью символов, или это копии всех или части некоторых строковый объект или строка C.

Определения типов

allocator_type	Тип, представляющий allocator класса для объекта string.
const_iterator	Тип, который обеспечивает итератора произвольного доступа, доступ и чтение const элементом в строке.
const_pointer	Тип, который содержит указатель на const элемента в строке.
const_reference	Тип, который содержит ссылку на const элемент хранится в строке на чтение и выполнение const операций.
const_reverse_iterator	Тип, который обеспечивает итератора произвольного доступа может читать любой const элементом в строке.
difference_type	Тип, предоставляющий разность двух итераторов, которые ссылаются на элементы в ту же строку.
итератор	Тип, предоставляющий итератора произвольного доступа, который можно прочитать или изменить любой элемент в строке.
nPos	Целочисленное значение без знака при инициализации значение –1, указывающее, либо «не найден» или «все остальные символы» при сбое для функции поиска.
указатели	Тип, который содержит указатель на элемент символов в массиве строку или знак.
Ссылка	Тип, который содержит ссылку на элемент хранится в строке.
reverse_iterator	Тип, предоставляющий итератора произвольного доступа, который можно прочитать или изменить элемент аннулированные строки.
size_type	Неподписанные целочисленный тип для числа элементов в строке.
traits_type	Тип признаков символов для элементов, хранящихся в строку.
value_type	Тип, представляющий тип, в строку символов.

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

append	Добавляет символы конца строки.
assign	Назначает новые значения знаков содержимое строки.
at	Возвращает ссылку на элемент в указанном расположении в строке.
back
begin	Возвращает итератор адресации первым элементом в строке.
c_str	Преобразует содержимое строки как стиля c строка, оканчивающаяся на null.
capacity	Возвращает наибольшее число элементов, которые могут храниться в строку без увеличения выделения памяти из строки.
cbegin	Возвращает const итератора адресации первым элементом в строке.
cend	Возвращает const итератора, расположение, последующие последнего элемента в строке адреса.
clear	Удаляет все элементы строки.
compare	Сравнивает строку с указанной строки, чтобы определить две строки равны, или один lexicographically меньше, чем другой.
copy	Копирует максимум на указанное число знаков из индексированного позиции в строке источника конечного массива символов.Устаревший.Взамен рекомендуется использовать basic_string::_Copy_s.
crbegin	Возвращает const итератор, который первым элементом аннулированные строки адреса.
crend	Возвращает const итератора, расположение, последующие последний элемент в аннулированные строки адреса.
_Copy_s	Копирует максимум на указанное число знаков из индексированного позиции в строке источника конечного массива символов.
data	Преобразует содержимое строки в массив символов.
empty	Проверяет, является ли строка содержит знаки.
end	Возвращает итератор, расположение, последующие последнего элемента в строке адреса.
стереть	Удаляет элемент или набор элементов в строке из указанного места.
find	Поиск строки в прямом направлении первого вхождения подстроки, соответствующей указанной последовательности символов.
find_first_not_of	Поиск по строке для первого символа, который не является любой элемент указанной строки.
find_first_of	Поиск по строке для первого символа, который соответствует любому элементу указанной строки.
find_last_not_of	Поиск по строке для последнего символа, который не является любой элемент в указанной строке.
find_last_of	Поиск по строке для последнего символа, который является элементом указанной строки.
front	Возвращает ссылку на первый элемент строки.
get_allocator	Возвращает копию allocator объект, используемый для создания строки.
Вставка	Вставляет элемент или количество элементов или диапазона элементов в строке в заданной позиции.
length	Возвращает число элементов в строке.
max_size	Возвращает максимальное число символов, которое может содержать строку.
pop_back	Удаляет последний элемент строки.
push_back	Добавляет элемент в конец строки.
rbegin	Возвращает первый элемент в аннулированные строки итератор.
rend	Возвращает итератор, указывающий непосредственно за последним элементом аннулированные строки.
replace	Заменяет указанные символы или символы, скопированные из других диапазонов или строки или строк c элементы в строке в заданной позиции.
reserve	Задает емкость строку в число, по крайней мере хорошо, как заданное число.
resize	Размер строки, добавление или удаление элементов, как требуется.
rfind	Поиск строки в обратном направлении для первого вхождения подстроки, соответствующей указанной последовательности символов.
shrink_to_fit	Удаляет избыточные мощности строки.
size	Возвращает число элементов в строке.
SUBSTR	Копирует подстроку более некоторое количество символов из строки, начиная с указанной позиции.
горячей замены	Обмен содержимое двух строк.

Операторы

оператор +=	Добавляет строку символов.
operator=	Назначает новые значения знаков содержимое строки.
operator[]	Предоставляет ссылку на символ с указанным индексом в строке.

Требования

Заголовок: <string>

Пространство имен: std

См. также

Ссылки

Потокобезопасность в стандартной библиотеке C++

Другие ресурсы

члены basic_string

Члены <string>

Поделиться через