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