Beschreibung
Die Anweisung ersetzt die Anzahl von L Zeichen der ersten Zeichenkette (IN1) ab dem P. Zeichen (einschließlich) durch die vollständige zweite Zeichenkette (IN2).
-
Ist L gleich Null und P ungleich Null, wird die erste Zeichenkette zurückgeliefert.
-
Ist L gleich Null und P gleich Null, wird die zweite Zeichenkette der ersten Zeichenkette vorangestellt.
-
Ist L ungleich Null und P gleich Null oder Eins, wird ab dem 1. Zeichen (einschließlich) ersetzt.
-
Liegt P außerhalb der ersten Zeichenkette, wird die zweite Zeichenkette an die erste Zeichenkette angehängt.
-
Ist L und/oder P negativ, wird ein Leerstring ausgegeben und das BIE-Bit auf "0" gesetzt. Das BIE-Bit wird auch auf "0" gesetzt, wenn die Ergebniszeichenkette länger ist als die am Ausgangsparameter angegebene Variable; in diesem Fall wird die Ergebniszeichenkette auf die maximal eingerichtete Länge begrenzt.
Parameter
Die folgende Tabelle zeigt die Parameter der Anweisung "REPLACE". Die Eingangsparameter IN1 und IN2 und der Ausgangsparameter können nur mit einer symbolisch definierten Variable belegt werden.
|
Parameter |
Deklaration |
Datentyp |
Speicherbereich |
Beschreibung |
|---|---|---|---|---|
|
IN1 |
Input |
STRING* |
D, L |
STRING-Variable, in die eingesetzt wird |
|
IN2 |
Input |
STRING* |
D, L |
einzusetzende STRING-Variable |
|
L |
Input |
INT |
E, A, M, D, L oder Konstante |
Anzahl der zu ersetzenden Zeichen |
|
P |
Input |
INT |
E, A, M, D, L oder Konstante |
Position des 1. ersetzten Zeichens |
|
OUT |
Return |
STRING* |
D, L |
Ergebniszeichenkette |
|
* Definieren Sie die maximale Länge der Zeichenkette, wenn Sie bei der Schnittstellendeklaration den Datentyp STRING für eine temporäre Variable verwenden (weitere Information finden Sie in der Beschreibung des Datentyps). |
||||
Weitere Informationen zu den gültigen Datentypen finden Sie unter "Übersicht über die gültigen Datentypen".