Functions > Array and Data Manipulation

This category contains the following functions:

01. append | 02. array | 03. concat | 04. contains |

05. count | 06. extract | 07. first | 08. itemat |

09. last | 10. max | 11. min | 12. part |

13. sort | 14. sortd | 15. reverse | 16. vector |

17. vectorin |

### append

Function append() is used to change an existing named numeric or Boolean variable by appending more values. It has the following form:

append (*var, value_or_array_1, value_or_array_2, ..., value_or_array_n*)

**var:** It is a named variable of type bool or vector (array or number). value_or_array_1, ... value_or_array_n: These are the values to be appended to the variable *var*. If *var* is of type **Boolean** any non-zero values to be appended are converted to 1 (true).

The job of append can be done by using the concat() function and assigning the result back to the first argument passed to concat(). However, append gives better performance if the size of arguments is big.

### array

Creates an array of values, the array can be assigned to a variable for later use.

**Example:**

>> a = array(1,2,3)

>> c = a + 2 (*Adds 2 to every member of 'a' and assigns the resulting array to c*)

### concat

Concatenates (joins) supplied array(s) and/or value(s) into a single array. The original parameters are unaffected.

### contains

Checks whether certain item is present in some vector or matrix. Its format is:

contains (*var, item*)

Here *var* is an array or matrix and *item* is the value of which the presence is to be checked.

### count

Gets the count of the elements of the given numeric or Boolean array(s) and/or values.

### extract

Retrieves valid numeric values from an array (i.e. excludes NaN, Infinity).

### first

Retrieve first element of numeric or Boolean array(s).

### itemat

Get the element at the given zero-based offset.

**Example**

>> a = array(1,2,3)

>> itemat(a, 1)

>> 2 (*2 is the element at offset 1 in the specified array.*)

### last

Retrieves the last element of numeric or Boolean array(s).

### max

Gets the maximum value(s) from supplied array(s) and/or matrix and/or values.

### min

Gets the minimum value(s) from supplied array(s) and/or matrix and/or values.

### part

Retrieves a part of the given array. It has two forms:

- part(
*array, begin_offset*) - part(
*array, begin_offset, count*)

The first from gets all and the second form gets *count* number of values starting from *begin_offest*.

### sort

Returns a sorted (ascending) copy of a single array or a series of values. The original values or array remain unaffected. For sorting in descending order, please use sortd function.

### sortd

Returns a sorted (descending) copy of a single array or a series of values. The original values or array remain unaffected. For sorting in ascending order, please use sort function.

### reverse

The input to reverse() is either a single array or a series of values. The function reverses the given array or values.

### vector

A convenient way to define arrays based on fixed increment/decrement) from a starting number up to some other number. The function has the following form:

vector(*initial_value, change, final_value*)

All three parameters can be fractions. *final_value* may or may not be part of the resulting array based on wheather the increments happen to include it in the result. If you want to make sure that the final value is always part of the result, use the **vectorin** function mentioned next.

**Example**

>> a = vector (1,1,10)

>> 1 2 3 4 5 6 7 8 9 10

>> b = vector(-10, 1, 0)

>> -10 -9 -8 -7 -6 -5 -4 -3 -2 -1 0

### vectorin

Stands for **vector inclusive**. Works like the vector function except that the final value is always part of the resulting array regardless whether calculations reach it.