IIterator<T> Antarmuka

Referensi

Definisi

Ruang nama:: Windows.Foundation.Collections

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mendukung iterasi sederhana melalui koleksi.

public interface class IIterator

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1786374243, 17152, 17818, 153, 102, 203, 182, 96, 150, 62, 225)]
template <typename T>
struct IIterator

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(1786374243, 17152, 17818, 153, 102, 203, 182, 96, 150, 62, 225)]
public interface IIterator<T>

Public Interface IIterator(Of T)

Jenis parameter

T

Turunan: Windows.ApplicationModel.Resources.Core.ResourceMapIterator

Windows.ApplicationModel.Resources.Core.ResourceMapMapViewIterator

Windows.Media.Protection.PlayReady.PlayReadyDomainIterator

Windows.Media.Protection.PlayReady.PlayReadyLicenseIterator

Windows.Media.Protection.PlayReady.PlayReadySecureStopIterator

Atribut: ContractVersionAttribute GuidAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (diperkenalkan dalam v1.0)

Keterangan

Antarmuka IIterator<T> tidak secara eksplisit disembunyikan oleh proyeksi bahasa untuk .NET, tetapi antarmuka IIterable\<T\> disembunyikan. Untuk sebagian besar skenario .NET yang secara khusus memerlukan API untuk objek iterator, Anda mungkin akan menggunakan IEnumerator<T> (mungkin dengan batasan jenis tertentu) seperti yang diperoleh dari memanggil IEnumerable<T>. GetEnumerator.

Jika perubahan dilakukan pada koleksi, seperti menambahkan, memodifikasi, atau menghapus elemen, iterator diizinkan untuk menaikkan pengecualian untuk semua operasi.

Fungsi ekstensi C++/WinRT

Catatan

Fungsi ekstensi ada pada jenis proyeksi C++/WinRT untuk API Windows Runtime tertentu. Misalnya, winrt::Windows::Foundation::IAsyncAction adalah jenis proyeksi C++/WinRT untuk IAsyncAction. Fungsi ekstensi bukan bagian dari permukaan antarmuka biner aplikasi (ABI) dari jenis Windows Runtime yang sebenarnya, sehingga tidak terdaftar sebagai anggota API Windows Runtime. Tetapi Anda dapat memanggilnya dari dalam proyek C++/WinRT apa pun. Lihat fungsi C++/WinRT yang memperluas WINDOWS Runtime API.

operator++();
operator++(int);

Operator ini mengizinkan perulangan rentang-untuk melalui objek yang dapat diulang Windows Runtime. Operator awalan dan pascafiks ++ memajukan iterator, dan mengaturnya ke nullptr jika iterator telah selesai.

T operator*() const;

Dereferensi iterator setara dengan memanggil Saat Ini.

using iterator_concept= std::input_iterator_tag;
using iterator_catetory = std::input_iterator_tag;
using value_type = T;
using difference_type = ptrdiff_t;
using pointer = void;
using reference = T;

Jenis berlapis yang meningkatkan interoperabilitas dengan iterator C++.

Properti

Current	Mendapatkan item saat ini dalam koleksi.
HasCurrent	Mendapatkan nilai yang menunjukkan apakah iterator merujuk ke item saat ini atau berada di akhir koleksi.

Metode

GetMany(T[])

Mengambil beberapa item dari iterator.

C++/WinRT Sintaks yang benar untuk proyeksi bahasa C++/WinRT adalah uint32_t GetMany(winrt::array_view<T> items);.

MoveNext()

Memajukan iterator ke item berikutnya dalam koleksi.

Berlaku untuk

Lihat juga

IIterable<T>