| Typ | Funktion |
| Beschreibung | Ersetzt einen Teil im String an Eingang IN1 durch den am Eingang IN2 anliegenden String. Es werden L Zeichen im String an IN1 durch den String an IN2 ersetzt, beginnend bei Zeichenposition P. |
| Hinweise |
- P darf nicht 0 sein. Die erste Position in einem String ist 1.
- Verwenden Sie nicht denselben String als Eingangs- und Ausgangsstring, da der Ausgangsstring aufaddiert wird bis der String zu kurz ist und gelöscht wird oder der String in einer Schleife verkleinert wird (abhängig vom Wert L).
- 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.
|
| Parameter | Eingänge
 IN1
| Datentyp: | STRING |
| Beschreibung: | Eingangszeichenfolge |
IN2
| Datentyp: | STRING |
| Beschreibung: | Zu ersetzender Teilstring. |
L
| Datentyp: | ANY_INT |
| Beschreibung: | Anzahl der zu ersetzenden Zeichen. |
P
| Datentyp: | ANY_INT |
| Beschreibung: | Position des ersten, zu ersetzenden Zeichens. |
Ausgang
OUT
| Datentyp: | STRING |
| 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(IN1) + 1(len(...) = aktuelle Länge der Zeichenfolge) | Leere Zeichenfolge '' |
| IN2 == OUT | 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.
|