IIterator<T>.GetMany(T[]) メソッド

  • リファレンス

定義

名前空間:
Windows.Foundation.Collections
編集

反復子から複数の項目を取得します。

C++/WinRT 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

パラメーター

items
T[]

反復子から取得した項目を受け取る配列。

C++/WinRT 反復子から取得した項目を受け取る winrt::array_view 。

戻り値

UInt32

unsigned int

uint32_t

取得された項目の数。 反復子の末尾に達した場合、この値は 項目 のサイズより小さくすることができます。

注釈

反復子は、取得された項目を超えて高度です。

C++/WinRTwinrt::array_view<T> を渡すだけでなく、次の例のように、winrt::array_view<T> に変換可能な任意のオブジェクトを渡すことができます。

  • C++ std::array<T, N>
  • T の C スタイル配列
  • C++ std::vector<T>
  • { pointer, length }, where pointer is a buffer of T objects, and length is the number of entries in the buffer
  • { first, last }, where first and last represent a range of T objects [first, last)

基になるコレクションが変更された場合、反復子は例外をスローする可能性があります。

.NET Framework 基になるコレクションが変更された場合、反復子は HResult 0x8000000C が (E_CHANGED_STATE) の例外をスローCOMExceptionする可能性があります。

C++/WinRT 基になるコレクションが変更された場合、反復子は例外を hresult_changed_state スローする可能性があります。

C++/CX 基になるコレクションが変更された場合、反復子は例外を ChangedStateException スローする可能性があります。

適用対象

こちらもご覧ください