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

void push_back( CharT ch );

constexpr void push_back( CharT ch );

Appends the given character ch to the end of the string.

Parameters

Return value

(none).

Complexity

Amortized constant.

Exceptions

If an exception is thrown for any reason, this function has no effect (strong exception guarantee). (since C++11).

If the operation would result in size() > max_size(), throws std::length_error.

Example

#include <cassert>
#include <string>
#include <iomanip>
#include <iostream>
 
int main()
{
    std::string str{"Short string"};
    std::cout << "before=" << std::quoted(str) << '\n';
    assert(str.size() == 12);
 
    str.push_back('!');
    std::cout << " after=" << quoted(str) << '\n';
    assert(str.size() == 13);
}

before="Short string"
 after="Short string!"

See also