CKTIS / C++
std::ranges::copy — copiar elementos de um intervalo
std::ranges::copy copia os elementos pela ordem de entrada para um destino indicado por um iterador de saída. Aceita um intervalo inteiro ou um iterador e uma sentinela, e devolve as posições finais de entrada e saída.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);std::ranges::copy, declarado em <algorithm>, atribui elementos de entrada sucessivos à saída. As sobrecargas sem política de execução aceitam um intervalo ou um par iterador-sentinela; a sentinela não tem de ser do mesmo tipo que o iterador. A entrada tem de satisfazer input_range ou input_iterator, e a saída tem de satisfazer weakly_incrementable e o requisito correspondente indirectly_copyable.
A saída tem de permitir escrever todos os elementos. O algoritmo não recebe um limite de saída e não aumenta um contentor por si próprio: com um iterador comum, os elementos de destino têm de existir previamente. O início da saída não pode estar em [first, last); é permitida a cópia para a esquerda com sobreposição se esta condição for respeitada. Para N elementos, executa exatamente N atribuições.
O resultado std::ranges::copy_result expõe .in e .out: o iterador de entrada final e o iterador após o último elemento escrito. Para um intervalo temporário que não satisfaça borrowed_range, .in tem o tipo std::ranges::dangling. Ao contrário de std::copy, o resultado não é apenas um iterador de saída.
O exemplo utiliza arrays separados e a sobrecarga que recebe um intervalo. Esta entrada aborda a utilização em C++23; o projeto de norma ligado é atualizado e pode conter extensões posteriores.
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.