Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 first
last
entspricht, 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
.