| Typ | Funktion |
| Beschreibung | Fügt den String an IN2 in den String an IN1 ein und liefert den neu erzeugten String. Der String an IN2 wird in den String an IN1 nach der Position P eingefügt. |
| Hinweise |
- P darf nicht 0 sein. Die erste Position in einem String ist 1. Wenn Sie eine Zeichenfolge vor einer anderen einfügen möchten, verwenden Sie bitte die Funktion CONCAT.
- Verwenden Sie nicht denselben String als Eingangs- und Ausgangsstring, da der Ausgangsstring aufaddiert wird bis der String zu kurz ist und gelöscht wird.
|
| Parameter | Eingänge
 IN1
| Datentyp: | WSTRING |
| Beschreibung: | Eingangszeichenfolge |
IN2
| Datentyp: | WSTRING |
| Beschreibung: | String, der in den String an IN1 eingefügt werden soll. |
P
| Datentyp: | ANY_INT |
| Beschreibung: | Zeichenposition, nach der der String an IN2 eingefügt werden soll. |
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 |
| P <= 0 | Leere Zeichenfolge '' |
| P > len(IN1)(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.
|