If the search pattern contains LINE_END, the matched
line break will be removed, causing the next line to
be appended to the current line. To use LINE_END to
only provide context for the search, the line break
must be reinserted. This is done using the parameter
convert_linefeeds.
If the convert_linefeeds parameter is specified as ON,
any linefeed characters appearing in the replacement
string are removed and the built-in DECTPU procedure
SPLIT_LINE is called at the point of the linefeed
character.
The following filter replaces any numbers that are the
last characters on a line with the string "x":
global_replace (number+LINE_END, "x"+lf,,,ON)
The "lf" pattern is defined as a linefeed character in
the supplied definitions file.
If a LINE_END is included in a partial pattern
variable, the line break can be retained by specifying
the second optional parameter to the DECTPU STR
procedure as a linefeed character, for example:
global_replace (number+(LINE_END@sep),
'"x"+STR(sep,lf)',,ON,ON)
The second parameter to STR specifies the string that
line breaks occurring in the first parameter should be
converted to. Line breaks are retained by specifying
the linefeed character and setting the parameter
convert_linefeeds to ON.