Freigeben über


winrt::array_view Strukturvorlage (C++/WinRT)

Eine Ansicht oder Spannweite einer zusammenhängenden Reihe von Werten. Weitere Beispiele und Informationen zu winrt::array_viewfinden Sie unter Standard-C++-Datentypen und C++/WinRT-.

Syntax

template <typename T>
struct array_view

Vorlagenparameter

typename T Der Typ der Werte (Elemente), die die array_view ansichten oder überspannen.

Anforderungen

Mindestens unterstützte SDK: Windows SDK, Version 10.0.17134.0 (Windows 10, Version 1803)

Namespace: winrt

Header: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (standardmäßig enthalten)

Membertypaliasen

Aliasname Art
array_view::value_type Ein Synonym für den typename T Vorlagenparameter.
array_view::size_type Ein Synonym für uint32_t.
array_view::reference Ein Synonym für array_view::value_type&.
array_view::const_reference Ein Synonym für array_view::value_type const&.
array_view::p ointer Ein Synonym für array_view::value_type*.
array_view::const_pointer Ein Synonym für array_view::value_type const*.
array_view::iterator Ein Synonym für ein implementierungsdefiniertes Array-Iterator von array_view::value_type.
array_view::const_iterator Ein Synonym für ein implementierungsdefiniertes Array-Iterator von array_view::value_type const.
array_view::reverse_iterator Ein Synonym für std::reverse_iterator<array_view::iterator>.
array_view::const_reverse_iterator Ein Synonym für std::reverse_iterator<array_view::const_iterator>.

Erbauer

Konstruktor Beschreibung
array_view::array_view-Konstruktor Initialisiert eine neue Instanz der array_view Struktur als Ansicht über die Eingabedaten (und keine Kopie von).

Memberfunktionen

Funktion Beschreibung
array_view::at-Funktion Gibt einen Verweis auf das Element an der angegebenen Position innerhalb des array_view -Objekts zurück.
array_view::Back-Funktion Gibt einen Verweis auf das letzte Element im array_view -Objekt zurück.
array_view::begin-Funktion Gibt einen Iterator an das erste Element im array_view -Objekt zurück.
array_view::cbegin-Funktion Gibt einen Konst iterator an das erste Element im array_view -Objekt zurück.
array_view::cend-Funktion Gibt einen Konst iterator bis zum Ende des (eines über das letzte Element in) des array_view Objekts hinaus zurück.
array_view::crbegin-Funktion Gibt einen umgekehrten Iterator auf eins zurück, der über das Ende (eines über das letzte Element hinaus) des array_view-Objekts hinausgeht.
array_view::crend function Gibt einen umgekehrten Iterator zum ersten Element im array_view -Objekt zurück.
array_view::d ata-Funktion Gibt einen Zeiger auf die zugrunde liegenden Daten zurück, die vom array_view -Objekt angezeigt werden.
array_view::empty-Funktion Gibt einen Wert zurück, der angibt, ob das array_view -Objekt leer ist (eine Ansicht für Nullelemente).
array_view::End-Funktion Gibt einen Iterator über das Ende (eines über das letzte Element hinaus) des array_view -Objekts zurück.
array_view::Front-Funktion Gibt einen Verweis auf das erste Element im array_view -Objekt zurück.
array_view::rbegin-Funktion Gibt einen umgekehrten Iterator bis zum Ende des (eines über das letzte Element in) des array_view -Objekts hinaus zurück.
array_view::rend-Funktion Gibt einen umgekehrten Iterator an das erste Element im array_view -Objekt zurück.
array_view::Size-Funktion Gibt die Anzahl der Elemente im array_view-Objekt zurück.

Memberoperatoren

Operator Beschreibung
array_view::operator[] (tiefgestellter Operator) Gibt einen Verweis auf das Element an der angegebenen Position innerhalb des array_view -Objekts zurück.

Kostenlose Betreiber

