The Array data type
The data type of arrays is Array
. By
default, Array
matches arrays of any length,
provided all values in the array match the abstract data type Data
.
You can use parameters to restrict which values Array
matches.
Parameters
The full signature for Array
is:
Array[<CONTENT TYPE>, <MIN SIZE>, <MAX SIZE>]These parameters are optional. They must be listed in order; if you need to specify a later parameter, you must also specify values for any prior ones.
Position | Parameter | Data type | Default value | Description |
---|---|---|---|---|
1 | Content type | Type | Data | The kind of values the array contains. You can specify only one data type per
array, and every value in the array must match that type. Use an
abstract type to allow multiple data types. If the order of elements matters, use
the Tuple type instead of Array . |
2 | Minimum size | Integer | 0 | The minimum number of elements in the array. This parameter accepts the
special value default , which uses its default
value. |
3 | Maximum size | Integer | infinite | The maximum number of elements in the array. This parameter accepts the
special value default , which uses its default
value. |
Examples:
Array
Matches an array of any length. All elements in the array must match
Data
.Array[String]
Matches an array of any size that contains only strings.
Array[Integer, 6]
Matches an array containing at least six integers.
Array[Float, 6, 12]
Matches an array containing at least six and at most 12 floating-point numbers.
Array[Variant[String, Integer]]
Matches an array of any size that contains only strings or integers, or both.
Array[Any, 2]
Matches an array containing at least two elements, allowing any data type
(including
Type
and Resource
).The abstract Tuple
data type lets you
specify data types for every element in an array, in order. Abstract types, such
as Variant
and Enum
, are useful when specifying content types for arrays that include multiple
kinds of data.