ObjectType:array

Description

Object Type Vitals

array
Defined By	LavishScript
Inherits	objectcontainer
Reduces To	NULL
Variable Object Type	none
Uses Sub-Types	yes
C/C++ Type	CDataArray *

An array is a statically-sized (predefined size) list of objects. All objects in the array are created and destroyed with the array object itself -- they cannot be destroyed or created otherwise. See the index object type for a dynamically-sized list type in which the contained objects are not created with the object itself, and can be created or destroyed later -- though an index may not have multiple dimensions.

Members

• uint Dimensions: Total number of extents of the array (e.g. 2-dimensional has two extents)
• uint Size: Total number of elements in the array, including all dimensions
• uint Size[#]: Total number of elements in a given dimension of the array
• mutablestring Expand[begin #,length]: Retrieves the text representation of each object in the array as quoted parameters, separated by spaces. If no parameters are given to Expand, the entire array will be used. If only the begin # is used, the rest of the array, beginning with the element # specified, will be used. If the length is additionally given, that number of elements from the array will be used, beginning with the element # specified as the beginning.
• mutablestring ExpandComma[begin #,length]: Retrieves the text representation of each object in the array as quoted parameters, separated by commas. If no parameters are given to Expand, the entire array will be used. If only the begin # is used, the rest of the array, beginning with the element # specified, will be used. If the length is additionally given, that number of elements from the array will be used, beginning with the element # specified as the beginning.

Methods

None

Examples

Declare an array of strings

• declare Array1[20] string

Declare a 3 dimensional array of floats

• declare Array2[20,15,5] float global

Display total dimensions of an array

• echo Dimensions: ${Array2.Dimensions}

Output

Dimensions: 3

Display number of elements in a specific dimension

• echo Elements in dimension 2: ${Array2.Size[2]}

Output

Elements in dimension 2: 15

Set and display the element at [2,3,1]

• Array2[2,3,1]:Set[149.23]
• echo ${Array2[2,3,1]}

Output

149.23

Operates On

CDataArray *

This is an internal data type.

See Also

• Data Types