| 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.
- 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.
|
| 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.
|