Modello di struct winrt::vector_base (C++/WinRT)
Classe di base da cui è possibile derivare per implementare una raccolta personalizzata non osservabile per utilizzo generico. Per altre info ed esempi di codice, vedi Raccolte con C++/WinRT.
template <typename D, typename T>
struct vector_base : vector_view_base<D, T, winrt::impl::collection_version>
typename D
Nome del tipo derivato.
typename T
Tipo degli elementi nel vector_base.
SDK minimo supportato: Windows SDK versione 10.0.17763.0 (Windows 10, versione 1809)
Spazio dei nomi: winrt
Intestazione: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (incluso per impostazione predefinita)
Funzione | Descrizione |
---|---|
funzione vector_base::Append | Aggiunge un elemento alla fine dell'oggetto vector_base . |
funzione vector_base::Clear | Rimuove tutti gli elementi dall'oggetto vector_base . |
funzione vector_base::First | Recupera un IIterator che rappresenta il primo elemento dell'oggetto vector_base . |
funzione vector_base::GetAt | Recupera l'elemento in corrispondenza dell'indice specificato nell'oggetto vector_base . |
funzione vector_base::GetMany | Recupera una raccolta di elementi nell'oggetto vector_base a partire dall'indice specificato. |
funzione vector_base::GetView | Recupera una visualizzazione non modificabile dell'oggetto vector_base . |
funzione vector_base::IndexOf | Recupera l'indice di un elemento specificato nell'oggetto vector_base . |
funzione vector_base::InsertAt | Inserisce un elemento in corrispondenza dell'indice specificato nell'oggetto vector_base . |
funzione vector_base::RemoveAt | Rimuove l'elemento in corrispondenza dell'indice specificato nell'oggetto vector_base . |
funzione vector_base::RemoveAtEnd | Rimuove l'ultimo elemento dall'oggetto vector_base . |
funzione vector_base::ReplaceAll | Sostituisce tutti gli elementi dell'oggetto vector_base con gli elementi specificati. |
funzione vector_base::SetAt | Imposta il valore dell'elemento in corrispondenza dell'indice specificato nell'oggetto vector_base . |
funzione vector_base::Size | Recupera il numero di elementi nell'oggetto vector_base . |
Un vector_base è un intervallo e tale intervallo è definito da funzioni libere interne (ognuna delle quali recupera un iteratore) compatibili con le funzionalità del linguaggio standard. Per questo motivo, è possibile enumerare gli elementi in un oggetto vector_base con un'istruzione basata su for
intervallo.
È anche possibile recuperare un IIterator dalla funzione vector_base::First e usarlo per scorrere gli elementi in un oggetto vector_base .
...
#include <iostream>
using namespace winrt;
using namespace Windows::Foundation::Collections;
...
struct MyVector :
implements<MyVector, IVector<float>, IVectorView<float>, IIterable<float>>,
winrt::vector_base<MyVector, float>
{
auto& get_container() const noexcept
{
return m_values;
}
auto& get_container() noexcept
{
return m_values;
}
private:
std::vector<float> m_values{ 0.1f, 0.2f, 0.3f };
};
...
IVector<float> coll{ winrt::make<MyVector>() };
for (auto const& el : coll)
{
std::wcout << el << std::endl;
}
IIterator<float> it{ coll.First() };
while (it.HasCurrent())
{
std::wcout << it.Current() << std::endl;
it.MoveNext();
}
Aggiunge un elemento alla fine dell'oggetto vector_base .
void Append(T const& value);
value
Elemento da accodare.
Rimuove tutti gli elementi dall'oggetto vector_base .
void Clear() noexcept;
Recupera un IIterator che rappresenta il primo elemento dell'oggetto vector_base .
auto First();
IIterator che rappresenta il primo elemento dell'oggetto vector_base.
Recupera l'elemento in corrispondenza dell'indice specificato nell'oggetto vector_base .
T GetAt(uint32_t const index) const;
index
Indice di elementi in base zero.
Elemento in corrispondenza dell'indice specificato nell'oggetto vector_base .
Recupera una raccolta di elementi nell'oggetto vector_base a partire dall'indice specificato.
uint32_t GetMany(uint32_t const startIndex, array_view<T> values) const;
startIndex
Indice dell'elemento in base zero da iniziare in corrispondenza di .
values
Un array_view in cui copiare gli elementi.
Valore che rappresenta il numero di elementi recuperati.
Recupera una visualizzazione non modificabile dell'oggetto vector_base .
winrt::Windows::Foundation::Collections::IVectorView<T> GetView() const noexcept;
Oggetto IVectorView contenente una visualizzazione non modificabile del vector_base.
Recupera l'indice di un elemento specificato nell'oggetto vector_base .
bool IndexOf(T const& value, uint32_t& index) const noexcept;
value
Elemento, nell'oggetto vector_base , da cercare.
index
Indice in base zero dell'elemento se viene trovato l'elemento; in caso contrario, il numero di elementi nell'oggetto vector_base .
true
se l'elemento viene trovato; in caso contrario false
, .
Inserisce un elemento in corrispondenza dell'indice specificato nell'oggetto vector_base .
void InsertAt(uint32_t const index, T const& value);
index
Indice in base zero in corrispondenza del quale inserire l'elemento.
value
Elemento da inserire.
Rimuove l'elemento in corrispondenza dell'indice specificato nell'oggetto vector_base .
void RemoveAt(uint32_t const index);
index
Indice in base zero dell'elemento da rimuovere.
Rimuove l'ultimo elemento dall'oggetto vector_base .
void RemoveAtEnd();
Sostituisce tutti gli elementi nell'oggetto vector_base con gli elementi specificati.
void ReplaceAll(array_view<T const> value);
value
Array_view contenente i nuovi elementi.
Imposta il valore dell'elemento in corrispondenza dell'indice specificato nell'oggetto vector_base .
void SetAt(uint32_t const index, T const& value);
index
Indice in base zero dell'elemento il cui valore da impostare.
value
Valore dell'elemento da impostare.
Recupera il numero di elementi nell'oggetto vector_base .
uint32_t Size() const noexcept;
Valore che rappresenta il numero di elementi nell'oggetto vector_base .