Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::back_insert_iterator — añadir mediante un iterador de salida

std::back_insert_iterator es un adaptador de iterador de salida que convierte la asignación de un valor en una llamada a push_back del contenedor. Permite añadir elementos con *out++ = value sin sobrescribir los elementos existentes.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <iterator>
std::back_insert_iterator<Container> out(container);
*out++ = value;
// Equivalent factory:
auto out2 = std::back_inserter(container);

std::back_insert_iterator<Container>, declarado en <iterator>, es un adaptador de iterador de salida. Su constructor recibe Container& y guarda la dirección del contenedor; el adaptador no es su propietario. El contenedor debe seguir existiendo mientras se use el adaptador y proporcionar la operación push_back adecuada.

Asignar un valor a través del adaptador añade un elemento: la sobrecarga para const Container::value_type& llama a push_back(value), mientras que la sobrecarga para Container::value_type&& llama a push_back(std::move(value)). operator* devuelve el propio adaptador, no una referencia a un elemento. Los operadores ++ no avanzan ninguna posición ni añaden elementos; por tanto, *out++ = value añade exactamente un elemento.

Esta herramienta sirve para escribir, no para leer ni recorrer elementos. Añade elementos nuevos en lugar de sobrescribir los existentes. La función std::back_inserter(container) crea el mismo tipo de adaptador sin tener que indicar explícitamente el tipo del contenedor.

En el ejemplo, el contenedor contiene inicialmente 10, y dos asignaciones añaden 20 y 30. El código está pensado para compilarse localmente con -std=c++23. Las páginas citadas presentan el borrador de trabajo en evolución, no una publicación congelada de C++23.

Ejemplos

#include <cstddef>
#include <iostream>
#include <iterator>
#include <vector>

int main() {
    std::vector<int> values{10};
    std::back_insert_iterator<std::vector<int>> out(values);

    *out++ = 20;
    *out++ = 30;

    for (std::size_t i = 0; i < values.size(); ++i) {
        if (i != 0) {
            std::cout << ' ';
        }
        std::cout << values[i];
    }
    std::cout << '\n';
}

Resultado

10 20 30

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes