SAP NetWeaver AS ABAP Release 740, ©Copyright 2014 SAP AG. All rights reserved.
ABAP Keyword Documentation → ABAP − Reference → Processing Internal Data → Character String and Byte String Processing → Statements for Character String and Byte String Processing → REPLACE →Syntax
REPLACE [{FIRST OCCURRENCE}|{ALL OCCURRENCES} OF] pattern
IN [section_of] dobj WITH new
[IN {CHARACTER|BYTE} MODE]
[replace_options].
Extras:
1. ... {FIRST OCCURRENCE}|{ALL OCCURRENCES} OF
2. ... IN {CHARACTER|BYTE} MODE
Effect
When replacing by pattern, the data object dobj is scanned for the character or byte strings specified in pattern and the occurrences are replaced by the content of the operand new. new is a functional operand position.
If a regular expression is used in pattern, special replacement patterns can be used in new that permit a reference to each occurrence.
The syntax and effect of the addition section_of
are the same as searching for a substring in a data object using the statement
FIND, and the same handleable exception can be raised. The addition
MODE defines whether a character or byte string is processed, and the addition
replace_options provides additional options for controlling and analyzing the statement.
Note
The REPLACE IN TABLE statement can be used to make replacements in internal tables.
... {FIRST OCCURRENCE}|{ALL OCCURRENCES} OF
Effect
The optional addition {FIRST OCCURRENCE}|{ALL OCCURRENCES} OF specifies whether only the first occurrence or all occurrences of the search pattern are replaced by the content of new. If the FIRST OCCURRENCE addition is specified or none of the additions are specified, the first occurrence is replaced. If ALL OCCURRENCES is used, all non-overlapping occurrences are replaced.
If substring is an empty string in pattern or is of the type c, d, n, or t and only contains blank characters, the position before the first character or byte of the search range is located when the first occurrence is being searched for, and the content of new is inserted in front of the first character or byte. If a search for all occurrences is taking place, the exception CX_SY_REPLACE_INFINITE_LOOP is raised in this case.
If regex contains a regular expression in the pattern, and this expression matches the empty character string, then the content of new is also inserted before the first character when the first occurrence is being searched for. If all occurrences are being searched for, the content of new is inserted in front of the first character, in all spaces that do not come before or inside a match, and after the last character.
Note
If the addition ALL OCCURRENCES is used, no recursions take place. This means
that, if the statement finds further occurrences of the search pattern, they are not replaced automatically, since this could create endless loops.
Example
After being replaced, text contains the value "x-xx-x".
DATA text TYPE string VALUE '-uu-'.
REPLACE ALL OCCURRENCES OF REGEX 'u*' IN text WITH 'x'.
Example
After being replaced, text still contains the substring "abcde" once.
DATA text TYPE string VALUE 'xxababcdcdxx'.
REPLACE ALL OCCURRENCES OF 'abcd' IN text WITH ``.
... IN {CHARACTER|BYTE} MODE
Effect
The optional IN {CHARACTER|BYTE} MODE addition determines whether
character string or byte string processing
is carried out. If the addition is not specified, character string processing is carried out. Depending
on the processing type, dobj, new, and substring
in pattern have to be character-like or byte-like. If
regular expressions are used in pattern, only character string processing is permitted.
Note
To be replaced by character-like content that contains trailing blanks, new has to have the data type string.
Catchable Exceptions
CX_SY_REPLACE_INFINITE_LOOP
CX_SY_INVALID_REGEX
CX_SY_REGEX_TOO_COMPLEX
CX_SY_INVALID_REGEX_FORMAT