winrt::array_view templat struct (C++/WinRT)

Artikel
08/17/2024

Tampilan, atau rentang, dari serangkaian nilai yang berdampingan. Untuk contoh dan info selengkapnya tentang winrt::array_view, lihat jenis data C++ Standar dan C++/WinRT.

Sintaksis

template <typename T>
struct array_view

Parameter templat

typename T Jenis nilai (elemen) yang dilihat array_view, atau rentang.

Persyaratan

SDK minimum yang didukung: Windows SDK versi 10.0.17134.0 (Windows 10, versi 1803)

Namespace: winrt

Header : %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (disertakan secara default)

Alias jenis anggota

Nama alias	Jenis
array_view::value_type	Sinonim untuk parameter templat `typename T`.
array_view::size_type	Sinonim untuk uint32_t.
array_view::referensi	Sinonim untuk array_view::value_type&.
array_view::const_reference	Sinonim untuk array_view::value_type const&.
array_view::p ointer	Sinonim untuk array_view::value_type*.
array_view::const_pointer	Sinonim untuk array_view::value_type const*.
array_view::iterator	Sinonim untuk iterator array yang ditentukan implementasi dari array_view::value_type.
array_view::const_iterator	Sinonim untuk iterator array yang ditentukan implementasi dari array_view::value_type const.
array_view::reverse_iterator	Sinonim untuk std::reverse_iterator<array_view::iterator>.
array_view::const_reverse_iterator	Sinonim untuk std::reverse_iterator<array_view::const_iterator>.

Konstruktor

Pembangun	Deskripsi
array_view::array_view konstruktor	Menginisialisasi instans baru struct array_view sebagai tampilan atas (dan bukan salinan) data input.

Fungsi anggota

Fungsi	Deskripsi
array_view::at fungsi	Mengembalikan referensi ke elemen pada posisi yang ditentukan dalam objek array_view.
array_view:: fungsi belakang	Mengembalikan referensi ke elemen terakhir dalam objek array_view.
array_view::mulai fungsi	Mengembalikan iterator ke elemen pertama dalam objek array_view.
array_view:: fungsi cbegin	Mengembalikan iterator const ke elemen pertama dalam objek array_view.
array_view::cend fungsi	Mengembalikan iterator const ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view.
array_view::crbegin fungsi	Mengembalikan const reverse iterator ke satu di luar akhir (satu di luar elemen terakhir di) objek array_view.
array_view::crend function	Mengembalikan iterator balik const ke elemen pertama dalam objek array_view.
fungsi array_view::d ata	Mengembalikan penunjuk ke data yang mendasar yang dilihat oleh objek array_view.
array_view:: fungsi kosong	Mengembalikan nilai yang menunjukkan apakah objek array_view kosong (adalah tampilan pada elemen nol).
array_view:: fungsi akhir	Mengembalikan iterator ke satu di luar akhir (satu di luar elemen terakhir di) objek array_view.
array_view:: fungsi depan	Mengembalikan referensi ke elemen pertama dalam objek array_view.
array_view::rbegin fungsi	Mengembalikan iterator terbalik ke satu di luar akhir (satu di luar elemen terakhir di) objek array_view.
fungsi array_view::rend	Mengembalikan iterator terbalik ke elemen pertama dalam objek array_view.
array_view:: fungsi ukuran	Mengembalikan jumlah elemen dalam objek array_view.

Operator anggota

Operator	Deskripsi
array_view::operator[] (operator subskrip)	Mengembalikan referensi ke elemen pada posisi yang ditentukan dalam objek array_view.

Operator gratis

Operator	Deskripsi
operator!= (operator ketidaksamaan)	Mengembalikan nilai yang menunjukkan apakah kedua parameter tidak setara satu sama lain.
< operator (operator kurang dari)	Mengembalikan nilai yang menunjukkan apakah parameter pertama kurang dari parameter kedua.
<operator = (operator kurang dari atau sama dengan)	Mengembalikan nilai yang menunjukkan apakah parameter pertama kurang dari atau sama dengan parameter kedua.
operator== (operator kesetaraan)	Mengembalikan nilai yang menunjukkan apakah kedua parameter sama dengan satu sama lain.
operator (lebih besar dari operator)	Mengembalikan nilai yang menunjukkan apakah parameter pertama lebih besar dari parameter kedua.
operator>= (operator yang lebih besar dari atau sama dengan operator)	Mengembalikan nilai yang menunjukkan apakah parameter pertama lebih besar dari atau sama dengan parameter kedua.

