Namespaces
Variants

std::basic_string<CharT,Traits,Allocator>:: push_back

From cppreference.net
C++
Strings library
std::basic_string
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* )
удаляет последний символ
(публичная функция-член)