IIterator<T>.GetMany(T[]) 方法

定义

从迭代器检索多个项。

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++/WinRT 除了传递 winrt::array_view<T> 之外,还可以传递任何可转换为 winrt::array_view<T> 的对象,例如这些示例。

  • C++ std::array<T、N>
  • C 样式的 T 数组
  • C++ std::vector<T>
  • { pointer, length },其中 指针 是指向 T 对象的缓冲区的指针, length 是缓冲区中的条目数
  • { first, last },其中 firstlast 表示 T 对象的范围 [first, last)

如果基础集合已更改,则迭代器可能会引发异常。

.NET Framework 如果基础集合已更改,迭代器可能会引发COMException异常,HResult 为 0x8000000C (E_CHANGED_STATE) 。

C++/WinRT 如果基础集合已更改,迭代器可能会引发 hresult_changed_state 异常。

C++/CX 如果基础集合已更改,迭代器可能会引发 ChangedStateException 异常。

适用于

另请参阅