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

Agrega un nuevo elemento al final del contenedor. Normalmente, el elemento se construye utilizando placement- new 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 ) ... . Equivalente a return * try_emplace_back ( std:: forward < Args > ( args ) ... ) ; .

Antes de la llamada a esta función size ( ) < capacity ( ) debe ser true . De lo contrario, el comportamiento es indefinido.

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

Cualquier excepción lanzada por la inicialización del elemento insertado. Si se lanza una excepción por cualquier razón, esta función no tiene efecto ( garantía fuerte de seguridad de excepciones ).

Notas

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.unchecked_emplace_back("\N{CAT}", dog);
    fauna.unchecked_emplace_back("\N{CAT}", std::move(dog));
    std::println("fauna = {}", fauna);
    // fauna.unchecked_emplace_back("BUG", "BUG"); // comportamiento indefinido: sin espacio
}

fauna = [("🐈", "🐕"), ("🐈", "🐕")]

Véase también