Platform::WriteOnlyArray (Clase)

Representa una matriz unidimensional que se utiliza como parámetro de entrada cuando el llamador pasa una matriz para el método que se va a rellenar.

Esta clase ref se declara como privada en vccorlib.h; por consiguiente, no se emite en los metadatos y solo se puede usar desde C++. Esta clase está diseñada únicamente para su uso como un parámetro de entrada que recibe una matriz que el llamador ha asignado. No se puede crear desde el código de usuario. Permite a un método de C++ escribir directamente en dicha matriz, patrón que se conoce como FillArray . Para obtener más información, vea Array y WriteOnlyArray.

Sintaxis

private ref class WriteOnlyArray<T, 1>

Miembros

Métodos públicos

Estos métodos tienen accesibilidad interna, es decir, solo están accesibles desde la aplicación o componente de C++.

Nombre	Descripción
WriteOnlyArray::begin	Un iterador que apunta al primer elemento de la matriz.
WriteOnlyArray::Data	Puntero al búfer de datos.
WriteOnlyArray::end	Un iterador que apunta a uno más allá del último elemento de la matriz.
WriteOnlyArray::FastPass	Indica si la matriz puede usar el mecanismo FastPass, que es una optimización realizada por el sistema de manera transparente. No lo use en el código
WriteOnlyArray::Length	Devuelve el número de elementos de la matriz.
WriteOnlyArray::set	Establece el elemento especificado en el valor indicado.

Jerarquía de herencia

WriteOnlyArray

Requisitos

Opción del compilador: /ZW

Metadatos: Platform.winmd

Espacio de nombres: Plataforma

WriteOnlyArray::begin (Método)

Devuelve un puntero al primer elemento de la matriz.

Sintaxis

T* begin() const;

Valor devuelto

Puntero al primer elemento de la matriz.

Comentarios

Este iterador se puede usar con los algoritmos de STL como std::sort para operar en elementos de la matriz.

WriteOnlyArray::Data (Propiedad)

Puntero al búfer de datos.

Sintaxis

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

Valor devuelto

Puntero a los bytes sin formato de la matriz.

WriteOnlyArray::end (Método)

Devuelve un puntero a uno más allá del último elemento de la matriz.

Sintaxis

T* end() const;

Valor devuelto

Iterador de puntero a uno más allá del último elemento de la matriz.

Comentarios

Este iterador se puede usar con los algoritmos de STL para realizar operaciones como std::sort en elementos de la matriz.

WriteOnlyArray::FastPass (Propiedad)

Indica si se puede realizar la optimización interna de FastPass. No se ha diseñado para el uso en el código del usuario.

Sintaxis

property bool FastPass{
   bool get() const;
}

Valor devuelto

Valor booleano que indica si la matriz es FastPass.

WriteOnlyArray::get (Método)

Devuelve el elemento que se encuentra en el índice especificado.

Sintaxis

T& get(unsigned int indexArg) const;

Parámetros

indexArg
Índice que se va a usar.

Valor devuelto

WriteOnlyArray::Length (Propiedad)

Devuelve el número de elementos de la matriz asignada por el llamador.

Sintaxis

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

Valor devuelto

El número de elementos de la matriz.

WriteOnlyArray::set (Función)

Establece el valor especificado en el índice especificado de la matriz.

Sintaxis

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

Parámetros

indexArg
Índice del elemento que se va a establecer.

valueArg
El valor que se va a establecer en indexArg.

Valor devuelto

Una referencia al elemento que se acaba de establecer.

Comentarios

Para más información sobre cómo interpretar el valor HRESULT, vea Estructura de los códigos de error COM.

Consulte también

Espacio de nombres de plataforma
Crear componentes de Windows Runtime en C++