Classe Platform::WriteOnlyArray

Representa uma matriz unidimensional que é usada como parâmetro de entrada quando o chamador passa uma matriz para o método para preenchimento.

Essa classe ref é declarada como particular em vccorlib.h; portanto, não é emitida nos metadados e é somente consumível em C++. Essa classe é destinada somente para uso como um parâmetro de entrada que recebe uma matriz alocada pelo chamador. Ela não pode ser construída a partir do código do usuário. Ela permite que um método C++ grave diretamente nessa matriz — um padrão que é conhecido como o padrão FillArray . Para obter mais informações, consulte Mtriz e WriteOnlyArray.

Sintaxe

private ref class WriteOnlyArray<T, 1>

Membros

Métodos públicos

Esses métodos têm acessibilidade interna — ou seja, eles são acessíveis apenas dentro do aplicativo ou componente C++.

Nome	Descrição
WriteOnlyArray::begin	Um iterador que aponta para o primeiro elemento da matriz.
WriteOnlyArray::Data	Um ponteiro para o buffer de dados.
WriteOnlyArray::end	Um iterador que aponta para após o último elemento da matriz.
WriteOnlyArray::FastPass	Indica se a matriz pode usar o mecanismo FastPass, que é uma otimização executada pelo sistema de forma transparente. Não use isso em seu código
WriteOnlyArray::Length	Retorna o número de elementos na matriz.
WriteOnlyArray::set	Define o elemento especificado para o valor especificado.

Hierarquia de herança

WriteOnlyArray

Requisitos

Opção do compilador: /ZW

Metadados: Platform.winmd

Namespace: Platform

Método WriteOnlyArray::begin

Retorna um ponteiro para o primeiro elemento da matriz.

Sintaxe

T* begin() const;

Valor retornado

Um ponteiro para o primeiro elemento da matriz.

Comentários

Esse iterador pode ser usado com algoritmos STL, como std::sort, para operar em elementos da matriz.

Propriedade WriteOnlyArray::Data

Ponteiro para o buffer de dados.

Sintaxe

property T* Data{
   T* get() const;
}

Valor retornado

Um ponteiro para os bytes de matriz brutos.

Método WriteOnlyArray::end

Retorna um ponteiro para após o último elemento da matriz.

Sintaxe

T* end() const;

Valor retornado

Um iterador de ponteiro para após o último elemento da matriz.

Comentários

Esse iterador pode ser usado com algoritmos STL para executar operações como std::sort nos elementos da matriz.

Propriedade WriteOnlyArray::FastPass

Indica se a otimização FastPass interna pode ser executada. Não destinado ao uso por código de usuário.

Sintaxe

property bool FastPass{
   bool get() const;
}

Valor retornado

Um valor booliano que indica se a matriz é FastPass.

Método WriteOnlyArray::get

Retorna o elemento no índice especificado.

Sintaxe

T& get(unsigned int indexArg) const;

Parâmetros

indexArg
O índice a ser usado.

Valor de Devolução

Propriedade WriteOnlyArray::Length

Retorna o número de elementos na matriz alocada pelo chamador.

Sintaxe

property unsigned int Length{
   unsigned int get() const;
}

Valor retornado

O número de elementos na matriz.

Função WriteOnlyArray::set

Define o valor especificado no índice especificado na matriz.

Sintaxe

T& set(
   unsigned int indexArg,
   T valueArg);

Parâmetros

indexArg
O índice do elemento a ser definido.

valueArg
O valor a ser definido em indexArg.

Valor de Devolução

Uma referência ao elemento que acabou de ser definido.

Comentários

Para obter mais informações sobre como interpretar o valor HRESULT, confira Estrutura dos Códigos de Erro do COM.

Confira também

Namespace de Plataforma
Criando componentes do Windows Runtime no C++