modèle de struct winrt ::array_view (C++/WinRT)

Article
08/17/2024

Vue, ou étendue, d’une série contiguë de valeurs. Pour plus d’exemples et d’informations sur winrt ::array_view, consultez types de données C++ Standard et C++/WinRT.

Syntaxe

template <typename T>
struct array_view

Paramètres de modèle

typename T Type des valeurs (éléments) que les vues array_view ou s’étendent.

Exigences

Kit de développement logiciel (SDK) minimum pris en charge : SDK Windows version 10.0.17134.0 (Windows 10, version 1803)

Namespace : winrt

en-tête : %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (inclus par défaut)

Alias de type membre

Nom de l’alias	Type
array_view ::value_type	Synonyme du paramètre de modèle `typename T`.
array_view ::size_type	Synonyme de uint32_t.
array_view ::reference	Synonyme de array_view ::value_type&.
array_view ::const_reference	Synonyme de array_view ::value_type const&.
array_view ::p ointer	Synonyme de array_view ::value_type*.
array_view ::const_pointer	Synonyme de array_view ::value_type const*.
array_view ::iterator	Synonyme d’un itérateur de tableau défini par l’implémentation de array_view ::value_type.
array_view ::const_iterator	Synonyme d’itérateur de tableau défini par l’implémentation de array_view ::value_type const.
array_view ::reverse_iterator	Synonyme de std ::reverse_iterator<array_view ::iterator>.
array_view ::const_reverse_iterator	Synonyme de std ::reverse_iterator<array_view ::const_iterator>.

Constructeurs

Constructeur	Description
array_view ::array_view constructeur	Initialise une nouvelle instance du struct array_view en tant qu’affichage (et non une copie) des données d’entrée.

Fonctions membres

Fonction	Description
array_view ::at, fonction	Retourne une référence à l’élément à la position spécifiée dans l’objet array_view.
array_view ::back, fonction	Retourne une référence au dernier élément de l’objet array_view.
array_view ::begin, fonction	Retourne un itérateur au premier élément de l’objet array_view.
array_view ::cbegin, fonction	Retourne un itérateur const au premier élément de l’objet array_view.
array_view ::cend, fonction	Retourne un itérateur const à un au-delà de la fin (un au-delà du dernier élément dans) l’objet array_view.
array_view ::crbegin, fonction	Retourne un itérateur inverse const à un au-delà de la fin de (un au-delà du dernier élément dans) de l’objet array_view.
array_view ::crend, fonction	Retourne un itérateur inverse const au premier élément de l’objet array_view.
fonction array_view ::d ata	Retourne un pointeur vers les données sous-jacentes consultées par l’objet array_view.
array_view ::empty, fonction	Retourne une valeur indiquant si l’objet array_view est vide (est une vue sur zéro élément).
array_view ::end, fonction	Retourne un itérateur à un au-delà de la fin de (un au-delà du dernier élément dans) de l’objet array_view.
array_view ::front, fonction	Retourne une référence au premier élément de l’objet array_view.
array_view ::rbegin, fonction	Retourne un itérateur inverse vers un itérateur au-delà de la fin de (un au-delà du dernier élément dans) de l’objet array_view.
de la fonction array_view :rend	Retourne un itérateur inverse au premier élément de l’objet array_view.
array_view ::size, fonction	Retourne le nombre d’éléments dans l’objet array_view.

Opérateurs membres

Opérateur	Description
array_view ::operator[] (opérateur d’indice)	Retourne une référence à l’élément à la position spécifiée dans l’objet array_view.

Opérateurs gratuits

Opérateur	Description
operator != (opérateur d’inégalité)	Retourne une valeur indiquant si les deux paramètres sont inégaux les uns aux autres.
opérateur< (opérateur inférieur à)	Retourne une valeur indiquant si le premier paramètre est inférieur au deuxième paramètre.
opérateur<= (opérateur inférieur ou égal à)	Retourne une valeur indiquant si le premier paramètre est inférieur ou égal au deuxième paramètre.
operator== (opérateur d’égalité)	Retourne une valeur indiquant si les deux paramètres sont égaux les uns aux autres.
opérateur> (opérateur supérieur à)	Retourne une valeur indiquant si le premier paramètre est supérieur au deuxième paramètre.
opérateur>= (opérateur supérieur ou égal à)	Retourne une valeur indiquant si le premier paramètre est supérieur ou égal au deuxième paramètre.

