Register Login


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:

  1. part(array, begin_offset)
  2. 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.