Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::views::take — una vista dei primi elementi di un intervallo

std::views::take, dichiarato in <ranges>, crea una vista di al massimo count elementi iniziali di un intervallo. Ne mantiene l’ordine, non crea un contenitore separato e supporta sia la chiamata diretta sia la notazione a pipeline.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <ranges>
std::views::take(range, count)
range | std::views::take(count)

std::views::take è un oggetto adattatore di intervalli fornito da <ranges>. L’espressione std::views::take(range, count) corrisponde a range | std::views::take(count). Se count è non negativo e rappresentabile nel tipo differenza degli iteratori dell’intervallo, il risultato espone i primi count elementi nel loro ordine originale oppure l’intero intervallo se contiene meno elementi. Se count è 0, il risultato è vuoto.

È una vista, non un contenitore copiato: l’applicazione dell’adattatore non copia gli elementi in una nuova raccolta e non rimuove gli elementi finali dalla sorgente. Gli elementi vengono letti durante l’iterazione. Il risultato non deve necessariamente essere di tipo std::ranges::take_view; per alcuni tipi di intervalli lo standard prevede altre rappresentazioni di vista equivalenti, quindi di solito è opportuno usare auto.

L’argomento count deve essere convertibile nel tipo differenza degli iteratori dell’intervallo. Si usi un valore non negativo e rappresentabile in quel tipo, anche quando l’adattatore non costruisce una std::ranges::take_view. Per esempio, nel caso ottimizzato di std::span, l’adattatore converte count in quel tipo prima di calcolare il minimo tra il valore convertito e la lunghezza dell’intervallo. Un valore di tipo senza segno troppo grande per essere rappresentato può diventare -1 dopo la conversione e causare operazioni aritmetiche non valide sugli iteratori, anziché selezionare l’intero intervallo. Quando l’adattatore costruisce una std::ranges::take_view, il costruttore richiede che il valore convertito sia non negativo. Un valore negativo non indica un conteggio a partire dalla fine. Se il tipo dell’intervallo di input è una specializzazione di std::ranges::empty_view, l’adattatore valuta l’argomento count e ne scarta il valore senza costruire una std::ranges::take_view, quindi un valore negativo non viola tale precondizione.

Quando si adatta un contenitore esistente tramite un lvalue, la vista fa riferimento a quel contenitore. La sorgente deve quindi rimanere in vita mentre la vista viene usata; le operazioni che invalidano gli iteratori possono invalidare anche l’accesso tramite la vista. Nell’esempio, la modifica di values[0] dopo la creazione di first è visibile nell’output: 11 20 30. Il codice mostrato è stato eseguito senza modifiche in un ambiente isolato. Il suo output standard corrispondeva esattamente a quello indicato.

Esempi

#include <array>
#include <iostream>
#include <ranges>

int main() {
    std::array<int, 5> values{10, 20, 30, 40, 50};
    auto first = values | std::views::take(3);
    values[0] = 11;

    bool separator = false;
    for (int value : first) {
        if (separator) std::cout << ' ';
        std::cout << value;
        separator = true;
    }
    std::cout << '\n';
}

Risultato

11 20 30

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