Itérateurs

Une array_view est une plage et cette plage est définie par les fonctions membres array_view ::begin et array_view ::end membres, chacune qui retourne un itérateur (voir également array_view ::cbegin et array_view ::cend). Pour cette raison, vous pouvez énumérer les caractères d’un objet array_view avec une instruction for basée sur une plage ou avec la fonction de modèle std ::for_each.

#include <iostream>
using namespace winrt;
...
template <typename T>
void Iterators(array_view<T> const& theArrayView)
{
    for (T& element : theArrayView)
    {
        std::wcout << element << " ";
    }

    std::for_each(theArrayView.cbegin(), theArrayView.cend(), [](T const& element) { std::wcout << element << " "; });
}

constructeur array_view ::array_view

Initialise une nouvelle instance du struct array_view en tant qu’affichage (et non une copie) des données d’entrée.

Syntaxe

array_view() noexcept;
template <typename C, uint32_t N> array_view(C(&rawArrayValue)[N]) noexcept;
template <typename C, uint32_t N> array_view(std::array<C, N> const& arrayValue) noexcept;
template <typename C, uint32_t N> array_view(std::array<C, N>& arrayValue) noexcept;
array_view(std::initializer_list<T> initializerListValue) noexcept;
template <typename C> array_view(std::vector<C> const& vectorValue) noexcept;
template <typename C> array_view(std::vector<C>& vectorValue) noexcept;
array_view(T* first, T* last) noexcept;

Paramètres de modèle

typename C Type des valeurs (éléments) dans les données d’entrée.

uint32_t N Nombre de valeurs (éléments) dans les données d’entrée.

Paramètres

rawArrayValue Valeur de tableau brute qui initialise l’objet array_view.

Valeur de std ::array qui initialise l’objet array_view.

initializerListValue Valeur de liste d’initialiseurs qui initialise l’objet array_view.

vectorValue Valeur de std ::vector qui initialise l’objet array_view.

first last pointeurs vers des valeurs avec lesquelles initialiser l’objet array_view. Si first est égal à last, l’objet array_view est vide.

Exemple

using namespace winrt;
...
void Constructors()
{
    // array_view() noexcept
    array_view<byte const> fromDefault{};

    byte theRawArray[]{ 99, 98, 97 };

    // template <typename C, uint32_t N> array_view(C(&value)[N]) noexcept
    array_view<byte const> fromRawArray{ theRawArray };

    const std::array<byte, 3> theConstArray{ 99, 98, 97 };

    // template <typename C, uint32_t N> array_view(std::array<C, N>& value) noexcept
    array_view<byte const> fromConstArray{ theConstArray };

    std::array<byte, 3> theArray{ 99, 98, 97 };

    // template <typename C, uint32_t N> array_view(std::array<C, N> const& value) noexcept
    array_view<byte const> fromArray{ theArray };

    // array_view(std::initializer_list<T> value) noexcept
    array_view<byte const> fromInitializerList{ 99, 98, 97 };

    const std::vector<byte> theConstVector{ 99, 98, 97 };

    // template <typename C> array_view(std::vector<C> const& value) noexcept
    array_view<byte const> fromConstVector{ theConstVector };

    std::vector<byte> theVector{ 99, 98, 97 };

    // template <typename C> array_view(std::vector<C>& value) noexcept
    array_view<byte const> fromVector{ theVector };

    // array_view(T* first, T* last) noexcept
    array_view<byte const> fromRange{ theArray.data(), theArray.data() + 2 }; // just the first two elements.
}

array_view ::at, fonction

Retourne une référence à l’élément à la position spécifiée dans l’objet array_view.

Syntaxe

T& at(uint32_t const pos);
T const& at(uint32_t const pos) const;

Paramètres

pos une position d’élément de base zéro ou un index.

Valeur de retour

Référence à l’élément à la position spécifiée dans l’objet array_view.

array_view ::back, fonction

Retourne une référence au dernier élément de l’objet array_view.

Syntaxe

T const& back() const noexcept;
T& back() noexcept;

Valeur de retour

Référence au dernier élément de l’objet array_view.

