Array Types¶
An array is a fixed-size indexed collection of elements of the same type.
IEC 61131-3 |
Section 2.3.3.1 |
Support |
Supported |
Syntax¶
ARRAY [ lower_bound .. upper_bound ] OF element_type
Arrays can be declared inline in variable declarations or as named types.
Example¶
TYPE
TenInts : ARRAY [1..10] OF INT;
END_TYPE
PROGRAM main
VAR
values : ARRAY [0..9] OF DINT;
matrix : ARRAY [1..3, 1..3] OF REAL;
END_VAR
values[0] := 42;
values[5] := values[0] + 1;
END_PROGRAM
Multi-dimensional arrays use comma-separated ranges in the index specification.
Each subscript is an integer. A BOOL subscript is error
P4086, and a real literal
subscript such as values[1.5] is error
P4094.
Only an array can be subscripted. A subscript on anything else, such as a
DINT, a STRING or a structure, is error
P4097.
Arrays of Arrays¶
The element type of an array can be another array type. Each subscript list selects from one array. An element of an array of arrays takes one list for each array, and an element of a multi-dimensional array takes one list with a subscript for each dimension:
TYPE
Row : ARRAY [1..3] OF DINT;
END_TYPE
PROGRAM main
VAR
rows : ARRAY [1..2] OF Row;
matrix : ARRAY [1..2, 1..3] OF DINT;
row : Row;
END_VAR
rows[2][3] := 7; (* an element of the inner array *)
row := rows[2]; (* a whole inner array, a Row *)
matrix[2, 3] := 7; (* one list for both dimensions *)
END_PROGRAM
rows[2, 3] and matrix[2][3] give the wrong number of subscripts for
their arrays, which is error P4085.
Constant Bounds (Language Extension)¶
Note
This is an extension not part of the IEC 61131-3 standard. See Enabling Dialects and Features for how to enable it.
Many PLC vendors allow global constants in place of literal values for
array bounds. IronPLC supports this with the --allow-constant-type-params
flag. The constant must be declared in a
VAR_GLOBAL CONSTANT block.
VAR_GLOBAL CONSTANT
ARRAY_SIZE : INT := 10;
END_VAR
FUNCTION_BLOCK fb1
VAR_EXTERNAL CONSTANT
ARRAY_SIZE : INT;
END_VAR
VAR
data : ARRAY[1..ARRAY_SIZE] OF INT;
END_VAR
END_FUNCTION_BLOCK
PROGRAM main
VAR
instance : fb1;
END_VAR
END_PROGRAM
Radix Bounds (Language Extension)¶
Note
This is an extension not part of the IEC 61131-3 standard. See Enabling Dialects and Features for how to enable it.
With the --allow-radix-subrange-bounds flag, a bound can be written in
hex, binary, or octal. Without the flag, such a bound is reported as
P4096.
PROGRAM main
VAR
nibbles : ARRAY[16#0..16#F] OF BYTE;
END_VAR
END_PROGRAM
See Also¶
Structure Types — record with named fields