ILNumerics Ultimate VS

ConcreteRetArrayT1, LocalT, InT, OutT, RetT, StorageTExportValues Method

ILNumerics Ultimate VS Documentation
ILNumerics - Technical Application Development
Export (copy) values into System.Array.

[ILNumerics Core Module]

Namespace:  ILNumerics.Core.Arrays
Assembly:  ILNumerics.Core (in ILNumerics.Core.dll) Version: 5.5.0.0 (5.5.7503.3146)
Syntax

public override void ExportValues(
	ref T1[] result,
	StorageOrders layout = StorageOrders.ColumnMajor
)

Parameters

result
Type: T1
System.Array with a copy of all element values from this array.
layout (Optional)
Type: ILNumericsStorageOrders
[Optional] The storage layout of the elements to write to result.
Remarks

The System.Array should be predefined. If its length is sufficient, it will be used and its leading elements will be overwritten when function returns. If result is null or has too few elements, it will be recreated from the _GC managed heap_.

Excessive use of this method can be a hint of suboptimal design! Especially if no array /no sufficiently long array is provided in result the returned array will be created on the managed heap. This works around the ILNumerics memory management and may increases the pressure on the GC and can lead to frequent garbage collections and bad performance! Make sure to reuse the array result.

Iflayout is null orOther the storage layout of this array will be used to store the elements into result. Make sure that the array result is large enough, even if the current storage layout corresponds to non-continously stored elements and may contain holes! Use GetElementSpan to compute the absolute number of elements in result necessary to hold all elements of this storage in its current storage order. Note further, that any potentially existing holes in the element storage will not be cleared!

[ILNumerics Core Module]

See Also

Reference