Iterator

array_view adalah rentang, dan rentang tersebut ditentukan oleh fungsi anggota array_view::begin dan array_view::end, yang masing-masing mengembalikan iterator (lihat juga array_view::cbegin dan array_view::cend). Karena itu, Anda dapat menghitung karakter dalam objek array_view dengan pernyataan berbasis rentang, atau dengan fungsi templat 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 << " "; });
}

konstruktor array_view::array_view

Menginisialisasi instans baru struct array_view sebagai tampilan atas (dan bukan salinan) data input.

Sintaksis

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;

Parameter templat

typename C Jenis nilai (elemen) dalam data input.

uint32_t N Jumlah nilai (elemen) dalam data input.

Parameter

rawArrayValue Nilai array mentah yang menginisialisasi objek array_view.

nilai std::array yang menginisialisasi objek array_view.

initializerListValue Nilai daftar inisialisasi yang menginisialisasi objek array_view.

nilai std::vektor yang menginisialisasi objek array_view.

first last Pointer ke nilai untuk menginisialisasi objek array_view. Jika first sama dengan last, maka objek array_view kosong.

Contoh

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 function

Mengembalikan referensi ke elemen pada posisi yang ditentukan dalam objek array_view.

Sintaksis

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

Parameter

pos Posisi elemen berbasis nol, atau indeks.

Mengembalikan nilai

Referensi ke elemen pada posisi yang ditentukan dalam objek array_view.

array_view::back function

Mengembalikan referensi ke elemen terakhir dalam objek array_view.

Sintaksis

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

Mengembalikan nilai

Referensi ke elemen terakhir dalam objek array_view.

array_view::begin function

Mengembalikan iterator ke elemen pertama dalam objek array_view. Lihat iterator .

Sintaksis

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

Mengembalikan nilai

Iterator ke elemen pertama dalam objek array_view.

fungsi array_view::cbegin

Mengembalikan iterator const ke elemen pertama dalam objek array_view. Lihat iterator .

Sintaksis

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

Mengembalikan nilai

Iterator const ke elemen pertama dalam objek array_view.

fungsi array_view::cend

Mengembalikan iterator const ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view. Lihat iterator .

Sintaksis

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

Mengembalikan nilai

Iterator const ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view.

fungsi array_view::crbegin

Mengembalikan const reverse iterator ke satu di luar akhir (satu di luar elemen terakhir di) objek array_view.

Sintaksis

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

Mengembalikan nilai

Iterator balik const ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view.

array_view::crend function

Mengembalikan iterator balik const ke elemen pertama dalam objek array_view.

Sintaksis

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

Mengembalikan nilai

Iterator balik const ke elemen pertama dalam objek array_view.

fungsi array_view::d ata

Mengembalikan penunjuk ke data yang mendasar yang dilihat oleh objek array_view.

Sintaksis

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

Mengembalikan nilai

Penunjuk ke data yang mendasar sedang dilihat oleh objek array_view.

array_view::fungsi kosong

Mengembalikan nilai yang menunjukkan apakah objek array_view kosong (adalah tampilan pada elemen nol).

Sintaksis

bool empty() const noexcept;

Mengembalikan nilai

true jika objek array_view kosong (adalah tampilan pada elemen nol), jika tidak, false.

array_view::end function

Mengembalikan iterator ke satu di luar akhir (satu di luar elemen terakhir di) objek array_view. Lihat iterator .

Sintaksis

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

Mengembalikan nilai

Iterator ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view.

array_view::fungsi depan

Mengembalikan referensi ke elemen pertama dalam objek array_view.

Sintaksis

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

Mengembalikan nilai

Referensi ke elemen pertama dalam objek array_view.

array_view::operator[] (operator subskrip)

Mengembalikan referensi ke elemen pada posisi yang ditentukan dalam objek array_view.

Sintaksis

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

Parameter

pos Posisi elemen berbasis nol, atau indeks.

Mengembalikan nilai

Referensi ke elemen pada posisi yang ditentukan dalam objek array_view.

fungsi array_view::rbegin

Mengembalikan iterator terbalik ke satu di luar akhir (satu di luar elemen terakhir di) objek array_view.

Sintaksis

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

Mengembalikan nilai

Iterator terbalik ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view.

array_view::fungsi rend

Mengembalikan iterator terbalik ke elemen pertama dalam objek array_view.

Sintaksis

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

Mengembalikan nilai

