CKTIS / C++
std::ranges::copy — copiare gli elementi di un intervallo
std::ranges::copy copia gli elementi nell’ordine di input verso una destinazione indicata da un iteratore di output. Accetta un intervallo intero oppure un iteratore e un sentinel, e restituisce le posizioni finali di input e output.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <algorithm>
std::ranges::copy(first, last, result);
std::ranges::copy(range, result);std::ranges::copy, dichiarato in <algorithm>, assegna gli elementi di input successivi all’output. Gli overload senza policy di esecuzione accettano un intervallo oppure una coppia iteratore-sentinel; il sentinel non deve necessariamente avere lo stesso tipo dell’iteratore. L’input deve soddisfare input_range o input_iterator, mentre l’output deve soddisfare weakly_incrementable e il requisito corrispondente indirectly_copyable.
L’output deve consentire la scrittura di tutti gli elementi. L’algoritmo non riceve un limite per l’output e non amplia un contenitore da sé: con un iteratore ordinario, gli elementi di destinazione devono già esistere. L’inizio dell’output non deve trovarsi in [first, last); la copia verso sinistra con sovrapposizione è consentita se questa condizione è rispettata. Per N elementi esegue esattamente N assegnazioni.
Il risultato std::ranges::copy_result espone .in e .out: l’iteratore di input finale e l’iteratore successivo all’ultimo elemento scritto. Per un intervallo temporaneo che non soddisfa borrowed_range, .in è di tipo std::ranges::dangling. A differenza di std::copy, il risultato non è soltanto un iteratore di output.
L’esempio usa array separati e l’overload che accetta un intervallo. Questa voce riguarda l’uso in C++23; la bozza di standard collegata viene aggiornata e può contenere estensioni successive.
Esempi
#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';
}
Risultato
2 4 6 1 1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.