PoolRealArray

A pooled Array of reals (float).

Description

An Array specifically designed to hold floating-point values. Optimized for memory usage, does not fragment the memory.

Note: This type is passed by value and not by reference.

Note: Unlike primitive floats which are 64-bit, numbers stored in PoolRealArray are 32-bit floats. This means values stored in PoolRealArray have lower precision compared to primitive floats. If you need to store 64-bit floats in an array, use a generic Array with float elements as these will still be 64-bit. However, using a generic Array to store floats will use roughly 6 times more memory compared to a PoolRealArray.

Methods

Method Descriptions

• PoolRealArray PoolRealArray ( Array from )

Constructs a new PoolRealArray. Optionally, you can pass in a generic Array that will be converted.

• void append ( float value )

Appends an element at the end of the array (alias of push_back).

• void append_array ( PoolRealArray array )

Appends a PoolRealArray at the end of this array.

• bool empty ( )

Returns true if the array is empty.

• int insert ( int idx, float value )

Inserts a new element at a given position in the array. The position must be valid, or at the end of the array (idx == size()).

• void invert ( )

Reverses the order of the elements in the array.

• void push_back ( float value )

Appends an element at the end of the array.

• void remove ( int idx )

Removes an element from the array by index.

• void resize ( int idx )

Sets the size of the array. If the array is grown, reserves elements at the end of the array. If the array is shrunk, truncates the array to the new size.

Note: Added elements are not automatically initialized to 0 and will contain garbage, i.e. indeterminate values.

• void set ( int idx, float value )

Changes the float at the given index.

• int size ( )

Returns the size of the array.