winrt::array_view struct template (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.
Sintaks
template <typename T>
struct array_view
Parameter templat
typename T Jenis nilai (elemen) yang array_view tampilan, 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 typename T parameter templat. |
| array_view::size_type | Sinonim untuk uint32_t. |
| array_view::reference | 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 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
| Konstruktor | Deskripsi |
|---|---|
| konstruktor array_view::array_view | Menginisialisasi instans baru dari struct array_view sebagai tampilan atas (dan bukan salinan) data input. |
Fungsi anggota
| Fungsi | Deskripsi |
|---|---|
| array_view::at function | Mengembalikan referensi ke elemen pada posisi yang ditentukan dalam objek array_view . |
| array_view::back function | Mengembalikan referensi ke elemen terakhir dalam objek array_view . |
| array_view::begin function | Mengembalikan iterator ke elemen pertama dalam objek array_view . |
| fungsi array_view::cbegin | Mengembalikan 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 . |
| fungsi array_view::crbegin | Mengembalikan 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 . |
| 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::end function | Mengembalikan iterator ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view . |
| array_view::front function | Mengembalikan referensi ke elemen pertama dalam objek array_view . |
| array_view::rbegin function | Mengembalikan iterator terbalik ke salah 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 . |
| fungsi array_view::size | 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 tidak sama) | Mengembalikan nilai yang menunjukkan apakah kedua parameter tidak sama 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> (operator yang lebih besar dari) | Mengembalikan nilai yang menunjukkan apakah parameter pertama lebih besar dari parameter kedua. |
| operator>= (operator yang lebih besar dari atau sama dengan) | 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 for 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 dari struct array_view sebagai tampilan atas (dan bukan salinan) data input.
Sintaks
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 .
arrayValue Nilai std::array yang menginisialisasi objek array_view .
initializerListValue Nilai daftar penginisialisasi yang menginisialisasi objek array_view .
vectorValue Nilai std::vector yang menginisialisasi objek array_view .
firstlast Arahkan 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 .
Sintaks
T& at(uint32_t const pos);
T const& at(uint32_t const pos) const;
Parameter
pos Posisi elemen berbasis nol, atau indeks.
Nilai kembali
Referensi ke elemen pada posisi yang ditentukan dalam objek array_view .
array_view::back function
Mengembalikan referensi ke elemen terakhir dalam objek array_view .
Sintaks
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.
Sintaks
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 .
array_view::cbegin (Fungsi cbegin)
Mengembalikan iterator const ke elemen pertama dalam objek array_view . Lihat Iterator.
Sintaks
stdext::checked_array_iterator<T const> cbegin() const noexcept;
Mengembalikan nilai
Iterator const ke elemen pertama dalam objek array_view .
array_view::cend (Fungsi array_view::cend)
Mengembalikan iterator const ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view . Lihat Iterator.
Sintaks
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 iterator balik const ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view .
Sintaks
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 .
Sintaks
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 .
Sintaks
T const* data() const noexcept;
T* data() noexcept;
Mengembalikan nilai
Penunjuk ke data yang mendasar sedang dilihat oleh objek array_view .
array_view::empty function
Mengembalikan nilai yang menunjukkan apakah objek array_view kosong (adalah tampilan pada elemen nol).
Sintaks
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 salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view . Lihat Iterator.
Sintaks
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::front function
Mengembalikan referensi ke elemen pertama dalam objek array_view .
Sintaks
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 .
Sintaks
T const& operator[](uint32_t const pos) const noexcept;
T& operator[](uint32_t const pos) noexcept;
Parameter
pos Posisi elemen berbasis nol, atau indeks.
Nilai kembali
Referensi ke elemen pada posisi yang ditentukan dalam objek array_view .
fungsi array_view::rbegin
Mengembalikan iterator terbalik ke salah satu di luar akhir (satu di luar elemen terakhir di) objek array_view .
Sintaks
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::rend function
Mengembalikan iterator terbalik ke elemen pertama dalam objek array_view .
Sintaks
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 dalam objek array_view .
fungsi array_view::size
Mengembalikan jumlah elemen dalam objek array_view .
Sintaks
uint32_t size() const noexcept;
Mengembalikan nilai
yang uint32_t berisi jumlah elemen dalam objek array_view .
operator!= (operator ketidaksamaan)
Mengembalikan nilai yang menunjukkan apakah kedua parameter tidak sama satu sama lain.
Sintaks
template <typename T> bool operator!=(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;
Parameter
leftright Nilai array_view untuk dibandingkan dengan parameter lainnya.
Nilai kembali
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.
Sintaks
template <typename T> bool operator<(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;
Parameter
leftright 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.
Sintaks
template <typename T> bool operator<=(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;
Parameter
leftright Nilai array_view untuk dibandingkan dengan parameter lainnya.
Menampilkan 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.
Sintaks
template <typename T> bool operator==(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;
Parameter
leftright Nilai array_view untuk dibandingkan dengan parameter lainnya.
Mengembalikan nilai
true jika kedua parameter sama satu sama lain, jika tidak false.
operator> (operator yang lebih besar dari)
Mengembalikan nilai yang menunjukkan apakah parameter pertama lebih besar dari parameter kedua.
Sintaks
template <typename T> bool operator>(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;
Parameter
leftright Nilai array_view untuk dibandingkan dengan parameter lainnya.
Nilai kembali
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.
Sintaks
template <typename T> bool operator>=(winrt::array_view<T> const& left, winrt::array_view<T> const& right) noexcept;
Parameter
leftright 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
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk