Difference between revisions of "Recital Arrays"

From Recital Documentation Wiki
Jump to: navigation, search
(How to Create an Associative Array in Recital)
(Sorting an Array)
Line 74: Line 74:
 
===Replacing Sections of an Array===
 
===Replacing Sections of an Array===
 
===Sorting an Array===
 
===Sorting an Array===
 +
* [[ASORT()|asort()]] - sort the character elements of the specified array
 +
 +
<pre>
 +
logical = asort(arrayname as character [, startelement as numeric [, endelement as numeric [, reverse as numeric]]])
 +
</pre>
 +
 
===Passing Arrays as Function Arguments===
 
===Passing Arrays as Function Arguments===
 
===Miscellaneous Array Functions===
 
===Miscellaneous Array Functions===
 
===Summary===
 
===Summary===

Revision as of 13:59, 23 July 2010

Recital Arrays

An Overview of Arrays in Recital

How to Create a Static Array in Recital

Static Arrays

A static array is an ordered list of elements (variables) that is of a fixed size (number of elements). You declare a static array by specifying the number of elements when you declare a variable.

private tab[ 20 ]    // declare a static array of 20 elements all initialized to False
 
// iterate through the array (note the use of the alen( ) function to find the length of the array
for i=1 to alen( tab )
    // change each array element to hold a numeric value
    tab[ i ] = i
endfor

You can initialize a static array with one statement.

// declare the array and init all elements to false
declare tab[10, 10]
 
// init all elements to zero
tab = 0

You can create and initialize static arrays using static array initializers.

// simple one dimensional array with 2 elements
private tab = { "Hello", "world" }
 
// two-dimensional array of two rows with three columns in each row
private tab2 = { { "Hello", 10, date() ], { "world", 20, date()+1 } }
 
// create an array on the fly
mytab = { 10, 20, 30, 40, 50, 60 }

You can view the contents of a static array using the echo or ? commands.

? tab

How to Create an Associative Array in Recital

An associative array (also known as a dynamic array) is a collection of key/value pairs where the key can be used to retrieve the value. Associative arrays are dynamic, meaning that elements can be added and removed dynamically.

private tab[]    // note the use of [] to denote a dynamic array
 
tab["name"] = "bill"
tab["age"] = 25
tab["dob"] = date()

Associative arrays can be created and initialized in one statement using the array( ) function.

tab = array("name" => "bill", "age" => 25, ""dob" => date())

You can view the contents of an associative array using the echo or ? commands.

? tab

Accessing Elements in a Static Array

Accessing Elements in an Associative Array

Changing, Adding and Removing Elements From Arrays

Looping Through Arrays

Replacing Sections of an Array

Sorting an Array

  • asort() - sort the character elements of the specified array
logical = asort(arrayname as character [, startelement as numeric [, endelement as numeric [, reverse as numeric]]])

Passing Arrays as Function Arguments

Miscellaneous Array Functions

Summary