InitialiseArrays

16 мар. 2022 г.

Library "InitialiseArrays"
@description: Efficiently create arrays, populating them with an arbitrary number of elements and setting their starting values. Works with a mix of typed and na values.

A limitation of the built-in functions to create arrays is that while you can create and populate arrays with a single command, you can only set all elements to the same value in this way.
Or, you can create an array from a set of values or variables, but you can't include any na values.
Now, it's easy enough to work around this, but I wanted to make something more efficient (because I want to use lots of arrays), hence this library.
Calling a function from here is more efficient because you only do it once (assuming it's a var) and don't evaluate an if condition each run, and don't create unnecessary variables.
It's also easier to read and takes less space.

f_initialiseBoolArray()
Function f_initialiseBoolArray(string _values) Creates a boolean array, populated with the values that you specify in the input string.
param _values is a string that contains a comma-separated list of the values that you want to initialise the boolean array with. Values other than true, false, and na are disregarded. Spaces are disregarded.
Returns Returns a boolean array of arbitrary length.

f_initialiseFloatArray()
Function f_initialiseFloatArray(string _values) Creates a float array, populated with the values that you specify in the input string.
param _values is a string that contains a comma-separated list of the values that you want to initialise the float array with. Non-numerical entries are converted to NaN values. Spaces are disregarded.
Returns Returns a float array of arbitrary length.

f_initialiseIntArray()
Function f_initialiseIntArray(string _values) Creates an int array, populated with the values that you specify in the input string.
param _values is a string that contains a comma-separated list of the values that you want to initialise the int array with. Floating-point numbers are rounded down to the nearest integer. Any na values are preserved. Spaces are disregarded.
Returns Returns a float array of arbitrary length.

V1 includes functions for bools, floats, and ints. I might extend it if people want.