Iterator terbalik ke elemen pertama di objek array_view.

array_view::fungsi ukuran

Mengembalikan jumlah elemen dalam objek array_view.

Sintaksis

uint32_t size() const noexcept;

Mengembalikan nilai

uint32_t yang berisi jumlah elemen dalam objek array_view.

operator!= (operator ketidaksamaan)

Mengembalikan nilai yang menunjukkan apakah kedua parameter tidak setara satu sama lain.

Sintaksis

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

Parameter

left right Nilai array_view untuk dibandingkan dengan parameter lainnya.

Mengembalikan nilai

true jika kedua parameter tidak sama satu sama lain, jika tidak, false.

operator< (operator kurang dari)

Mengembalikan nilai yang menunjukkan apakah parameter pertama kurang dari parameter kedua.

Sintaksis

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

Parameter

left right Nilai array_view untuk dibandingkan dengan parameter lainnya.

Mengembalikan nilai

true jika parameter pertama kurang dari parameter kedua, jika tidak, false.

operator<= (operator kurang dari atau sama dengan)

Mengembalikan nilai yang menunjukkan apakah parameter pertama kurang dari atau sama dengan parameter kedua.

Sintaksis

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

Parameter

left right Nilai array_view untuk dibandingkan dengan parameter lainnya.

Mengembalikan nilai

true jika parameter pertama kurang dari atau sama dengan parameter kedua, jika tidak, false.

operator== (operator kesetaraan)

Mengembalikan nilai yang menunjukkan apakah kedua parameter sama dengan satu sama lain.

Sintaksis

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

Parameter

left right Nilai array_view untuk dibandingkan dengan parameter lainnya.

Mengembalikan nilai

true jika kedua parameter sama dengan satu sama lain, jika tidak, false.

operator> (operator yang lebih besar dari)

Mengembalikan nilai yang menunjukkan apakah parameter pertama lebih besar dari parameter kedua.

Sintaksis

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

Parameter

left right Nilai array_view untuk dibandingkan dengan parameter lainnya.

Mengembalikan nilai

true jika parameter pertama lebih besar dari parameter kedua, jika tidak, false.

operator>= (operator yang lebih besar dari atau sama dengan)

Mengembalikan nilai yang menunjukkan apakah parameter pertama lebih besar dari atau sama dengan parameter kedua.

Sintaksis

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

Parameter

left right Nilai array_view untuk dibandingkan dengan parameter lainnya.

Mengembalikan nilai

true jika parameter pertama lebih besar dari atau sama dengan parameter kedua, jika tidak, false.

Lihat juga

namespace winrt

Bagikan melalui

winrt::array_view templat struct (C++/WinRT)

Sintaksis

Parameter templat

Persyaratan

Alias jenis anggota

Konstruktor

Fungsi anggota

Operator anggota

Operator gratis

Iterator

konstruktor array_view::array_view

Sintaksis

Parameter templat

Parameter

Contoh

array_view::at function

Sintaksis

Parameter

Mengembalikan nilai

array_view::back function

Sintaksis

Mengembalikan nilai

array_view::begin function

Sintaksis

Mengembalikan nilai

fungsi array_view::cbegin

Sintaksis

Mengembalikan nilai

fungsi array_view::cend

Sintaksis

Mengembalikan nilai

fungsi array_view::crbegin

Sintaksis

Mengembalikan nilai

array_view::crend function

Sintaksis

Mengembalikan nilai

fungsi array_view::d ata

Sintaksis

Mengembalikan nilai

array_view::fungsi kosong

Sintaksis

Mengembalikan nilai

array_view::end function

Sintaksis

Mengembalikan nilai

array_view::fungsi depan

Sintaksis

Mengembalikan nilai

array_view::operator[] (operator subskrip)

Sintaksis

Parameter

Mengembalikan nilai

fungsi array_view::rbegin

Sintaksis

Mengembalikan nilai

array_view::fungsi rend

Sintaksis

Mengembalikan nilai

array_view::fungsi ukuran

Sintaksis

Mengembalikan nilai

operator!= (operator ketidaksamaan)

Sintaksis

Parameter

Mengembalikan nilai

operator< (operator kurang dari)

Sintaksis

Parameter

Mengembalikan nilai

operator<= (operator kurang dari atau sama dengan)

Sintaksis

Parameter

Mengembalikan nilai

operator== (operator kesetaraan)

Sintaksis

Parameter

Mengembalikan nilai

operator> (operator yang lebih besar dari)