std::basic_string<CharT,Traits,Allocator>::push_back
void push_back( CharT ch ); | (до C++20) | |
constexpr void push_back( CharT ch ); | (с C++20) |
Добавляет заданный символ ch в конец строки.
Параметры
| ch | - | добавляемый символ |
Возвращаемое значение
(ничего)
Сложность
Амортизированная константа.
Исключения
Если операция приведет к size() > max_size(), выбрасывает std::length_error.
Если по какой-либо причине произойдет исключение, эта функция не оказывает никакого эффекта (гарантия сильной устойчивости к исключениям).
Пример
#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 | Применимо к | Поведение, опубликованное | Корректное поведение |
|---|---|---|---|
| LWG 7 | C++98 | (1) описание отсутствовало в стандарте C++ (2) тип параметра был const CharT | (1) добавлено описание (2) изменено на CharT |
| LWG 847 | C++98 | гарантия устойчивости к исключениям отсутствовала | добавлены гарантии сильной устойчивости к исключениям |
См. также
|
(DR*) | удаляет последний символ (публичный член-функция) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/push_back