Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti