MAX_2D_ARRAY-Baustein

Kurz-Information

Name	`MAX_2D_ARRAY_LINT, MAX_2D_ARRAY_ULINT, MAX_2D_ARRAY_LREAL`
→POE-Typ	→Funktion
Kategorie	Standard (non-safe), NumericEnh, Baustein mit interner Fehlerdiagnose
Konform zur →IEC-Norm	nicht in IEC-Norm vorgesehen
Grafische Schnittstelle	, ,
Verfügbar ab	Version 1.45.0 (für Neuron Power Engineer) – Anfangsvariante Version 2.0.9 (für Bibliothek `Standard`) – grafische Schnittstelle mit Ein-/Ausgangsvariable Version 3.8.0 (für Bibliothek `Standard (non-safe)`): Baustein in diese Bibliothek verschoben

Funktionalität

Der Baustein liefert den größten aller Werte eines Arrays mit 2 Dimensionen, das über den Eingang A eingegeben ist. Dabei werden nur die ersten M Zeilen und N Spalten berücksichtigt. Das Array muss mindestens M Zeilen und N Spalten enthalten.

Eingänge, Ergebniswert

`MAX_2D_ARRAY_LINT`	Bezeichner	→Datentyp	Beschreibung
Ein-/Ausgänge (VAR_IN_OUT):	`A`	`ARRAY [,] OF SINT, INT, DINT or LINT` (entspricht dem →allgemeinen Datentyp `ANY_SIGNED`)	Array von variabler Länge
Eingänge:	`M`	`UINT`	Anzahl der zu berücksichtigenden Zeilen
Eingänge:	`N`	`UINT`	Anzahl der zu berücksichtigenden Spalten
Ergebniswert:	–	`LINT`	Maximumwert `0` im Fehlerfall oder wenn `M` oder `N` = `0`

`MAX_2D_ARRAY_ULINT`	Bezeichner	→Datentyp	Beschreibung
Ein-/Ausgänge (VAR_IN_OUT):	`A`	`ARRAY [,] OF USINT, UINT, UDINT or ULINT` (entspricht dem →allgemeinen Datentyp `ANY_SIGNED`)	Array von variabler Länge
Eingänge:	`M`	`UINT`	Anzahl der zu berücksichtigenden Zeilen
Eingänge:	`N`	`UINT`	Anzahl der zu berücksichtigenden Spalten
Ergebniswert:	–	`ULINT`	Maximumwert `0` im Fehlerfall oder wenn `M` oder `N` = `0`

`MAX_2D_ARRAY_LREAL`	Bezeichner	→Datentyp	Beschreibung
Ein-/Ausgänge (VAR_IN_OUT):	`A`	`ARRAY [,] OF REAL, LEAL` (entspricht dem →allgemeinen Datentyp `ANY_REAL`)	Array von variabler Länge
Eingänge:	`M`	`UINT`	Anzahl der zu berücksichtigenden Zeilen
Eingänge:	`N`	`UINT`	Anzahl der zu berücksichtigenden Spalten
Ergebniswert:	–	`LREAL`	Maximumwert `0.0` im Fehlerfall oder wenn `M` oder `N` = `0`

Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Informieren Sie sich unter:

"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.

Interne Fehlerdiagnose für Baustein

Der Baustein prüft, ob die Größe des Arrays A mindestens M Zeilen und N Spalten beträgt. Ist dies nicht der Fall, wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) zurückgesetzt.

Beispiel für Verwendung im ST-Editor

FUNCTION_BLOCK ExampleMax2DArray

VAR

        inputArray : ARRAY [1..2, -1..1] OF LINT := [2( [1, 2, 3])];

        result1, result2 : LINT;

        enoCheck1, enoCheck2 : BOOL;

    END_VAR

    result1 := MAX_2D_ARRAY_LINT(A := inputArray, M := 2, N := 3, ENO => enoCheck1);

    // 'result1' evaluates to value '3'. 'enoCheck1' evaluates to 'TRUE'.

    ENO := AND(result1 = 3, enoCheck1);

    result2 := MAX_2D_ARRAY_LINT(A := inputArray, M := 3, N := 2, ENO => enoCheck2);

    // 'enoCheck2' evaluates to 'FALSE' because 'inputArray' has only 2 rows.

    // 'result2' evaluates to '0'.

    ENO := AND(ENO, result2 = 0, NOT(enoCheck2));

END_FUNCTION_BLOCK

Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.