| Typ | Funktion |
| Beschreibung | Ermittelt eine Teilfolge aus einer mit Eingang IN verbundenen Zeichenfolge. L Zeichen aus IN werden ermittelt, beginnend bei der Zeichenposition P. |
| Hinweise |
- P darf nicht 0 sein. Die erste Position in einem String ist 1.
- Der gleiche String kann nicht als Eingangs- und als Ausgangsstring verwendet werden. Für diesen Fall sollte am Ausgang eine Zwischenvariable verwendet werden. Diese Zwischenvariable muss anschließend dem Eingangswert zugewiesen werden.
- Ist der zurückgegebene String länger als 80 Zeichen und die FU oder der FB ist direkt mit einer anderen FU oder einem anderen FB verbunden, werden temporäre String-Variablen mit einer Größe von 80 verwendet. Bei der Berechnung bzw. Verwendung tritt ein Fehler auf. Verwenden Sie für diesen Fall eine lokale Zwischenvariable.
- Probleme bei der Berechnung von Position und Länge: Zeichen in WSTRING können eine Größe von 2 Byte oder 4 Byte haben. Aus diesem Grund kann es zu Berechnungsproblemen bei 4-Byte Zeichen-STRINGs mit 2-Byte-orientierter Position und Länge kommen.
|
| Parameter | Eingänge
 IN
| Datentyp: | WSTRING |
| Beschreibung: | Eingangszeichenfolge |
L
| Datentyp: | ANY_INT |
| Beschreibung: | Anzahl der zu entnehmenden Zeichen. |
P
| Datentyp: | ANY_INT |
| Beschreibung: | Position des ersten zu entnehmenden Zeichens. |
Ausgang
OUT
| Datentyp: | WSTRING |
| Beschreibung: | Ausgangsstring |
|
| Fehlerverhalten | Fehlerverhalten
Die folgende Tabelle zeigt die Fehler, die bei der Ausführung der Funktion auftreten können, und den von der Funktion im entsprechenden Fehlerfall zurückgegebenen Wert.
| Fehlerfall | Ausgabewert |
| L < 0 | Leere Zeichenfolge '' |
| P <= 0 | Leere Zeichenfolge '' |
| P+L > len(IN) + 1(len(...) = aktuelle Länge der Zeichenfolge) | Leere Zeichenfolge '' |
| L > maxlen(OUT)(maxlen(...) = maximal erlaubte Länge der Zeichenfolge (maxlen(Standardstring) = 80)) | Leere Zeichenfolge '' |
| Ergebnisstring zu kurz | Leere Zeichenfolge '' |
Tritt einer der aufgeführten Fehler auf, wird ein String-Fehler im Online-Protokoll des MELDUNGEN-Fensters ausgegeben.
Hinweis
Steuerungstopp bei String-Fehler: Sie können einstellen, ob die Steuerung bei einem String-Fehler automatisch gestoppt werden soll. Dies gibt Ihnen im Fehlerfall die Möglichkeit, den Fehler in Ihrem Projekt zu lokalisieren. Um bei einem String-Fehler die Steuerung automatisch zu stoppen, aktivieren Sie das Symbol  in der Symbolleiste des Cockpits. |
|
| Zusätzliche Informationen | EN/ENO-Verhalten
Die POE wird nur dann ausgeführt, wenn TRUE am Eingang EN anliegt. Wenn EN = FALSE ist, wird die POE nicht ausgeführt und ENO auf FALSE gesetzt (FU/FB inaktiv).
Wenn bei der Ausführung der Funktion einer der unter "Fehlerverhalten" aufgeführten Fehler auftritt, wird ENO auf FALSE gesetzt.
|