Description

This method is only available when marshalling std::vector and std::array objects, and provides a way to marshal individual entries from the bound collection. This is useful if large collections are being marshalled, but not all the elements in the collection are required. Note that marshalling a collection is less efficient when done one element at a time, so this method should only be used where it is known that a significant number of the elements in the bound collection do not need to be accessed. In other cases, the entire collection should be marshalled, and elements accessed from the marshalled collection.

Note that this method will perform a move operation on the source element if possible, so an element should not be requested more than once through this method, nor should the entire collection be marshalled through another method after GetElement has been called.

Note that this method is currently only available where the contained element is an assignable type.

Usage (std::vector, std::array only):

void GetElement(size_type index, ElementType& element) const

Argument list

index [size_type]
The index of the element to marshal from the bound collection
element [ElementType]
The target object to marshal the retrieved element into

See also