клас basic_string

ptr
C-рядок для приєднання.

str
Рядок, символи додаватися.

_Off
Індекс частини початкового рядка, що надає додаються знаки.

count
Число символів для додавання в, максимум з початкового рядка.

_Ch
Додається значення символу.

first
Итератор введення першого елемента в діапазоні для додавання.

last
Итератор введення, const_pointer або const_iterator, який звертається до положення один після останнього елемента в діапазоні для додавання.

значення, що повертається

Примітки

Символи можуть додаватися в рядок за допомогою оператор + = або функції-члени додайте або push_back. operator + = Додає значення одним аргументом при аргументі кілька додайте функції-члена дозволяє певної частини рядка для додавання.

ptr
Покажчик на символи рядка C для призначення цільової рядки.

count
Число символів для додавання в, максимум з початкового рядка.

str
Вихідна рядок, символи яких призначаються в цільової рядку.

_Ch
Привласнюється значення символу.

off
Позиція, з якої починається нові символи можуть бути призначені.

значення, що повертається

Примітки

Рядки можна призначити значення нових символів. Нове значення може бути рядки і рядки C або один символ. Оператор = може використовуватися, якщо нове значення може бути описаний за допомогою одного параметра; в іншому випадку функція-член призначити. якої має кілька параметрів можна використовувати для вкажіть, які частини рядка призначатися цільової рядки.

_Off
Індекс позиції посилатися на елемент.

значення, що повертається

Примітки

Перший елемент рядка має індекс 0 і наступні елементи послідовно індексуються позитивних цілих чисел, щоб рядок довжини n має n й елемент індекс на число n - 1.

Елемент оператор [] швидше, ніж функція-член в для надання читання і запис до елементів рядка.

Елемент operator [] не перевіряє допустимість індексу, переданого в якості параметра, але функція-член в корпорації, тому слід використовувати, якщо допустимість не гарантований. Неприпустимий індекс, який є індекс менше нуля або більше або дорівнює розміру рядка, що передаються функції-члена в викликає клас out_of_range виняток. Передано неприпустимий індекс operator [] призведе до невизначеного поведінки, але дорівнює довжині рядка індекс є допустимим індексом для const рядків і оператор повертає нуль символу при передачі цього індексу.

ptr
C-рядок, символи можуть використовуватися для ініціалізації створюваної рядки string. Це значення не може бути дороговказом null.

_Al
Клас розподільника сховища для створюваного строкового об'єкта.

count
Кількість ініціалізіруемих символів.

right
Рядок, инициализирующая створювану рядок.

_Roff
Індекс символу в рядку, який першим використовується для ініціалізації значень символів створюваної рядки.

_Ch
Значення символу, копируемое в створювану рядок.

first
Итератор введення, const_pointer або const_iterator, який вказує на перший елемент в діапазоні джерела, який необхідно вставити.

last
Итератор введення, const_pointer або const_iterator, який вказує на стан відразу за останнім елементом в діапазоні джерела, який необхідно вставити.

значення, що повертається

Примітки

Всі конструктори зберігають basic_string :: allocator_type і форматувати керованої послідовності. Об'єктом розподільника є аргумент al. якщо він існує. Для конструктора копії - right. basic_string :: get_allocator (). В іншому випадку - Alloc ().

Керована послідовність инициализируется для копії послідовності операндів, зазначеної залишилися операндами. Конструктор без послідовності операндів вказує порожню початкову керовану послідовність. Якщо InputIterator має тип integer в конструктор шаблону, _F послідовності операнда irst, last поводиться так само, як (size_type) first, (value_type) last.

значення, що повертається

Покажчик на версії C-стиль виклику рядки. Значення покажчика не припустимо після виклику функції неконстантной, включаючи деструкцію класу basic_string об'єкта.

Примітки

Об'єкти типу String, що належать basic_string C ++ шаблону класу<> <>> Є не обов'язково null завершено. Символ null '\ 0' використовується для позначення кінця рядка як спеціальний символ в рядок C, але не має особливого сенсу в об'єкті типу String і може бути частиною рядка так само, як будь-який інший символ. Виконується автоматичне перетворення з const ** char * ** в рядках, але рядок клас не надає автоматичного перетворення рядка в стилі C для об'єктів типу basic_string<>>.

