DoubleCollection.GetMany(UInt32, Double[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recupera vários elementos em uma única passagem pelo iterador.
public:
virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <double> ^ items) = IVector<double>::GetMany;
uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <double> & items);
public uint GetMany(uint startIndex, double[] items);
function getMany(startIndex, items)
Public Function GetMany (startIndex As UInteger, items As Double()) As UInteger
Parâmetros
- startIndex
-
UInt32
unsigned int
uint32_t
O índice do qual iniciar a recuperação.
- items
-
Double[]
double[]
Fornece o destino do resultado. Dimensione o tamanho inicial da matriz como uma "capacidade" para especificar quantos resultados devem ser recuperados.
Retornos
O número de itens recuperados.
Implementações
1.GetMany(System.UInt32,
0[])
M:Windows.Foundation.Collections.IVector1.GetMany(unsigned int,
0[])
M:Windows.Foundation.Collections.IVector1.GetMany(uint32_t,
0[])
Comentários
O método GetMany opera de forma idêntica como se estivesse chamando e para cada elemento na matriz fornecida. Isso significa que o primeiro elemento retornado pelo método GetMany é o mesmo elemento retornado recuperando a propriedade antes de chamar GetMany. Depois que a chamada GetMany retornar, a propriedade recuperará o elemento após o último elemento retornado pela chamada GetMany ou produzirá um erro se não houver mais elementos nas sequências.
O método GetMany retorna o número real de elementos retornados. Deve ser o mínimo de a) o número de elementos restantes na coleção ou b) o número de elementos solicitados, que é "capacidade". Portanto, sempre que GetMany retorna menos do que o número de elementos solicitados, o final da sequência é atingido. Ele retorna o número de elementos recuperados no parâmetro de saída "real".
Quando o chamador especifica uma capacidade de zero, a posição do iterador é inalterada. Os elementos na matriz após os valores retornados não são alterados.