Spec-Zone.ru › C++

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 гарантия устойчивости к исключениям отсутствовала добавлены гарантии сильной устойчивости к исключениям

См. также

pop_back
(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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API