MIN_2D_ARRAY-Baustein

Kurz-Information

Name

MIN_2D_ARRAY_LINT, MIN_2D_ARRAY_ULINT, MIN_2D_ARRAY_LREAL

→POE-Typ

→Funktion

Kategorie

IEC-Baustein, NumericEnh, Baustein mit interner Fehlerdiagnose

Konform zur →IEC-Norm

images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/add.svg nicht in IEC-Norm vorgesehen

Grafische Schnittstelle

images/download/thumbnails/414782023/MIN_2D_ARRAY_LINT-version-1-modificationdate-1535032408478-api-v2.png , images/download/thumbnails/414782033/MIN_2D_ARRAY_ULINT-version-1-modificationdate-1535032471815-api-v2.png , images/download/thumbnails/414782028/MIN_2D_ARRAY_LREAL-version-1-modificationdate-1535032441449-api-v2.png

Verfügbar ab

  • Version 1.45.0 (für logi.CAD 3) – Anfangsvariante

  • Version 2.0.9 (für Bibliothek Standard) – grafische Schnittstelle mit Ein-/Ausgangsvariable

Funktionalität

Der Baustein liefert den kleinsten 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

MIN_2D_ARRAY_LINT

Bezeichner

→Datentyp

Beschreibung

Ein-/Ausgänge
(VAR_IN_OUT):

A

ARRAY [*,*] OF SINT, INT, DINT oder LINT(entspricht dem →allgemeinen Datentyp ANY_SIGNED)

Array von variabler Länge

Eingänge:

M

UINT

Anzahl der zu berücksichtigenden Zeilen

N

UINT

Anzahl der zu berücksichtigenden Spalten

Ergebniswert:

LINT

  • Minimalwert

  • 0 im Fehlerfall oder wenn M oder N = 0

MIN_2D_ARRAY_ULINT

Bezeichner

→Datentyp

Beschreibung

Ein-/Ausgänge
(VAR_IN_OUT):

A

ARRAY [*,*] OF USINT, UINT, UDINT oder ULINT(entspricht dem →allgemeinen Datentyp ANY_UNSIGNED)

Array von variabler Länge

Eingänge:

M

UINT

Anzahl der zu berücksichtigenden Zeilen

N

UINT

Anzahl der zu berücksichtigenden Spalten

Ergebniswert:

ULINT

  • Minimalwert

  • 0 im Fehlerfall oder wenn M oder N = 0

MIN_2D_ARRAY_LREAL

Bezeichner

→Datentyp

Beschreibung

Ein-/Ausgänge
(VAR_IN_OUT):

A

ARRAY [*,*] OF REAL, LREAL
(entspricht dem →allgemeinen Datentyp ANY_REAL)

Array von variabler Länge

Eingänge:

M

UINT

Anzahl der zu berücksichtigenden Zeilen

N

UINT

Anzahl der zu berücksichtigenden Spalten

Ergebniswert:

LREAL

  • Minimalwert

  • 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.

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 Wert FALSE (oder eine Entsprechung) zurückgesetzt.

Beispiel für Verwendung im ST-Editor

FUNCTION_BLOCK ExampleMin2DArray
VAR
inputArray : ARRAY [1..2, -1..1] OF LINT := [2( [1, 2, 3])];
result1, result2 : LINT;
enoCheck1, enoCheck2 : BOOL;
END_VAR
result1 := MIN_2D_ARRAY_LINT(A := inputArray, M := 2, N := 3, ENO => enoCheck1);
// 'result1' evaluates to value '1'. 'enoCheck1' evaluates to 'TRUE'.
// check the results
ENO := AND(result1 = 1, enoCheck1);
result2 := MIN_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'.
// check the results
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.