array_view ::begin, fonction

Retourne un itérateur au premier élément de l’objet array_view. Consultez itérateurs.

Syntaxe

stdext::checked_array_iterator<T const> begin() const noexcept;
stdext::checked_array_iterator<T> begin() noexcept;

Valeur de retour

Itérateur vers le premier élément de l’objet array_view.

array_view ::cbegin, fonction

Retourne un itérateur const au premier élément de l’objet array_view. Consultez itérateurs.

Syntaxe

stdext::checked_array_iterator<T const> cbegin() const noexcept;

Valeur de retour

Itérateur const au premier élément de l’objet array_view.

array_view ::cend, fonction

Retourne un itérateur const à un au-delà de la fin (un au-delà du dernier élément dans) l’objet array_view. Consultez itérateurs.

Syntaxe

stdext::checked_array_iterator<T const> cend() const noexcept;

Valeur de retour

Itérateur const à un au-delà de la fin de (un au-delà du dernier élément dans) de l’objet array_view.

array_view ::crbegin, fonction

Retourne un itérateur inverse const à un au-delà de la fin de (un au-delà du dernier élément dans) de l’objet array_view.

Syntaxe

std::reverse_iterator<stdext::checked_array_iterator<T const>> crbegin() const noexcept;

Valeur de retour

Itérateur inverse const à un au-delà de la fin (un au-delà du dernier élément dans) de l’objet array_view.

array_view ::crend, fonction

Retourne un itérateur inverse const au premier élément de l’objet array_view.

Syntaxe

std::reverse_iterator<stdext::checked_array_iterator<T const>> crend() const noexcept;

Valeur de retour

Itérateur inverse const au premier élément de l’objet array_view.

fonction array_view ::d ata

Retourne un pointeur vers les données sous-jacentes consultées par l’objet array_view.

Syntaxe

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

Valeur de retour

Pointeur vers les données sous-jacentes consultées par l’objet array_view.

array_view ::empty, fonction

Retourne une valeur indiquant si l’objet array_view est vide (est une vue sur zéro élément).

Syntaxe

bool empty() const noexcept;

Valeur de retour

true si l’objet array_view est vide (est une vue sur aucun élément), sinon false.

array_view ::end, fonction

Retourne un itérateur à un au-delà de la fin de (un au-delà du dernier élément dans) de l’objet array_view. Consultez itérateurs.

Syntaxe

stdext::checked_array_iterator<T const> end() const noexcept;
stdext::checked_array_iterator<T> end() noexcept;

Valeur de retour

Itérateur vers un itérateur au-delà de la fin de (un au-delà du dernier élément dans) de l’objet array_view.

array_view ::front, fonction

Retourne une référence au premier élément de l’objet array_view.

Syntaxe

T const& front() const noexcept;
T& front() noexcept;

Valeur de retour

Référence au premier élément de l’objet array_view.

array_view ::operator[] (opérateur d’indice)

Retourne une référence à l’élément à la position spécifiée dans l’objet array_view.

Syntaxe

T const& operator[](uint32_t const pos) const noexcept;
T& operator[](uint32_t const pos) noexcept;

Paramètres

pos une position d’élément de base zéro ou un index.

Valeur de retour

Référence à l’élément à la position spécifiée dans l’objet array_view.

array_view ::rbegin, fonction

Retourne un itérateur inverse vers un itérateur au-delà de la fin de (un au-delà du dernier élément dans) de l’objet array_view.

Syntaxe

std::reverse_iterator<stdext::checked_array_iterator<T const>> rbegin() const noexcept;
std::reverse_iterator<stdext::checked_array_iterator<T>> rbegin() noexcept;

Valeur de retour

Itérateur inverse vers l’un au-delà de la fin (un au-delà du dernier élément dans) l’objet array_view.

array_view ::rend, fonction

Retourne un itérateur inverse au premier élément de l’objet array_view.

Syntaxe

std::reverse_iterator<stdext::checked_array_iterator<T const>> rend() const noexcept;
std::reverse_iterator<stdext::checked_array_iterator<T>> rend() noexcept;

Valeur de retour

Itérateur inverse au premier élément de l’objet array_view.

array_view ::size, fonction

Retourne le nombre d’éléments dans l’objet array_view.

Syntaxe

