Platform::Collections::Vector Sınıfı
Dizin tarafından tek tek erişilebilen nesnelerin sıralı koleksiyonunu temsil eder. XAML veri bağlamasına yardımcı olmak için Windows::Foundation::Collections::IObservableVector uygular.
Sözdizimi
template <typename T, typename E>
ref class Vector sealed;
Parametreler
T
Vector nesnesinde bulunan öğelerin türü.
E
T türü değerleriyle eşitliği test etme için bir ikili koşul belirtir. Varsayılan değerdirstd::equal_to<T>
.
Açıklamalar
İzin verilen türler şunlardır:
integers
interface class^
public ref class^
değer yapısı
public sabit listesi sınıfı
Vector sınıfı, Windows::Foundation::Collections::IVector arabiriminin C++ somut uygulamasıdır.
Genel dönüş değerinde veya parametresinde Vektör türü kullanmayı denerseniz, derleyici hatası C3986 oluşur. Parametreyi veya dönüş değeri türünü Windows::Foundation::Collections::IVector olarak değiştirerek hatayı düzeltebilirsiniz. Daha fazla bilgi için bkz . Koleksiyonlar (C++/CX).
Üyeler
Ortak Oluşturucular
Veri Akışı Adı | Açıklama |
---|---|
Vektör::Vektör | Vector sınıfının yeni bir örneğini başlatır. |
Genel Yöntemler
Veri Akışı Adı | Açıklama |
---|---|
Vektör::Ekleme | Belirtilen öğeyi geçerli Vektördeki son öğeden sonra ekler. |
Vektör::Temizle | Geçerli Vektördeki tüm öğeleri siler. |
Vektör::First | Vector içindeki ilk öğeyi belirten bir yineleyici döndürür. |
Vektör::GetAt | Belirtilen dizin tarafından identifed geçerli Vector öğesini alır. |
Vektör::GetMany | Belirtilen dizinden başlayarak geçerli Vektörden bir öğe dizisi alır. |
Vektör::GetView | Vektörünün salt okunur görünümünü döndürür; yani Platform ::Collections::VectorView. |
Vector::IndexOf | Geçerli Vektörde belirtilen öğeyi arar ve bulunursa öğenin dizinini döndürür. |
Vector::InsertAt | Belirtilen öğeyi, belirtilen dizin tarafından tanımlanan öğedeki geçerli Vector öğesine ekler. |
Vektör::ReplaceAll | Geçerli Vector içindeki öğeleri siler ve ardından belirtilen dizideki öğeleri ekler. |
Vector::RemoveAt | Belirtilen dizin tarafından tanımlanan öğeyi geçerli Vector öğesinden siler. |
Vector::RemoveAtEnd | Geçerli Vector öğesinin sonundaki öğesini siler. |
Vektör::SetAt | Belirtilen değeri, belirtilen dizin tarafından tanımlanan geçerli Vector öğesine atar. |
Vektör::Boyut | Geçerli Vector nesnesindeki öğe sayısını döndürür. |
Ekinlikler
Veri Akışı Adı | Açıklama |
---|---|
olay Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged | Vektör değiştiğinde gerçekleşir. |
Devralma Hiyerarşisi
Vector
Gereksinimler
Üst bilgi: collection.h
Ad Alanı: Platform::Collections
Vector::Append Yöntemi
Belirtilen öğeyi geçerli Vektördeki son öğeden sonra ekler.
Sözdizimi
virtual void Append(T item);
Parametreler
Dizin
Vektöre eklenecek öğe. Öğenin türü T tür adıyla tanımlanır.
Vector::Clear Yöntemi
Geçerli Vektördeki tüm öğeleri siler.
Sözdizimi
virtual void Clear();
Vector::First Yöntemi
Vector içindeki ilk öğeye işaret eden bir yineleyici döndürür.
Sözdizimi
virtual Windows::Foundation::Collections::IIterator <T>^ First();
Dönüş Değeri
Vector içindeki ilk öğeye işaret eden bir yineleyici.
Açıklamalar
First() tarafından döndürülen yineleyiciyi tutmanın kullanışlı bir yolu, dönüş değerini tür kesinti anahtar sözcüğüyle bildirilen bir değişkene auto
atamaktır. Örneğin, auto x = myVector->First();
. Bu yineleyici koleksiyonun uzunluğunu bilir.
STL işlevine geçirmek için bir çift yineleyiciye ihtiyacınız olduğunda Windows::Foundation::Collections::begin ve Windows::Foundation::Collections::end ücretsiz işlevlerini kullanın
Vector::GetAt Yöntemi
Belirtilen dizin tarafından identifed geçerli Vector öğesini alır.
Sözdizimi
virtual T GetAt(unsigned int index);
Parametreler
Dizin
Vector nesnesindeki belirli bir öğeyi belirten sıfır tabanlı, işaretsiz tamsayı.
Dönüş Değeri
dizin parametresi tarafından belirtilen öğe. Öğe türü T tür adıyla tanımlanır.
Vector::GetMany Yöntemi
Belirtilen dizinden başlayarak geçerli Vector öğesinden bir dizi öğe alır ve bunları çağıran tarafından ayrılan diziye kopyalar.
Sözdizimi
virtual unsigned int GetMany(
unsigned int startIndex,
Platform::WriteOnlyArray<T>^ dest);
Parametreler
startIndex
Alınacak öğelerin başlangıcının sıfır tabanlı dizini.
dest
StartIndex tarafından belirtilen öğede başlayan ve Vector'daki son öğede biten, çağıran tarafından ayrılmış bir öğe dizisi.
Dönüş Değeri
Alınan öğe sayısı.
Açıklamalar
Bu işlev doğrudan istemci kodu tarafından kullanılmak üzere tasarlanmamıştır. Platform::Vector intances öğesinin std::vector örneklerine verimli bir şekilde dönüştürülmesi için to_vector İşlevi'nde dahili olarak kullanılır.
Vector::GetView Yöntemi
Vektörünün salt okunur görünümünü döndürür; yani bir IVectorView.
Sözdizimi
Windows::Foundation::Collections::IVectorView<T>^ GetView();
Dönüş Değeri
Bir IVectorView nesnesi.
Vector::IndexOf Yöntemi
Geçerli Vektörde belirtilen öğeyi arar ve bulunursa öğenin dizinini döndürür.
Sözdizimi
virtual bool IndexOf(T value, unsigned int* index);
Parametreler
value
Bulunacak öğe.
Dizin
Parametre değeri bulunursa öğenin sıfır tabanlı dizini; aksi takdirde 0.
Öğe Vector'un ilk öğesiyse veya öğe bulunamadıysa dizin parametresi 0'dır. Dönüş değeri ise true
, öğe bulundu ve ilk öğedir; aksi takdirde öğe bulunamadı.
Dönüş Değeri
true
belirtilen öğe bulunursa; aksi takdirde , false
.
Açıklamalar
IndexOf, öğeyi bulmak için std::find_if kullanır. Bu nedenle özel öğe türleri, find_if gereken eşitlik karşılaştırmalarını etkinleştirmek için == ve != işlecini aşırı yüklemelidir.
Vector::InsertAt Yöntemi
Belirtilen öğeyi, belirtilen dizin tarafından tanımlanan öğedeki geçerli Vector öğesine ekler.
Sözdizimi
virtual void InsertAt(unsigned int index, T item)
Parametreler
Dizin
Vector nesnesindeki belirli bir öğeyi belirten sıfır tabanlı, işaretsiz tamsayı.
madde
Dizin tarafından belirtilen öğede Vector öğesine eklenecek öğe. Öğenin türü T tür adıyla tanımlanır.
Vector::RemoveAt Yöntemi
Belirtilen dizin tarafından tanımlanan öğeyi geçerli Vector öğesinden siler.
Sözdizimi
virtual void RemoveAt(unsigned int index);
Parametreler
Dizin
Vector nesnesindeki belirli bir öğeyi belirten sıfır tabanlı, işaretsiz tamsayı.
Vector::RemoveAtEnd Yöntemi
Geçerli Vector öğesinin sonundaki öğesini siler.
Sözdizimi
virtual void RemoveAtEnd();
Vector::ReplaceAll Yöntemi
Geçerli Vector içindeki öğeleri siler ve ardından belirtilen dizideki öğeleri ekler.
Sözdizimi
virtual void ReplaceAll(const ::Platform::Array<T>^ arr);
Parametreler
arr
Türü T tür adıyla tanımlanan bir nesne dizisi.
Vector::SetAt Yöntemi
Belirtilen değeri, belirtilen dizin tarafından tanımlanan geçerli Vector öğesine atar.
Sözdizimi
virtual void SetAt(unsigned int index, T item);
Parametreler
Dizin
Vector nesnesindeki belirli bir öğeyi belirten sıfır tabanlı, işaretsiz tamsayı.
madde
Belirtilen öğeye atanacak değer. Öğenin türü T tür adıyla tanımlanır.
Vector::Size Yöntemi
Geçerli Vector nesnesindeki öğe sayısını döndürür.
Sözdizimi
virtual property unsigned int Size;
Dönüş Değeri
Geçerli Vektördeki öğelerin sayısı.
Vector::Vector Oluşturucu
Vector sınıfının yeni bir örneğini başlatır.
Sözdizimi
Vector();
explicit Vector(unsigned int size);
Vector( unsigned int size, T value);
template <typename U> explicit Vector( const ::std::vector<U>& v);
template <typename U> explicit Vector( std::vector<U>&& v);
Vector( const T * ptr, unsigned int size);
template <size_t N> explicit Vector(const T(&arr)[N]);
template <size_t N> explicit Vector(const std::array<T, N>& a);
explicit Vector(const Array<T>^ arr);
template <typename InIt> Vector(InIt first, InIt last);
Vector(std::initializer_list<T> il);
Parametreler
a
Vector'yi başlatmak için kullanılacak bir std::dizisi.
arr
Vektör'leri başlatmak için kullanılacak platform::dizisi.
Init
Geçerli Vector'yi başlatmak için kullanılan nesne koleksiyonunun türü.
ıl
Vector'yi başlatmak için kullanılacak T türündeki nesnelerin std::initializer_list.
N
Geçerli Vector'yi başlatmak için kullanılan bir nesne koleksiyonundaki öğe sayısı.
boyut
Vektördeki öğelerin sayısı.
value
Geçerli Vector içindeki her öğeyi başlatmak için kullanılan değer.
v
Geçerli Vector'yi başlatmak için kullanılan std::vector'a Lvalues ve Rvalues.
ptr
Geçerli Vektör'leri başlatmak için kullanılan bir std::vector
işaretçi.
birinci
Geçerli Vector'yi başlatmak için kullanılan bir nesne dizisinin ilk öğesi. birinci türü mükemmel iletme yoluyla geçirilir. Daha fazla bilgi için bkz . Rvalue Başvuru Bildirimcisi: &.
son
Geçerli Vector'yi başlatmak için kullanılan bir nesne dizisinin son öğesi. Son türü, mükemmel iletme yoluyla geçirilir. Daha fazla bilgi için bkz . Rvalue Başvuru Bildirimcisi: &.
Ayrıca bkz.
Koleksiyonlar (C++/CX)
Platform Ad Alanı
C++ uygulamasında Windows Çalışma Zamanı Bileşenleri Oluşturma