Не слід змінювати повертається рядка C-стилі, як це може зробити недійсним покажчик на рядок, або видалити, оскільки рядок має обмежений час існування і належить рядок класу.

str
Рядок, для порівняння рядка операнд.

_Pos1
Індекс рядка операнд, з якого починається порівняння.

_Num1
Максимальна кількість символів з рядка операнда для порівняння.

_Num2
Максимальна кількість символів з рядка параметра для порівняння.

_Off
Індекс рядка параметра, з якого починається порівняння.

count
Максимальна кількість символів з рядка параметра для порівняння.

ptr
C-рядок для порівняння рядка операнд.

значення, що повертається

Негативне значення, якщо рядок операнд менше, ніж рядок параметра; нуль, якщо два рядки не рівні; або позитивне значення, якщо операнд рядки більше, ніж рядок параметра.

Примітки

Порівняння функції-члени порівняти всі або частину параметрів і операнд рядки в залежності від того, який використовується.

Порівняння виконується з урахуванням регістра.

значення, що повертається

Покажчик на перший елемент масиву, що містить вміст рядка, або порожній масив, покажчик на відмінних від null, не може бути разименован.

Примітки

Об'єкти типу String, що належать basic_string C ++ шаблону класу <>> Є не обов'язково null завершено. Тип значення, що повертається для дані не допустиму C-рядок, оскільки поповнюється нуль-символ. Символ null '\ 0' використовується для позначення кінця рядка, як спеціальний символ в рядок C, але не має особливого сенсу в об'єкті типу String і може бути частиною строковий об'єкт так само, як будь-який інший символ.

Виконується автоматичне перетворення з const ** char * ** в рядках, але рядок клас не надає автоматичного перетворення рядка в стилі C для об'єктів типу ** basic_string <> <>> **.

Рядок, що повертається не слід змінювати, так як це може зробити недійсним покажчик на рядок, або видалений, оскільки рядок має обмежений час існування і належить рядок класу.

first
Итератор, який звертається до положення першого елемента в діапазоні для видалення.

last
Итератор, який звертається до позиції після останнього елемента в діапазоні для видалення.

_It
Итератор, який звертається до положення елемента в рядок для видалення.

_Pos
Індекс першого символу в рядку повинні бути видалені.

count
Число елементів, які будуть видалені, якщо число в діапазоні від-рядок, що починається з _Pos.

значення, що повертається

Для перших двох функцій-членів, итератор першого символу після останнього символу видалені функцією-членом. Для третьої функції-члена, посилання на об'єкт string, з якого видалені елементи.

Примітки

Третя функція-член повертає ** * це **.

_Ch
Значення символу, для якого слід шукати функцію-член.

_Off
Індекс позиції, в якій слід почати пошук.

ptr
Рядок C-string, для якої слід шукати функцію-член.

count
Число символів, починаючи з першого, в рядку C-string, для якої слід шукати функцію-член.

str
Рядок, для якої слід шукати функцію-член.

значення, що повертається

Індекс першого символу шуканої підрядка, якщо вона успішно знайдена; в іншому випадку - npos.

_Ch
Значення символу, для якого слід шукати функцію-член.

_Off
Індекс позиції, в якій слід почати пошук.

ptr
Рядок C-string, для якої слід шукати функцію-член.

count
Число символів, починаючи з першого, в рядку C-string, для якої слід шукати функцію-член.

str
Рядок, для якої слід шукати функцію-член.

значення, що повертається

Індекс першого символу шуканої підрядка, якщо вона успішно знайдена; в іншому випадку - npos.

_Ch
Значення символу, для якого слід шукати функцію-член.

_Off
Індекс позиції, в якій слід почати пошук.

ptr
Рядок C-string, для якої слід шукати функцію-член.

count
Число символів, починаючи з першого, в рядку C-string, для якої слід шукати функцію-член.

str
Рядок, для якої слід шукати функцію-член.

значення, що повертається

Індекс першого символу шуканої підрядка, якщо вона успішно знайдена; в іншому випадку - npos.

_Ch
Значення символу, для якого слід шукати функцію-член.

_Off
Індекс позиції, з якої здійснюється для завершення.

