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.