Skip to main content
Version: Next

ARRAY BOOLEAN

ARRAY BOOLEAN ( arrayName ; size {; size2} )

ParameterTypeDescription
arrayNameArray🡒Name of the array
sizeLongint🡒Number of elements in the array or Number of rows if size2 is specified
size2Longint🡒Number of columns in a two-dimensional array

Description

The ARRAY BOOLEAN command creates and/or resizes an array of Boolean elements in memory.

The arrayName parameter is the name of the array.

The size parameter is the number of elements in the array.

The size2 parameter is optional; if size2 is specified, the command creates a two-dimensional array. In this case, size specifies the number of rows and size2 specifies the number of columns in each array. Each row in a two-dimensional array can be treated as both an element and an array. This means that while working with the first dimension of the array, you can use other array commands to insert and delete entire arrays in a two-dimensional array.

While applying ARRAY BOOLEAN to an existing array:

  • If you enlarge the array size, the existing elements are left unchanged, and the new elements are initialized to False.
  • If you reduce the array size, the last elements deleted from the array are lost.

Tip: In some contexts, an alternative to using Boolean arrays is using an Integer array where each element “means true” if different from zero and “means false” if equal to zero.

Example 1

This example creates a process array of 100 Boolean elements:

 ARRAY BOOLEAN(abValues;100)

Example 2

This example creates a local array of 100 rows of 50 Boolean elements:

 ARRAY BOOLEAN($abValues;100;50)

Example 3

This example creates an interprocess array of 50 Boolean elements and sets each even element to True:

 ARRAY BOOLEAN(◊abValues;50)
 For($vlElem;1;50)
    ◊abValues{$vlElem}:=(($vlElem%2)=0)
 End for

See also

ARRAY INTEGER