Operator Beschreibung
Operator!= (Ungleichheitsoperator) Gibt einen Wert zurück, der angibt, ob die beiden Parameter ungleich zueinander sind.
Operator< (kleiner als Operator) Gibt einen Wert zurück, der angibt, ob der erste Parameter kleiner als der zweite Parameter ist.
Operator<= (kleiner-als-oder-gleich-operator) Gibt einen Wert zurück, der angibt, ob der erste Parameter kleiner oder gleich dem zweiten Parameter ist.
Operator== (Gleichheitsoperator) Gibt einen Wert zurück, der angibt, ob die beiden Parameter gleicheinander sind.
Operator> (Größer-als-Operator) Gibt einen Wert zurück, der angibt, ob der erste Parameter größer als der zweite Parameter ist.
Operator>= (größer-oder-gleich-operator) Gibt einen Wert zurück, der angibt, ob der erste Parameter größer oder gleich dem zweiten Parameter ist.

Iteratoren

Ein array_view ist ein Bereich, und dieser Bereich wird durch die funktionen array_view::begin und array_view::end Member definiert, die jeweils einen Iterator zurückgeben (siehe auch array_view::cbegin und array_view::cend). Aus diesem Grund können Sie die Zeichen in einem array_view-Objekt entweder mit einer bereichsbasierten for-Anweisung oder mit der std::for_each-Vorlagenfunktion aufzählen.

#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 << " "; });
}

array_view::array_view-Konstruktor

Initialisiert eine neue Instanz der array_view Struktur als Ansicht über die Eingabedaten (und keine Kopie von).

Syntax

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;

Vorlagenparameter

typename C Der Typ der Werte (Elemente) in den Eingabedaten.

uint32_t N Die Anzahl der Werte (Elemente) in den Eingabedaten.

Parameter

rawArrayValue Ein unformatierter Arraywert, der das array_view-Objekt initialisiert.

arrayValue A std::array Wert, der das array_view-Objekt initialisiert.

initializerListValue Einen Initialisierungslistenwert, der das array_view-Objekt initialisiert.

vectorValue A std::vector Wert, der das array_view-Objekt initialisiert.

first last Zeiger auf Werte, mit denen das array_view-Objekt initialisiert werden soll. Wenn firstlastentspricht, ist das array_view-Objekt leer.

Beispiel

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

Gibt einen Verweis auf das Element an der angegebenen Position innerhalb des array_view -Objekts zurück.

Syntax

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

Parameter

pos Eine nullbasierte Elementposition oder ein Index.

Rückgabewert

Ein Verweis auf das Element an der angegebenen Position innerhalb des array_view-Objekts.

array_view::Back-Funktion

Gibt einen Verweis auf das letzte Element im array_view -Objekt zurück.

Syntax

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

Rückgabewert

Ein Verweis auf das letzte Element im array_view-Objekt.

array_view::begin-Funktion

Gibt einen Iterator an das erste Element im array_view -Objekt zurück. Siehe Iteratoren.

Syntax

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

Rückgabewert

Ein Iterator für das erste Element im array_view-Objekt.

array_view::cbegin-Funktion

Gibt einen Konst iterator an das erste Element im array_view -Objekt zurück. Siehe Iteratoren.

Syntax

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

Rückgabewert

Ein Konerator für das erste Element im array_view-Objekt.

array_view::cend-Funktion

Gibt einen Konst iterator bis zum Ende des (eines über das letzte Element in) des array_view Objekts hinaus zurück. Siehe Iteratoren.

Syntax

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

Rückgabewert

Ein Konserator auf eins über das Ende des (eines jenseits des letzten Elements in) des array_view Objekts hinaus.

array_view::crbegin-Funktion

Gibt einen umgekehrten Iterator auf eins zurück, der über das Ende (eines über das letzte Element hinaus) des array_view-Objekts hinausgeht.

Syntax

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

Rückgabewert

Ein konst reverse iterator to one beyond the end of (one beyond the last element in) the array_view object.

array_view::crend-Funktion

Gibt einen umgekehrten Iterator zum ersten Element im array_view -Objekt zurück.

Syntax

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

Rückgabewert

Ein umgekehrter Iterator zum ersten Element im array_view-Objekt.

array_view::d ata-Funktion

Gibt einen Zeiger auf die zugrunde liegenden Daten zurück, die vom array_view -Objekt angezeigt werden.

Syntax

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

Rückgabewert

Ein Zeiger auf die zugrunde liegenden Daten, die vom array_view-Objekt angezeigt werden.

array_view::empty-Funktion

