ReserveArrayNode

Introduced

7.0

UI Location

• Array

Description

Manually reserves memory internally to store an array that will eventually grow to the specified size. Reserve does not resize the array.

The main reason for using Reserve is efficiency. If you know the size the array will eventually grow to in advance, reserving the space in memory ahead can help improve performance when increasing the array size frequently.

Port Description

Inputs

Group ID | Instance s | Port Name | Connection Info | Description
0 | 1 | size | • Type: siICENodeDataLong • Structure: siICENodeStructureSingle • Context: siICENodeContextAny | The number of array cells to reserve. This is typically the maximum size you know the array will grow to.
array | • Type: siICENodeDataValue or siICENodeDataLocation • Structure: siICENodeStructureAny • Context: siICENodeContextAny | The array to reserve memory for.

Outputs

Port Name | Connection Info | Description
result | • Type: siICENodeDataValue or siICENodeDataLocation • Structure: siICENodeStructureArray • Context: siICENodeContextAny | The input array but with reserved memory.

Restrictions

• These types must match: array, result

• These contexts must match: size, array, result

See Also

BuildArrayFromConstantNode | BuildArrayNode | GetArraySizeNode | ResizeArrayNode
Accessing Data from Array Nodes |  |  |

Autodesk Softimage v7.5