single_view classe (libreria standard C++)

Visualizzazione con un solo elemento. Questa visualizzazione è utile a scopo di test per chiamare il codice che deve essere fornito con una visualizzazione con almeno un elemento in esso contenuto.

Sintassi

template<std::copy_constructible T>
  requires std::is_object_v<T>
class single_view : public ranges::view_interface<single_view<T>>

Parametri del modello

T
Tipo dell'elemento.

Visualizzare le caratteristiche

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

Caratteristica	Descrizione
Adattatore di intervallo	views::single
Intervallo sottostante	None
Tipo di elemento	Specificato al momento della creazione dell'oggetto single_view
Visualizzare la categoria iteratore	contiguous_range
Dimensioni	Restituisce sempre 1
Iterabile const	Sì
Intervallo comune	Sì
Intervallo preso in prestito	No

Membri

Funzioni membro	Descrizione
Costruttori C++20	Creare un oggetto single_view.
beginC++20	Ottenere un iteratore all'elemento .
dataC++20	Ottenere un puntatore all'elemento .
endC++20	Ottenere l'sentinel alla fine della visualizzazione.
sizeC++20	Ottiene il numero di elementi. Restituisce sempre 1.
Ereditato da view_interface	Descrizione
backC++20	Ottenere l'elemento .
emptyC++20	Verificare se la vista è vuota (restituisce falsesempre ).
frontC++20	Ottenere l'elemento .
operator[]C++20	Ottiene l'elemento nella posizione specificata (solo la posizione 0 è valida).
operator boolC++20	Verificare se la vista non è vuota (restituisce falsesempre ).

Osservazioni:

Il modo migliore per creare un single_view oggetto consiste nell'usare l'adattatore views::single 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.

Il valore in single_view può essere modificato a meno che il valore del modello non sia const. Ad esempio: single_view<const float> sv{3.14} // this value can't be modified because it's const.

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 single_view.

1) single_view() = default;
2) constexpr explicit single_view(const T& t);
3) constexpr explicit single_view(T&& t);
4) template<class... Args>
        requires constructible_from<T, Args...>
    constexpr single_view(in_place_t, Args&&... args);

Parametri

t
Valore dell'elemento.

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

Osservazioni:

Il modo migliore per creare un single_view oggetto consiste nell'usare l'adattatore views::single di intervallo.

1) Creare un single_view oggetto con un singolo elemento del tipo specificato costruito per impostazione predefinita. Ad esempio, single_view<float> sv{} crea un single_view oggetto con un singolo elemento di tipo float costruito per impostazione predefinita su 0.0.
2) Creare un single_view oggetto con un singolo elemento del tipo specificato che viene copiato dall'argomento specificato. Ad esempio, single_view<myObjectType> sv{myObject} crea un single_view oggetto con un singolo elemento di tipo myObjectType copiato dall'argomento .
3) Creare un single_view oggetto con un singolo elemento del tipo specificato inizializzato dall'argomento .
4) Creare un single_view oggetto con un singolo elemento del tipo specificato inizializzato con (std::forward<Args>(args)...).

Esempiosingle_view

/// requires /std:c++20 or higher
#include <ranges>
#include <iostream>
#include <string>
#include <tuple>

int main()
{
    std::ranges::single_view<int> sv{7};
    std::cout << sv.front() << " " << *sv.data() << "\n"; // 7 7

    std::ranges::single_view<std::tuple<int, std::string>> sv2{{6502, "8-bit"}};
    std::cout << std::get<0>(sv2[0]) << " " << std::get<1>(sv2[0]) << "\n"; // 6502 8-bit
}

7 7
6502 8-bit

begin

Ottenere un puntatore al singolo elemento nella visualizzazione.

constexpr T* begin() noexcept;
constexpr const T* begin() const noexcept;

Parametri

Nessuna.

Valore restituito

Puntatore al singolo elemento all'interno di single_view.

data

Ottenere un puntatore al singolo elemento nell'oggetto single_view.

constexpr T* data() noexcept;
constexpr const T* data() const noexcept;

Parametri

Nessuna.

Valore restituito

Puntatore all'elemento nell'oggetto single_view.

end

Ottiene un puntatore alla sentinella dopo l'elemento .

constexpr T* end() noexcept;
constexpr const T* end() const noexcept;

Parametri

Nessuna.

Valore restituito

Puntatore alla sentinella che segue l'elemento .

size

Ottiene il numero di elementi nella visualizzazione. Restituisce sempre 1.

static constexpr size_t size() noexcept;

Parametri

Nessuna.

Valore restituito

1

Vedi anche

<ranges>
single adattatore di intervallo
empty_view
Visualizzare le classi