Condividi tramite


common_view classe (libreria standard C++)

Accettare un intervallo che può avere tipi di iteratore e sentinel diversi e creare una visualizzazione con lo stesso tipo di iteratore e sentinel. Ciò è utile per chiamare algoritmi STL che accettano intervalli specificati dalle coppie di iteratori.

Sintassi

template<ranges::view V>
    requires (!ranges::common_range<V> && std::copyable<ranges::iterator_t<V>>)
class common_view : public ranges::view_interface<common_view<V>>;

Parametri del modello

V
Tipo della vista sottostante.

Visualizzare le caratteristiche

Per una descrizione delle voci seguenti, vedere Visualizzare le caratteristiche della classe

Caratteristica Descrizione
Adattatore di intervallo views::common
Intervallo sottostante Deve soddisfare forward_range o superiore
Tipo di elemento Uguale all'intervallo sottostante
Visualizzare la categoria iteratore forward_range o random_access_range quando l'intervallo sottostante random_access_range soddisfa e sized_range
Dimensioni Solo se l'intervallo sottostante soddisfa sized_range
Iterabile const Solo se l'intervallo sottostante è const iterabile
Intervallo comune
Intervallo preso in prestito Solo se l'intervallo sottostante soddisfa borrowed_range

Membri

Funzioni membro Descrizione
Costruttori C++20 Creare un oggetto common_view.
baseC++20 Ottenere la visualizzazione sottostante.
beginC++20 Ottiene un iteratore al primo elemento nella visualizzazione.
endC++20 Ottenere l'sentinel alla fine della visualizzazione.
sizeC++20 Ottiene il numero di elementi nella visualizzazione.
Ereditato da view_interface Descrizione
backC++20 Ottiene l'ultimo elemento.
dataC++20 Ottenere un puntatore al primo elemento.
emptyC++20 Verificare se la visualizzazione è vuota.
frontC++20 Ottenere il primo elemento.
operator[]C++20 Ottiene l'elemento nella posizione specificata.
operator boolC++20 Verificare se la visualizzazione non è vuota.

Osservazioni:

Il modo migliore per creare un common_view oggetto consiste nell'usare l'adattatore views::common di intervallo. Gli adattatori di intervallo sono il modo previsto per creare classi di visualizzazione. I tipi di visualizzazione vengono esposti nel caso in cui si voglia creare un tipo di visualizzazione personalizzato.

Questa visualizzazione è utile per passare un intervallo con tipi iteratori/sentinel diversi a un algoritmo legacy che prevede che siano uguali.

Requisiti

Intestazione: <ranges> (da C++20)

Spazio dei nomi: std::ranges

Opzione del compilatore: /std:c++20 o versione successiva è obbligatoria.

Costruttori

Creare un'istanza di un common_view.

1) common_view() = default;
2) constexpr explicit common_view(V v);

Parametri

v
Visualizzazione sottostante.

Per informazioni sul tipo di parametro del modello, vedere Parametri del modello.

Osservazioni:

1) Il valore predefinito costruisce .common_view
2) Costruisce un oggetto common_view dalla vista sottostante usando std::move(v). Un errore genererà se V è un intervallo comune per evitare un uso improprio che influisce negativamente sulle prestazioni.

base

Ottiene una copia della visualizzazione sottostante.

// Uses a copy constructor to return the underlying view
constexpr V base() const& requires std::copy_constructible<V>;

// Uses a move constructor to return the underlying view
constexpr V base() &&;

begin

Ottenere un iteratore al primo elemento.

constexpr auto begin();
constexpr auto begin() const requires range<const V>;

Valore restituito

Iteratore che punta al primo elemento nella visualizzazione:

Immagine di un vettore con gli elementi 10, 20 e 30. Il primo elemento contiene 10 ed è etichettato begin(). L'ultimo elemento contiene 30 e viene etichettato come 'ultimo elemento'. Una casella immaginaria dopo l'ultimo elemento indica la sentinella ed è etichettata end().

end

Ottenere l'sentinel alla fine della visualizzazione.

constexpr auto end();
constexpr auto end() const requires ranges::range<const V>;

Valore restituito

Sentinel che segue l'ultimo elemento nella visualizzazione:

Immagine di un vettore con gli elementi 10, 20 e 30. Il primo elemento contiene 10 ed è etichettato begin(). L'ultimo elemento contiene 30 e viene etichettato come 'ultimo elemento'. Una casella immaginaria dopo l'ultimo elemento indica la sentinella ed è etichettata end().

size

Ottiene il numero di elementi nella visualizzazione.

constexpr auto size() requires ranges::sized_range<V>;
constexpr auto size() const requires ranges::sized_range<const V>;

Parametri

Nessuna.

Valore restituito

Numero di elementi nella visualizzazione.

Vedi anche

<ranges>
common adattatore di intervallo
classi di visualizzazione