MID-Baustein

Kurz-Information

NameMID
→POE-Typ→Funktion
KategorieIEC-Baustein, String, Baustein mit interner Fehlerdiagnose
Konform zur →IEC-Norm

(error) derzeit eingeschränkt
(IEC fordert Datentyp ANY_STRING für den Eingang IN und den Ergebniswert und daher auch diesen Datentyp: WSTRING. Dieser Datentyp wird derzeit für den Baustein nicht unterstützt.)

Grafische Schnittstelle

Verfügbar ab

Version 1.32.0 (für logi.CAD 3 )

Funktionalität

Der Baustein liefert einen Teilstring eines anderen Strings.

Am Eingang IN geben Sie eine Zeichenkette ein. Am Eingang L geben Sie die Anzahl der zu liefernden Zeichen ein (= Länge des zu liefernden Teils) und am Eingang P die Startposition in der Zeichenkette.

Spezialfälle (siehe unter "Beispiel für Verwendung im ST-Editor"):

  • Bei  L = 0 liefert der Baustein den leeren String ''. Der Ausgang ENO wird hier auf den Wert TRUE gesetzt.
  • Falls ein negativer Wert bei L eingegeben ist, werden die entsprechenden Zeichen vor der Position P im String geliefert. Hier wird der Ausgang ENO auf den Wert FALSE gesetzt. Falls auf Zeichen außerhalb des sichtbaren Bereichs zugegriffen würde (vor Position 1), liefert der Baustein den leeren String ''.
  • Falls der Wert 0 oder ein negativer Wert bei P eingegeben ist, werden keine Zeichen geliefert. Auch hier wird der Ausgang ENO auf den Wert FALSE gesetzt.
  • Falls der Wert für L und/oder P > die Länge des Strings für IN ist, werden keine Zeichen geliefert oder nur die Zeichen, die im sichtbaren Bereich liegen. Auch hier wird der Ausgang ENO auf den Wert FALSE gesetzt.

(info)  logi.CAD 3  bestimmt die Positionen von Zeichen in einem String so: 1, 2, ..., n. Dabei entspricht 1 dem Zeichen ganz links im String und n der Länge des Strings.
Kombinationen von 3 Zeichen, beginnend mit dem Dollar-Zeichen ($) und gefolgt von 2 Hexadezimal-Ziffern, gelten als ein einziges Zeichen. Beispiel: Der String '$B15' (entspricht '±5') besteht somit aus 2 Zeichen. Weitere Beispiele für diese Kombinationen finden Sie unter →Zeichenfolge-Literal.

Eingänge, Ergebniswert


Bezeichner→DatentypBeschreibung
Eingänge:INSTRING

Eingangswert

L
USINTUINTUDINTULINTSINTINTDINT oder LINT
(entspricht dem →allgemeinen Datentyp ANY_INT
Anzahl der zu liefernden Zeichen
P
USINTUINTUDINTULINTSINTINTDINT oder LINT
(entspricht dem →allgemeinen Datentyp ANY_INT

Startposition im Eingangswert

Ergebniswert:STRING

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 den vermeintlichen Ergebniswert.
Falls der Ergebniswert im zur Verfügung stehenden Speicher nicht abgebildet werden kann (der Ergebniswert ist zu groß), wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) gesetzt.

Zusätzlich prüft der Baustein die anliegenden Werte, ob auf nicht vorhandene Zeichenpositionen im String zugegriffen wird. Dies ist der Fall, wenn der Wert für L oder P > die Länge des Stringwerts für IN ist, ein negativer Wert bei L oder P eingegeben ist oder der Wert 0 bei P eingegeben ist. Auch in diesen Fällen wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) zurückgesetzt.

Beispiel für Verwendung im ST-Editor

PROGRAM Test
    VAR
        result1, result3, result4, result5, result6, result7, result8 : STRING[8];
        result2 : STRING[2];
        CheckENO1, CheckENO2, CheckENO3, CheckENO4, CheckENO5, CheckENO6, CheckENO7, CheckENO8 : BOOL;
    END_VAR
    result1 := MID(IN := 'astring', L := 3, P := 4, ENO => CheckENO1);
               (* The variable 'result1' evaluates to <'rin'>. The variable 'CheckENO1' evaluates to 'TRUE'. *)
    result2 := MID(IN := 'astring', L := 3, P := 4, ENO => CheckENO2);
               (* The variable 'result2' evaluates to <'ri'>. The variable 'CheckENO2' evaluates to 'FALSE'. Reason: 'result2' is declared with length '2' and the would-be return value exceeds this length. *)               
    result3 := MID(IN := 'astring', L := 0, P := 4, ENO => CheckENO3);
               (* The variable 'result3' evaluates to <''>, i.e an empty string. The variable 'CheckENO3' evaluates to 'TRUE'. Reason: value '0' for 'L' *)
    result4 := MID(IN := 'astring', L := -2, P := 4, ENO => CheckENO4);
               (* The variable 'result4' evaluates to <'st'>. The variable 'CheckENO4' evaluates to 'FALSE'. Reason: negative value for 'L' *)
    result5 := MID(IN := 'astring', L := -2, P := 1, ENO => CheckENO5);
               (* The variable 'result5' evaluates to <''>, i.e an empty string. The variable 'CheckENO5' evaluates to 'FALSE'. Reason: negative value for 'L' *)
               (* None of the characters are returned because characters outside the visible range would be accessed. *)
    result6 := MID(IN := 'astring', L := 3, P := -1, ENO => CheckENO6);
               (* The variable 'result6' evaluates to <''>, i.e an empty string. The variable 'CheckENO6' evaluates to 'FALSE'. Reason: negative value for 'L' *) 
    result7 := MID(IN := 'astring', L := 13, P := 2, ENO => CheckENO7);
               (* The variable 'result7' evaluates to <'string'>, i.e an empty string. The variable 'CheckENO7' evaluates to 'FALSE'. Reason: value for 'L' > the length of string 'astring' *)
    result8 := MID(IN := 'deviation: $B15', L := 2, P := 12, ENO => CheckENO8);
               (* The variable 'result8' evaluates to <'$B15'>, i.e an empty string. The variable 'CheckENO8' evaluates to 'TRUE'. *)
END_PROGRAM

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.