ptr
Рядок C-string, для якої слід шукати функцію-член.

count
Число символів, починаючи з першого, в рядку C-string, для якої слід шукати функцію-член.

str
Рядок, для якої слід шукати функцію-член.

значення, що повертається

Індекс першого символу шуканої підрядка, якщо вона успішно знайдена; в іншому випадку - npos.

_Ch
Значення символу, для якого слід шукати функцію-член.

_Off
Індекс позиції, з якої здійснюється для завершення.

ptr
Рядок C-string, для якої слід шукати функцію-член.

count
Число символів, починаючи з першого, в рядку C-string, для якої слід шукати функцію-член.

str
Рядок, для якої слід шукати функцію-член.

значення, що повертається

Пошук індексу останнього символу підрядка при успішно; в іншому випадку npos.

_P0
Індекс позиції за точкою вставки нових символів.

ptr
C-рядок, яка повністю або частково вставляється в рядок.

count
Число вставляються знаків.

str
Рядок, яка повністю або частково вставляється в цільову рядок.

_Off
Індекс частини початкового рядка, що надає додаються знаки.

_Ch
Символьне значення елементів, що вставляються.

_It
Итератор, що дозволяє положення, за яким вставляється знак.

значення, що повертається

_Off
Індекс позиції посилатися на елемент.

значення, що повертається

Примітки

Перший елемент рядка має індекс 0, а також такі елементи послідовно індексуються позитивних цілих чисел, щоб рядок довжини n має n й елемент індекс на число n - 1.

operator [] швидше, ніж функція-член в для надання читання і запис до елементів рядка.

operator [] не перевіряє допустимість індексу, переданого в якості параметра, але функція-член в і тому слід використовувати в дійсності не гарантований. Неприпустимий індекс (індекс менше нуля або більше або дорівнює розміру рядка), який передається функції-члена в викликає клас out_of_range виняток. Передано неприпустимий індекс operator [] призведе до невизначеного поведінки, але дорівнює довжині рядка індекс є допустимим індексом для const рядків і оператор повертає символ null при передачі цього індексу.

При компіляції з параметром _ІТЕРАТОР_отладкі_УРОВНЯ значення 1 або 2, виникне помилка часу виконання при спробі доступу до елементу за межами рядка. Для отримання додаткової інформації див. Checked Iterators.

значення, що повертається

Примітки

rbegin використовується зі зворотним рядку як почати використовується з рядком.

Якщо значення, що повертається rbegin призначається const_reverse_iterator. строковий об'єкт не може змінюватися. Якщо значення, що повертається rbegin призначається reverse_iterator. рядок об'єкт може бути змінений.

rbegin можна використовувати для ініціалізації зворотного ітерації по рядку.

str
Рядок, що представляє джерело символів для рядка операнд.

_Pos1
Індекс рядка операнд, з якої починається заміна.

_Num1
Максимальна кількість символів в рядку операнд.

_Num2
Максимальна кількість символів для використання в параметрі рядка C.

ptr
C-рядок, яка є джерело символів для рядка операнд.

_Ch
Символ, який необхідно скопіювати в рядку операнд.

first0 *
Итератор першого символу в рядку операнди повинні бути видалені.

last0 *
Итератор останнього символу в рядку операнди повинні бути видалені.

count
Скільки разів _Ch копіюється в рядок операнд.

значення, що повертається

Рядок операнд з зроблені заміни.

count
Число символів, для яких пам'ять резервується.

Примітки

Наявність достатньої дуже важливо, оскільки перерозподілу займає багато часу і робить недійсними всі посилання, покажчики і ітератори, які посилаються на символи в рядку.

Концепція ємності для об'єктів типу рядків є так само, як об'єкти типу вектора. На відміну від об'єкта vector, функція-член зарезервувати може викликатися для зменшення ємності об'єкта. Запит є nonbinding і може або не може відбутися. За замовчуванням значення параметра дорівнює нулю, то виклик зарезервувати - це запит без прив'язки для зменшення обсягу рядки поміщаються число символів в рядку. Ємність не менш поточну кількість символів.

Виклик reserve є єдино можливий спосіб зменшення ємності рядки. Однак, як зазначено вище, цей запит є nonbinding і може не відбутися.