Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
ArrayReference is an optimization type that you can substitute for Platform::Array^ in input parameters when you want to fill a C-style array with the input data.
Syntax
class ArrayReference
Members
Public Constructors
| Name | Description |
|---|---|
| ArrayReference::ArrayReference | Initializes a new instance of the ArrayReference class. |
Public Operators
| Name | Description |
|---|---|
| ArrayReference::operator() Operator | Converts this ArrayReference to a Platform::Array<T>^*. |
| ArrayReference::operator= Operator | Assigns the contents of another ArrayReference to this instance. |
Exceptions
Remarks
By using ArrayReference to fill a C-style array, you avoid the extra copy operation that would be involved in copying first to a Platform::Array variable, and then into the C-style array. When you use ArrayReference, there is only one copy operation. For a code example, see Array and WriteOnlyArray.
Requirements
Minimum supported client: Windows 8
Minimum supported server: Windows Server 2012
Namespace: Platform
Header: vccorlib.h
ArrayReference::ArrayReference Constructor
Initializes a new instance of the Platform::ArrayReference class.
Syntax
ArrayReference(TArg* ataArg, unsigned int sizeArg, bool needsInitArg = false);
ArrayReference(ArrayReference&& otherArg)
Parameters
dataArg
A pointer to the array data.
sizeArg
The number of elements in the source array.
otherArg
An ArrayReference object whose data will be moved to initialize the new instance.
Remarks
ArrayReference::operator= Operator
Assigns the specified object to the current Platform::ArrayReference object by using move semantics.
Syntax
ArrayReference& operator=(ArrayReference&& otherArg);
Parameters
otherArg
The object that is moved to the current ArrayReference object.
Return Value
A reference to an object of type ArrayReference.
Remarks
Platform::ArrayReference is a standard C++ class template, not a ref class.
ArrayReference::operator() Operator
Converts the current Platform::ArrayReference object back to a Platform::Array class.
Syntax
Array<TArg>^ operator ();
Return Value
A handle-to-object of type Array<TArg>^
Remarks
Platform::ArrayReference is a standard C++ class template, and Platform::Array is a ref class.