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

Agrega un nuevo elemento al final del contenedor. Normalmente, el elemento se construye utilizando new de emplazamiento para construir el elemento in situ en la ubicación proporcionada por el contenedor. Los argumentos args... se reenvían al constructor como std:: forward < Args > ( args ) ... .

No se invalidan iteradores ni referencias, excepto end() , que se invalida si ocurre la inserción.

Parámetros

Valor de retorno

back() , es decir, una referencia al elemento insertado.

Complejidad

Constante.

Excepciones

• std::bad_alloc si size ( ) == capacity ( ) antes de la invocación.
• Cualquier excepción lanzada por la inicialización del elemento insertado.

Si se lanza una excepción por cualquier razón, estas funciones no tienen efecto ( strong exception safety guarantee ).

Ejemplo

#include <inplace_vector>
#include <new>
#include <print>
#include <string>
#include <utility>
int main()
{
    std::inplace_vector<std::pair<std::string, std::string>, 2> fauna;
    std::string dog{"\N{DOG}"};
    fauna.emplace_back("\N{CAT}", dog);
    fauna.emplace_back("\N{CAT}", std::move(dog));
    std::println("fauna = {}", fauna);
    try
    {
        fauna.emplace_back("\N{BUG}", "\N{BUG}"); // lanza excepción: no hay espacio
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
    std::println("fauna = {}", fauna);
}

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

Véase también