Represents a one-dimensional array that's used as an input parameter when the caller passes an array for the method to fill.

This ref class is declared as private in vccorlib.h; therefore, it's not emitted in metadata and is only consumable from C++. This class is intended only for use as an input parameter that receives an array that the caller has allocated. It is not constructible from user code. It enables a C++ method to write directly into that array—a pattern that's known as the FillArray pattern. For more information, see Array and WriteOnlyArray.

private ref class WriteOnlyArray<T, 1>  

These methods have internal accessibility—that is, they are only accessible within the C++ app or component.

|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. 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.|

WriteOnlyArray

Compiler option: /ZW

Metadata: Platform.winmd

Namespace: Platform

Returns a pointer to the first element in the array.

T* begin() const;  

A pointer to the first element in the array.

This iterator can be used with STL algorithms such as std::sort to operate on elements in the array.

Pointer to the data buffer.

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

A pointer to the raw array bytes.

Returns a pointer to one past the last element in the array.

T* end() const;  

A pointer iterator to one past the last element in the array.

This iterator can be used with STL algorithms to perform operations such as std::sort on the array elements.

Indicates whether the internal FastPass optimization can be performed. Not intended for use by user code.

property bool FastPass{  
   bool get() const;  
}  

Boolean value that indicates whether the array is FastPass.

Returns the element at the specified index.

T& get(  
   unsigned int indexArg) const;  

indexArg

Returns the number of elements in the caller-allocated array.

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

The number of elements in the array.

Sets the specified value at the specified index in the array.

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

indexArg
The index of the element to set.

valueArg
The value to set at indexArg.

A reference to the element that was just set.

For more information about how to interpret the HRESULT value, see Structure of COM Error Codes.

Platform Namespace
Creating Windows Runtime Components in C++