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| Um iterador que aponta para o primeiro elemento da matriz. ||WriteOnlyArray::begin|An iterator that points to the first element of the array.|
|Writeonlyarray:: data| Um ponteiro para o buffer de dados. ||WriteOnlyArray::Data|A pointer to the data buffer.|
|Writeonlyarray| Um iterador que aponta para após o último elemento na matriz. ||WriteOnlyArray::end|An iterator that points to one past the last element in the array.|
|Writeonlyarray:: Fastpass| Indica se a matriz pode usar o mecanismo FastPass, que é uma otimização executada pelo sistema de forma transparente.|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 |Don’t use this in your code|
|Writeonlyarray:: Length| Retorna o número de elementos na matriz. ||WriteOnlyArray::Length|Returns the number of elements in the array.|
|Writeonlyarray:: set| Define o elemento especificado para o valor especificado. ||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:WriteOnlyArray::get Method

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

SintaxeSyntax

T& get(  
   unsigned int indexArg) const;  

ParâmetrosParameters

indexArg

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

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

valueArg
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 plataforma Platform Namespace
Criando componentes de tempo de execução do Windows em C++Creating Windows Runtime Components in C++