Condividi tramite


IIterator<T>.GetMany(T[]) Metodo

Definizione

Recupera più elementi dall'iteratore.

C++/WinRT La sintassi corretta per la proiezione del linguaggio C++/WinRT è uint32_t GetMany(winrt::array_view<T> items);.

public:
 unsigned int GetMany(Platform::Array <T> ^ items);
uint32_t GetMany(winrt::array_view <T> & items);
public uint GetMany(T[] items);
Public Function GetMany (items As T()) As UInteger

Parametri

items
T[]

Matrice che riceve gli elementi recuperati dall'iteratore.

C++/WinRT Oggetto winrt::array_view che riceve gli elementi recuperati dall'iteratore.

Restituisce

UInt32

unsigned int

uint32_t

Numero di elementi recuperati. Questo valore può essere minore delle dimensioni degli elementi se viene raggiunta la fine dell'iteratore.

Commenti

L'iteratore è avanzato in passato agli elementi recuperati.

C++/WinRT Oltre a passare un oggetto winrt::array_view T>, è possibile passare qualsiasi oggetto convertibile in un oggetto winrt::array_view<<T>, ad esempio questi esempi.

  • C++ std::array<T, N>
  • Matrice in stile C di T
  • C++ std::vector<T>
  • { puntatore, lunghezza }, dove puntatore è un puntatore a un buffer di oggetti T e la lunghezza è il numero di voci nel buffer
  • { first, last }, dove first e last rappresentano un intervallo di oggetti T [first, last)

Se la raccolta sottostante è stata modificata, l'iteratore può generare un'eccezione.

.NET Framework Se la raccolta sottostante è stata modificata, l'iteratore può generare un'eccezione COMException con un valore HResult di 0x8000000C (E_CHANGED_STATE).

C++/WinRT Se la raccolta sottostante è stata modificata, l'iteratore può generare un'eccezione hresult_changed_state .

C++/CX Se la raccolta sottostante è stata modificata, l'iteratore può generare un'eccezione ChangedStateException .

Si applica a

Vedi anche