std::inplace_vector<T,N>:: push_back

Appends the given element value to the end of the container.

No iterators or references are invalidated, except end() , which is invalidated if the insertion occurs.

Parameters

Return value

back() , i.e. a reference to the inserted element.

Complexity

Constant.

Exceptions

• std::bad_alloc if size ( ) == capacity ( ) before invocation.
• Any exception thrown by initialization of inserted element.

If an exception is thrown for any reason, these functions have no effect ( strong exception safety guarantee ).

Example

#include <inplace_vector>
#include <new>
#include <print>
#include <string>
 
int main()
{
    std::inplace_vector<std::string, 2> fauna;
    std::string dog{"\N{DOG}"};
 
    fauna.push_back("\N{CAT}"); // overload (1)
    fauna.push_back(std::move(dog)); // overload (2)
    std::println("fauna = {}", fauna);
 
    try
    {
        fauna.push_back("\N{BUG}"); // throws: there is no space
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
    std::println("fauna = {}", fauna);
}

fauna = ["🐈", "🐕"]
std::bad_alloc
fauna = ["🐈", "🐕"]

See also