CltsSomeBool
Diese Funktion prüft ob mindestens ein Arrayelement eines booleschen Arrays den gleichen Wert hat wie der bTest Funktionseingangsparameter.
Namensraum: Tc3_Collections
Bibliothek: Tc3_Collections (Tc3_Collections.compiled-library)
Syntax
FUNCTION CltsSomeBool : BOOL
VAR_INPUT
bTest: BOOL;
END_VAR
VAR_IN_OUT
in: ARRAY[*] OF BOOL;
END_VAR
VAR_OUTPUT
index: DINT;
END_VAR
Eingänge
Name | Typ | Beschreibung |
---|---|---|
bTest | BOOL | Testwert, der mit allen Arrayelementen verglichen wird. |
Ein/Ausgänge
Name | Typ | Beschreibung |
---|---|---|
in | ARRAY[*] OF BOOL | Die zu prüfende boolesche Array-Variable. |
Ausgänge
Name | Typ | Beschreibung |
---|---|---|
index | DINT | Index des ersten Arrayelements dessen Wert gleich dem bTest Funktionseingangsparameter ist. Dieser Wert ist 0 wenn der Funktionsrückgabewert „FALSE“ ist. |
Rückgabewert
Name | Typ | Beschreibung |
---|---|---|
CltsSomeBool | BOOL | „TRUE“ wenn mindestens ein Arrayelement den gleichen Wert hat wie der bTest Funktionseingangsparameter. „FALSE“ wenn keiner der Arrayelemente den gleichen 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]:=FALSE;
a[4]:=FALSE;
a[5]:=FALSE;
bResult:=CltsSomeBool(bTest:=TRUE, in:=a, index=>index);(* return value is FALSE, index = 0 *)
a[1]:=FALSE;
a[2]:=FALSE;
a[3]:=TRUE;
a[4]:=FALSE;
a[5]:=TRUE;
bResult:=CltsSomeBool(bTest:=TRUE, in:=a, index=>index);(* return value is TRUE, index = 3 *)
bResult:=CltsSomeBool(bTest:=FALSE, in:=a, index=>index);(* return value is TRUE, index = 1 *)