dl-breadcrumbs__homedl-breadcrumb-item__separatorConfiguration and programmingdl-breadcrumb-item__separatorProgramming with CODESYSdl-breadcrumb-item__separator...dl-breadcrumb-item__separatorCODESYS Development Systemdl-breadcrumb-item__separatorProgramming of Applicationsdl-breadcrumb-item__separatorDeclaration of Variables dl-breadcrumb-item__separatorDeclaring arrays
dl-pagination__prev-inactivedl-pagination__prev-activedl-pagination__next-inactivedl-pagination__next-active
Declaring arraysdl-permalink__symbolPermalink

Requirement: A programming object (POU or GVL) of a project is open.

  1. Click “Edit  Declare Variable”.

    The “Declare Variable” dialog opens.

  2. Select the desired scope for the array from the drop-down list “Scope”.

  3. Enter an identifier for the array in the “Name” input field.

  4. Click the arrow button (_icon_arrow_button) next to the “Data type” input field and select the “Array Assistant” entry from the selection menu.

  5. In the input fields “Dimension 1”, type in the lower and upper limit of the first dimension of the array (example: ‎1‎ and ‎3‎).

    The field “Result” displays the 1st dimension of the array (example: ‎ARRAY [1..3] OF ?‎).

  6. In the input field “Basic type”, type in the data type of the array or use the “Input Assistant” (_icon_arrow_button) or the “Array Assistant” (example: ‎DINT‎).

    The field “Result” displays the data type of the array now (example: ‎ARRAY [1..3] OF DINT‎).

  7. Define the second and third dimensions of the array according to steps 5 and 6 (example: Dimension 2: ‎1‎ and ‎4‎, Dimension 3: ‎1‎ and ‎2‎).

    The “Result” field displays the array with the defined dimensions: ‎ARRAY [1..3, 1..4, 1..2] OF DINT‎. The array consists of 3 * 4 * 2 = 24 elements.

    In an array of variable length, declare the dimension limits with an asterisk placeholder (‎*‎). Arrays of variable length are permitted to be used only in VAR_IN_OUT declarations of function blocks, methods, or functions.

    Example of a 2-dimensional array of variable length: ‎aiUnknownLengthData : ARRAY [*,*] OF INT;‎

  8. Click “OK”.

    In the dialog “Declare Variable” the field “Data type” displays the array.

  9. To modify the initialization values of the array, click the arrow button (_cds_icon_input_assistent) next to the “Initialization value” input field.

    The “Initialization Value” dialog opens.

  10. Select the line of the array element whose initialization value you wish to modify. Example: Select array component [1, 1, 1].

  11. Enter the desired initialization value in the input field below the list and click button “Use value on selected lines” (example: value ‎4‎).

    CODESYS displays the changed initialization value of the selected line.

  12. Click “OK”.

    In the “Initialization value” field of the “Declare Variable” dialog, CODESYS displays the initialization values of the array (example:‎{4, 23(0)]‎).

  13. You can optionally enter a “Comment” in the input field.

  14. Click “OK” in order to conclude the declaration of the array.

    CODESYS adds the declaration of the array to the declaration part of the programming object.