Classe Platform::WriteOnlyArrayPlatform::WriteOnlyArray Class

Representa uma matriz unidimensional que é usada como parâmetro de entrada quando o chamador passa uma matriz para o método para preenchimento.Represents a one-dimensional array that's used as an input parameter when the caller passes an array for the method to fill.

Essa classe ref é declarada como particular em vccorlib.h; portanto, não é emitida nos metadados e é somente consumível em C++.This ref class is declared as private in vccorlib.h; therefore, it's not emitted in metadata and is only consumable from C++. Essa classe é destinada somente para uso como um parâmetro de entrada que recebe uma matriz alocada pelo chamador.This class is intended only for use as an input parameter that receives an array that the caller has allocated. Ela não pode ser construída a partir do código do usuário.It is not constructible from user code. Ela permite que um método C++ grave diretamente nessa matriz — um padrão que é conhecido como o padrão FillArray .It enables a C++ method to write directly into that array—a pattern that's known as the FillArray pattern. Para obter mais informações, consulte matriz e WriteOnlyArray.For more information, see Array and WriteOnlyArray.

SintaxeSyntax

private ref class WriteOnlyArray<T, 1>

MembrosMembers

Métodos públicosPublic Methods

Esses métodos têm acessibilidade interna — ou seja, eles são acessíveis apenas dentro do aplicativo ou componente C++.These methods have internal accessibility—that is, they are only accessible within the C++ app or component.

NomeName DescriçãoDescription

|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 logo após o último elemento na matriz. | | Writeonlyarray:: Fastpass| Indica se a matriz pode usar o mecanismo FastPass, que é uma otimização executada de forma transparente pelo sistema.|WriteOnlyArray::begin|An iterator that points to the first element of the array.| |WriteOnlyArray::Data|A pointer to the data buffer.| |WriteOnlyArray::end|An iterator that points to one past the last element in the array.| |WriteOnlyArray::FastPass|Indicates whether the array can use the FastPass mechanism, which is an optimization transparently performed by the system. 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. |Don’t use this in your code| |WriteOnlyArray::Length|Returns the number of elements in the array.| |WriteOnlyArray::set|Sets the specified element to the specified value.|

Hierarquia de herançaInheritance Hierarchy

WriteOnlyArray

RequisitosRequirements

Opção do compilador: /ZWCompiler option: /ZW

Metadados: Platform.winmdMetadata: Platform.winmd

Namespace: PlatformNamespace: Platform

Método WriteOnlyArray::beginWriteOnlyArray::begin Method

Retorna um ponteiro para o primeiro elemento da matriz.Returns a pointer to the first element in the array.

SintaxeSyntax

T* begin() const;

Valor de retornoReturn Value

Um ponteiro para o primeiro elemento da matriz.A pointer to the first element in the array.

ComentáriosRemarks

Esse iterador pode ser usado com algoritmos STL, como std::sort, para operar em elementos da matriz.This iterator can be used with STL algorithms such as std::sort to operate on elements in the array.

Propriedade WriteOnlyArray::DataWriteOnlyArray::Data Property

Ponteiro para o buffer de dados.Pointer to the data buffer.

SintaxeSyntax

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

Valor de retornoReturn Value

Um ponteiro para os bytes de matriz brutos.A pointer to the raw array bytes.

Método WriteOnlyArray::endWriteOnlyArray::end Method

Retorna um ponteiro para após o último elemento da matriz.Returns a pointer to one past the last element in the array.

SintaxeSyntax

T* end() const;

Valor de retornoReturn Value

Um iterador de ponteiro para após o último elemento da matriz.A pointer iterator to one past the last element in the array.

ComentáriosRemarks

Esse iterador pode ser usado com algoritmos STL para executar operações como std::sort nos elementos da matriz.This iterator can be used with STL algorithms to perform operations such as std::sort on the array elements.

Propriedade WriteOnlyArray::FastPassWriteOnlyArray::FastPass Property

Indica se a otimização FastPass interna pode ser executada.Indicates whether the internal FastPass optimization can be performed. Não destinado ao uso por código de usuário.Not intended for use by user code.

SintaxeSyntax

property bool FastPass{
   bool get() const;
}

Valor de retornoReturn Value

Um valor booliano que indica se a matriz é FastPass.Boolean value that indicates whether the array is FastPass.

Método writeonlyarray:: GetWriteOnlyArray::get Method

Retorna o elemento no índice especificado.Returns the element at the specified index.

SintaxeSyntax

T& get(unsigned int indexArg) const;

ParâmetrosParameters

indexArgindexArg
O índice a ser usado.The index to use.

Valor de retornoReturn Value

Propriedade WriteOnlyArray::LengthWriteOnlyArray::Length Property

Retorna o número de elementos na matriz alocada pelo chamador.Returns the number of elements in the caller-allocated array.

SintaxeSyntax

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

Valor de retornoReturn Value

O número de elementos na matriz.The number of elements in the array.

Função WriteOnlyArray::setWriteOnlyArray::set Function

Define o valor especificado no índice especificado na matriz.Sets the specified value at the specified index in the array.

SintaxeSyntax

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

ParâmetrosParameters

indexArgindexArg
O índice do elemento a ser definido.The index of the element to set.

valueArgvalueArg
O valor a ser definido em indexArg.The value to set at indexArg.

Valor de retornoReturn Value

Uma referência ao elemento que acabou de ser definido.A reference to the element that was just set.

ComentáriosRemarks

Para obter mais informações sobre como interpretar o valor HRESULT, consulte estrutura de códigos de erro COM.For more information about how to interpret the HRESULT value, see Structure of COM Error Codes.

Consulte tambémSee Also

Namespace de plataformaPlatform Namespace
Criando componentes de tempo de execução do Windows em C++Creating Windows Runtime Components in C++