ABAP - Schlüsselwortdokumentation →  ABAP - Referenz →  Interne Daten verarbeiten →  Zeichen- und Bytekettenverarbeitung →  Ausdrücke und Funktionen für die Zeichenkettenverarbeitung →  Zeichenkettenfunktionen →  Verarbeitungsfunktionen für zeichenartige Argumente → 

replace - Ersetzungsfunktion

Syntaxformen

1. ... replace( val = text [ off = off] [len = len]
               with = new ) ...

2. ... replace( val = text { sub = substring}|{ regex = regex}
               with = new [ case = case] [occ = occ] ) ...

Wirkung

Diese Funktion ersetzt ein Teilfeld von text mit der in new angegebenen Zeichenkette und gibt den geänderten Text zurück.

Das Teilfeld wird wie folgt bestimmt:

new ist eine zeichenartige Ausdrucksposition. Wenn diese eine feste Länge hat, werden schließende Leerzeichen nicht berücksichtigt.

Der Rückgabewert ist jeweils vom Typ string.

Hinweise

Beispiel

Das Ergebnis der folgenden Ersetzung ist "<title>Th<b>i</b>s <b>i</b>s the <i>T<b>i</b>tle</i> </title>". In einer HTML-Zeile wird ein bestimmter Buchstabe mit Format-Tags umgeben, wenn er nicht selbst innerhalb eines Tags steht.

DATA: html   TYPE string,
      repl   TYPE string.

html = `<title>This is the <i>Title</i></title>`.

repl   = `i`.

html = replace( val   = html
                regex = repl && `(?![^<>]*>)`
                with  = `<b>$0</b>`
                occ   =   0 ).

Ausnahmen

Behandelbare Ausnahmen

CX_SY_RANGE_OUT_OF_BOUNDS

CX_SY_REGEX_TOO_COMPLEX

CX_SY_STRG_PAR_VAL