Click or drag to resize

Array Function (Usual)

X#
Create an uninitialized array with the specified number of elements and dimensions.

Namespace:  XSharp.RT
Assembly:  XSharp.RT (in XSharp.RT.dll) Version: 2.21
Syntax
Copy
 FUNCTION Array(
	wElementList PARAMS USUAL[]
) AS ARRAY
Request Example View Source

Parameters

wElementList
Type: Usual
A comma-separated list representing the number of elements in each dimension.
If more than one element number is specified, a multidimensional array is created with the number of dimensions equal to the number of arguments in wElementList.

Return Value

Type: Array
An array of specified dimensions.
Remarks
In X#, there are several ways to create an array: Declare an array using a declaration statement such as LOCAL or STATIC. Create an array using a PRIVATE or PUBLIC statement. Assign a literal array to an existing variable. Use the ArrayNew() function.
ArrayNew() has the advantage that it can create arrays within expressions or code blocks. You can also use the ArrayBuild() function to create empty arrays, the ArrayCreate() function to create one-dimensional arrays, or ArrayInit() to create initialized arrays.
Examples
This example creates a one-dimensional array of five elements using the ArrayNew() function, then shows the equivalent action by assigning a literal array of NIL values:
X#
Copy
1LOCAL aArray AS ARRAY
2aArray := ArrayNew(5)
3aArray := {NIL, NIL, NIL, NIL, NIL}
This example shows three different statements which create the same multidimensional array:
X#
Copy
1aArray := ArrayNew(3, 2)
2aArray := {{NIL, NIL}, {NIL, NIL}, {NIL, NIL}}
3aArray := {ArrayCreate(2), ArrayCreate(2), ArrayCreate(2)}
This example creates a multidimensional array:
X#
Copy
1aArray := ArrayNew(3, 2, 5)
See Also