Modelica.Math.BooleanVectors

Information

This library provides functions operating on vectors that have a Boolean vector as input argument.

Package Content

Name	Description
allTrue	Returns true, if all elements of the Boolean input vector are true ('and')
anyTrue	Returns true, if at least on element of the Boolean input vector is true ('or')
countTrue	Returns the number of true entries in a Boolean vector
enumerate	Enumerates the true entries in a Boolean vector (0 for false entries)
firstTrueIndex	Returns the index of the first true element of a Boolean vector
index	Returns the indices of the true entries of a Boolean vector
oneTrue	Returns true, if exactly one element of the Boolean input vector is true ("xor")

Modelica.Math.BooleanVectors.allTrue

Information

Syntax

allTrue(b);

Description

Returns true if all elements of the Boolean input vector b are true. Otherwise the function returns false. If b is an empty vector, i.e., size(b,1)=0, the function returns false.

Example

  Boolean b1[3] = {true, true, true};
  Boolean b2[3] = {false, true, false};
  Boolean r1, r2;
algorithm
  r1 = allTrue(b1);  // r1 = true
  r2 = allTrue(b2);  // r2 = false

See also

anyTrue, countTrue, enumerate, firstTrueIndex, index, and oneTrue.

Inputs

Name	Description
b[:]	Boolean vector

Outputs

Name	Description
result	= true, if all elements of b are true

Modelica.Math.BooleanVectors.anyTrue

Information

Syntax

anyTrue(b);

Description

Returns true if at least one elements of the input Boolean vector b is true. Otherwise the function returns false. If b is an empty vector, i.e., size(b,1)=0, the function returns false.

Example

  Boolean b1[3] = {false, false, false};
  Boolean b2[3] = {false, true, false};
  Boolean r1, r2;
algorithm
  r1 = anyTrue(b1);  // r1 = false
  r2 = anyTrue(b2);  // r2 = true

See also

allTrue, countTrue, enumerate, firstTrueIndex, index, and oneTrue.

Inputs

Name	Description
b[:]

Outputs

Name	Description
result

Modelica.Math.BooleanVectors.countTrue

Information

Syntax

countTrue(b);

Description

This function returns the number of true entries in a Boolean vector b.

Example

countTrue({false, true, false, true}) returns 2.

See also

allTrue, anyTrue, enumerate, firstTrueIndex, index, and oneTrue.

Inputs

Name	Description
b[:]	Boolean vector

Outputs

Name	Description
n	Number of true entries

Modelica.Math.BooleanVectors.enumerate

Information

Syntax

enumerate(b);

Description

This function returns an integer vector that consecutively numbers the true entries in a Boolean vector b. The false entries are indicated by 0.

Example

enumerate({false, true, false, true}) returns {0,1,0,2}.

See also

allTrue, anyTrue, countTrue, firstTrueIndex, index, and oneTrue.

Inputs

Name	Description
b[:]	Boolean vector

Outputs

Name	Description
enumerated[size(b, 1)]	Indices of the true entries (increasing order; 0 for false entries)

Modelica.Math.BooleanVectors.firstTrueIndex

Information

Syntax

firstTrueIndex(b);

Description

Returns the index of the first true element of the Boolean vector b. If no element is true or b is an empty vector (i.e., size(b,1)=0) the function returns 0.

Example

  Boolean b1[3] = {false, false, false};
  Boolean b2[3] = {false, true, false};
  Boolean b3[4] = {false, true, false, true};
  Integer r1, r2, r3;
algorithm
  r1 = firstTrueIndex(b1);  // r1 = 0
  r2 = firstTrueIndex(b2);  // r2 = 2
  r3 = firstTrueIndex(b3);  // r3 = 2

See also

allTrue, anyTrue, countTrue, enumerate, index, and oneTrue.

Inputs

Name	Description
b[:]

Outputs

Name	Description
index

Modelica.Math.BooleanVectors.index

Information

Syntax

index(b);

Description

This function returns an integer vector that contains indices to the true entries in a Boolean vector b. The number of entries in the integer vector is the number of true entries in b.

Example

See also

allTrue, anyTrue, countTrue, enumerate, firstTrueIndex, and oneTrue.

Inputs

Name	Description
b[:]	Boolean vector

Outputs

Name	Description
indices[countTrue(b)]	Indices of the true entries

Modelica.Math.BooleanVectors.oneTrue

Information

Syntax

oneTrue(b);

Description

Returns true if exactly one element of the input Boolean vector b is true. Otherwise the function returns false. If b is an empty vector, i.e., size(b,1)=0, the function returns false.

Example

  Boolean b1[3] = {false, false, false};
  Boolean b2[3] = {false, true, false};
  Boolean b3[3] = {false, true, true};
  Boolean r1, r2, r3;
algorithm
  r1 = oneTrue(b1);  // r1 = false
  r2 = oneTrue(b2);  // r2 = true
  r3 = oneTrue(b3);  // r3 = false

See also

allTrue, anyTrue, countTrue, enumerate, firstTrueIndex, and index.

Inputs

Name	Description
b[:]

Outputs

Name	Description
result