CltsEveryBool

Diese Funktion prüft ob alle Elemente eines booleschen Arrays den gleichen Wert haben wie der bTest Funktionseingangsparameter.

Namensraum: Tc3_Collections
Bibliothek: Tc3_Collections (Tc3_Collections.compiled-library)

Syntax

FUNCTION CltsEveryBool : BOOL
VAR_INPUT
    bTest: BOOL;
END_VAR
VAR_IN_OUT
    in: ARRAY[*] OF BOOL;
END_VAR
VAR_OUTPUT
    index: DINT;
END_VAR

CltsEveryBool 1: Eingänge

Name

Typ

Beschreibung

bTest

BOOL

Testwert, der mit allen Arrayelementen verglichen wird.

CltsEveryBool 2: Ein-/Ausgänge

Name

Typ

Beschreibung

in

ARRAY[*] OF BOOL

Die zu prüfende boolesche Array-Variable.

CltsEveryBool 3: Ausgänge

Name

Typ

Beschreibung

index

DINT

Indexnummer des ersten Arrayelements dessen Wert ungleich dem bTest Eingangsparameter ist. Dieser Wert ist 0 wenn der Funktionsrückgabeparameter „TRUE“ ist.

CltsEveryBool 4: Rückgabewert

Name

Typ

Beschreibung

CltsEveryBool

BOOL

„TRUE“ wenn alle Arrayelemente den gleichen Wert haben wie der bTest Funktionseingangsparameter. „FALSE“ wenn mindestens ein Arrayelement einen ungleichen Wert hat wie der bTest Funktionseingangsparameter.

Beispiel

PROGRAM MAIN
VAR
    a: ARRAY[1..5] OF BOOL;
    index: DINT;
    bResult: BOOL;
END_VAR
a[1]:=FALSE;
a[2]:=FALSE;
a[3]:=TRUE;
a[4]:=FALSE;
a[5]:=TRUE;
bResult:=CltsEveryBool(bTest:=TRUE, in:=a, index=>index);(* return value is FALSE, index = 1 *)
bResult:=CltsEveryBool(bTest:=FALSE, in:=a, index=>index);(* return value is FALSE, index = 3 *)
a[1]:=TRUE;
a[2]:=TRUE;
a[4]:=TRUE;
bResult:=CltsEveryBool(bTest:=TRUE, in:=a, index=>index);(* return value is TRUE, index = 0 *)