std::basic_string<CharT,Traits,Allocator>::push_back
From ru.cppreference.net
void push_back( CharT ch );
|
(constexpr начиная с C++20) | |
Добавляет заданный символ ch в конец строки.
Параметры
| ch | - | символ для добавления |
Возвращаемое значение
(нет)
Сложность
Амортизированная константа.
Исключения
Если операция приведёт к тому, что
size()
превысит
max_size()
, выбрасывается
std::length_error
.
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( strong exception safety guarantee ).
Пример
Запустить этот код
#include <iomanip> #include <iostream> #include <string> int main() { std::string str{"Short string"}; std::cout << "1) " << std::quoted(str) << ", size: " << str.size() << '\n'; str.push_back('!'); std::cout << "2) " << std::quoted(str) << ", size: " << str.size() << '\n'; }
Вывод:
1) "Short string", size: 12 2) "Short string!", size: 13
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены задним числом к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 7 | C++98 |
1) описание отсутствовало в стандарте C++
2) тип параметра был const CharT |
1) описание добавлено
2) изменено на
CharT
|
| LWG 847 | C++98 | не было гарантии безопасности исключений | добавлена строгая гарантия безопасности исключений |
Смотрите также
|
(
DR*
)
|
удаляет последний символ
(публичная функция-член) |