Gibt einen Wert zurück, der angibt, ob das array_view -Objekt leer ist (eine Ansicht für Nullelemente).

Syntax

bool empty() const noexcept;

Rückgabewert

true, wenn das array_view-Objekt leer ist (eine Ansicht auf Nullelementen), andernfalls false.

array_view::end-Funktion

Gibt einen Iterator über das Ende (eines über das letzte Element hinaus) des array_view -Objekts zurück. Siehe Iteratoren.

Syntax

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

Rückgabewert

Ein Iterator bis zum Ende von (eins über das letzte Element in) des array_view Objekts hinaus.

array_view::Front-Funktion

Gibt einen Verweis auf das erste Element im array_view -Objekt zurück.

Syntax

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

Rückgabewert

Ein Verweis auf das erste Element im array_view-Objekt.

array_view::operator[] (tiefgestellter Operator)

Gibt einen Verweis auf das Element an der angegebenen Position innerhalb des array_view -Objekts zurück.

Syntax

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

Parameter

pos Eine nullbasierte Elementposition oder ein Index.

Rückgabewert

Ein Verweis auf das Element an der angegebenen Position innerhalb des array_view-Objekts.

array_view::rbegin-Funktion

Gibt einen umgekehrten Iterator bis zum Ende des (eines über das letzte Element in) des array_view -Objekts hinaus zurück.

Syntax

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

Rückgabewert

Ein Umgekehrter Iterator zu einem über das Ende (eines über das letzte Element in) des array_view Objekts hinaus.

array_view::rend-Funktion

Gibt einen umgekehrten Iterator an das erste Element im array_view -Objekt zurück.

Syntax

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

Rückgabewert

Ein Umgekehrter Iterator zum ersten Element im array_view-Objekt.

array_view::size-Funktion

Gibt die Anzahl der Elemente im array_view-Objekt zurück.

Syntax

uint32_t size() const noexcept;

Rückgabewert

Eine uint32_t, die die Anzahl der Elemente im array_view-Objekt enthält.

operator!= (Ungleichheitsoperator)

Gibt einen Wert zurück, der angibt, ob die beiden Parameter ungleich zueinander sind.

Syntax

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

Parameter

left right Ein array_view Wert, der mit dem anderen Parameter verglichen werden soll.

Rückgabewert

true, wenn die beiden Parameter ungleich zueinander sind, andernfalls false.

Operator< (Kleiner-als-Operator)

Gibt einen Wert zurück, der angibt, ob der erste Parameter kleiner als der zweite Parameter ist.

Syntax

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

Parameter

left right Ein array_view Wert, der mit dem anderen Parameter verglichen werden soll.

Rückgabewert

true, wenn der erste Parameter kleiner als der zweite Parameter ist, andernfalls false.

operator<= (kleiner-als-oder-gleich-operator)

Gibt einen Wert zurück, der angibt, ob der erste Parameter kleiner oder gleich dem zweiten Parameter ist.

Syntax

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

Parameter

left right Ein array_view Wert, der mit dem anderen Parameter verglichen werden soll.

Rückgabewert

true, wenn der erste Parameter kleiner oder gleich dem zweiten Parameter ist, andernfalls false.

operator== (Gleichheitsoperator)

Gibt einen Wert zurück, der angibt, ob die beiden Parameter gleicheinander sind.

Syntax

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

Parameter

left right Ein array_view Wert, der mit dem anderen Parameter verglichen werden soll.

Rückgabewert

true, wenn die beiden Parameter gleicheinander sind, andernfalls false.

operator> (größer-als-Operator)

Gibt einen Wert zurück, der angibt, ob der erste Parameter größer als der zweite Parameter ist.

Syntax

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

Parameter

left right Ein array_view Wert, der mit dem anderen Parameter verglichen werden soll.

Rückgabewert

true, wenn der erste Parameter größer als der zweite Parameter ist, andernfalls false.

Operator>= (operator größer als oder gleich)

Gibt einen Wert zurück, der angibt, ob der erste Parameter größer oder gleich dem zweiten Parameter ist.

Syntax

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

Parameter

left right Ein array_view Wert, der mit dem anderen Parameter verglichen werden soll.

Rückgabewert

true, wenn der erste Parameter größer oder gleich dem zweiten Parameter ist, andernfalls false.

Siehe auch