Creating an Array or Matrix (BDE)

  1. In the Elements palette or toolbar, click the Array or Matrix button.

    The properties editor is opened. Since arrays and matrices are created as variables, the Non-Volatile attribute is deactivated.

  2. In the Kind combo box, select Variable or Parameter.

  3. Set the dimension(s) and the variant size(s) of the array or matrix.

    1. In the X (and Y) fields, enter the maximum X (and Y) size of the element.

    2. To specify a variant size, use the Variant Size field to select the system constants you want to use as dimension values.

      Both normal and user-defined system constants can be used. The value of a system constant should be in the range 1 ... X (or 1 ... Y).

    3. To specify a variable size, use the Variant Size field to select *.

      The X (and Y) fields are disabled.

  4. In the Basic Type combo box, assign the element type.

    The basic scalar types and Enumeration and Record are available. If you select Enumeration or Record, the Closedfollowing happens.

    The Component combo box appears. It offers all enumerations or records in the database/workspace for selection.

    • Select a suitable enumeration or record.
  5. Adjust the other element properties as described in Editing the Configuration of an Array or Matrix, then click OK.

    If you exceeded the maximum size of the element axes in the Dimension fields, the following warning opens.

    The possible *Closed = dimension or dimension x or dimension y max size has to be between 1 and 65535.
    Please adjust your settings.

    If the product of the X and Y dimensions of a matrix exceeds the maximum size of the matrix, the following warning opens.

    The possible matrix elements max size of 1048576 has been exceeded. Please adjust your setting <number>.

    • Confirm the warning with OK and adapt the dimension(s).

    If you selected a system constant whose value is outside the allowed range, the following warning opens:

    The Attribute * Size (<n>) is not in the allowed range of >0 and max value (<i>)

    ClosedProceed as follows.

    1. If you want to suppress the warning for future occasions, activate Don't show this hint again.

      You can revoke this setting in the ASCET options window, Confirmation Dialogs node.

    2. To return to the properties editor, click Cancel.
    3. To select the system constant anyway, confirm the warning with OK.
  6. Place the element in the drawing area.
  7. If necessary, re-open the properties editor and adjust the size.

Note

Creating an array or matrix of kind Message is described in Creating a Message.

If you want to optimize the generated initialization code of arrays/matrices of scalar or enumeration type, activate the Generating Sparse Arrays target option. See also Initialization of Arrays and Matrices.

See also

Editing the Configuration of an Array or Matrix

Variant Size for Arrays and Matrices

Variable Size for Arrays and Matrices

Initialization of Arrays and Matrices

ASCET Options – Targets Node

Scalar Types

Constants and System Constants

Reserved Keywords

Inserting an Element into a Connection

Creating a Message