Bagikan melalui


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

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