uint32_t size() const noexcept;

Valeur de retour

Un uint32_t contenant le nombre d’éléments dans l’objet array_view.

operator != (opérateur d’inégalité)

Retourne une valeur indiquant si les deux paramètres sont inégaux les uns aux autres.

Syntaxe

template <typename T> bool operator!=(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;

Paramètres

left right Valeur de array_view à comparer avec l’autre paramètre.

Valeur de retour

true si les deux paramètres sont inégaux les uns aux autres, sinon false.

opérateur< (opérateur inférieur à)

Retourne une valeur indiquant si le premier paramètre est inférieur au deuxième paramètre.

Syntaxe

template <typename T> bool operator<(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;

Paramètres

left right Valeur de array_view à comparer avec l’autre paramètre.

Valeur de retour

true si le premier paramètre est inférieur au deuxième paramètre, sinon false.

opérateur<= (opérateur inférieur ou égal à)

Retourne une valeur indiquant si le premier paramètre est inférieur ou égal au deuxième paramètre.

Syntaxe

template <typename T> bool operator<=(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;

Paramètres

left right Valeur de array_view à comparer avec l’autre paramètre.

Valeur de retour

true si le premier paramètre est inférieur ou égal au deuxième paramètre, sinon false.

operator== (opérateur d’égalité)

Retourne une valeur indiquant si les deux paramètres sont égaux les uns aux autres.

Syntaxe

template <typename T> bool operator==(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;

Paramètres

left right Valeur de array_view à comparer avec l’autre paramètre.

Valeur de retour

true si les deux paramètres sont égaux les uns aux autres, sinon false.

opérateur> (opérateur supérieur à)

Retourne une valeur indiquant si le premier paramètre est supérieur au deuxième paramètre.

Syntaxe

template <typename T> bool operator>(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;

Paramètres

left right Valeur de array_view à comparer avec l’autre paramètre.

Valeur de retour

true si le premier paramètre est supérieur au deuxième paramètre, sinon false.

opérateur>= (opérateur supérieur ou égal à)

Retourne une valeur indiquant si le premier paramètre est supérieur ou égal au deuxième paramètre.

Syntaxe

template <typename T> bool operator>=(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;

Paramètres

left right Valeur de array_view à comparer avec l’autre paramètre.

Valeur de retour

true si le premier paramètre est supérieur ou égal au deuxième paramètre, sinon false.

Voir aussi

espace de noms winrt

Partager via

modèle de struct winrt ::array_view (C++/WinRT)

Syntaxe

Paramètres de modèle

Exigences

Alias de type membre

Constructeurs

Fonctions membres

Opérateurs membres

Opérateurs gratuits

Itérateurs

constructeur array_view ::array_view

Syntaxe

Paramètres de modèle

Paramètres

Exemple

array_view ::at, fonction

Syntaxe

Paramètres

Valeur de retour

array_view ::back, fonction

Syntaxe

Valeur de retour

array_view ::begin, fonction

Syntaxe

Valeur de retour

array_view ::cbegin, fonction

Syntaxe

Valeur de retour

array_view ::cend, fonction

Syntaxe

Valeur de retour

array_view ::crbegin, fonction

Syntaxe

Valeur de retour

array_view ::crend, fonction

Syntaxe

Valeur de retour

fonction array_view ::d ata

Syntaxe

Valeur de retour

array_view ::empty, fonction

Syntaxe

Valeur de retour

array_view ::end, fonction

Syntaxe

Valeur de retour

array_view ::front, fonction

Syntaxe

Valeur de retour

array_view ::operator[] (opérateur d’indice)

Syntaxe

Paramètres

Valeur de retour

array_view ::rbegin, fonction

Syntaxe

Valeur de retour

array_view ::rend, fonction

Syntaxe

Valeur de retour

array_view ::size, fonction

Syntaxe

Valeur de retour

operator != (opérateur d’inégalité)

Syntaxe

Paramètres

Valeur de retour

opérateur< (opérateur inférieur à)

Syntaxe

Paramètres

Valeur de retour

opérateur<= (opérateur inférieur ou égal à)

Syntaxe

Paramètres

Valeur de retour

operator== (opérateur d’égalité)

Syntaxe

Paramètres

Valeur de retour

opérateur> (opérateur supérieur à)