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	Sì
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:

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:

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