| 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 ist direkt mit einer anderen FU verbunden, werden temporäre String-Variablen mit einer Größe von 80 verwendet. Bei der Berechnung bzw. Verwendung tritt ein Fehler auf. Ist der zurückgegebene String länger als 80 Zeichen, wird die Meldung 'String zu kurz' ausgegeben und am Ausgang ein leerer String zurückgegeben oder es wird der letzte Wert gehalten. 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
 IN1
| Datentyp: | WSTRING |
| Beschreibung: | Eingangszeichenfolge |
IN2
| Datentyp: | WSTRING |
| 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: | 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(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.
|