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

CKTIS / C++

std::ranges::copy — copiar elementos de un rango

std::ranges::copy copia los elementos en el orden de entrada a un destino indicado por un iterador de salida. Acepta un rango completo o un iterador y un centinela, y devuelve las posiciones finales de entrada y salida.

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

Sintaxis

#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);

std::ranges::copy, declarado en <algorithm>, asigna elementos de entrada sucesivos a la salida. Las sobrecargas sin política de ejecución aceptan un rango o un par iterador-centinela; el centinela no tiene por qué ser del mismo tipo que el iterador. La entrada debe cumplir input_range o input_iterator, y la salida debe cumplir weakly_incrementable y el requisito correspondiente indirectly_copyable.

La salida debe permitir escribir todos los elementos. El algoritmo no recibe un límite de salida ni amplía por sí mismo un contenedor: con un iterador ordinario, los elementos de destino deben existir ya. El inicio de la salida no debe estar dentro de [first, last); se permite copiar hacia la izquierda con solapamiento si se cumple esta condición. Para N elementos, realiza exactamente N asignaciones.

El resultado std::ranges::copy_result expone .in y .out: el iterador de entrada final y el iterador situado después del último elemento escrito. Para un rango temporal que no cumpla borrowed_range, .in tiene el tipo std::ranges::dangling. A diferencia de std::copy, el resultado no es únicamente un iterador de salida.

El ejemplo usa arrays separados y la sobrecarga que recibe un rango. Esta entrada trata el uso en C++23; el borrador de estándar enlazado se actualiza y puede incluir extensiones posteriores.

Ejemplos

#include <algorithm>
#include <array>
#include <iostream>

int main() {
    const std::array<int, 3> source{2, 4, 6};
    std::array<int, 3> destination{};

    const auto result = std::ranges::copy(source, destination.begin());

    std::cout << destination[0] << ' ' << destination[1] << ' '
              << destination[2] << '\n';
    std::cout << (result.in == source.end()) << ' '
              << (result.out == destination.end()) << '\n';
}

Resultado

2 4 6
1 1

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