CONTENTS | INDEX | PREV | NEXT
SYNTAX : RANGE @R / STRING 1 / STRING 2 /
: RANGE @R / / STRING 2 /
RESULTING ARGUMENT: Number of changes
FUNCTION : Replace a character string by another character string
as many times as possible within the range. After
execution, the cursor (and implicitly the value of . )
is positioned immediately after the last string replaced.
It is not necessary to position the cursor within the
range; it is automatically moved to the beginning of the
range before the search starts.
The modification character (delimiter) immediately
follows the command in the command sequence. This
character will be used instead of the ESC in the normal
replace command. This character is followed by the
first string, which is terminated by the modification
character. The second string follows, which is in turn
terminated by another identical modification character.
No error-condition will ever result; the number of
matches (whether 0 or higher) is simply returned.
RANGE : START,END
START : the buffer position to start at
END : the buffer position to stop at
EXAMPLE : h @r / hello ESC / world / =
Will replace the string hello ESC by world as many
times as possible, and show the number of replacements.
NOTE 1 : Search-behaviour is governed by the Search Mode setting
(see CTRL_X)
NOTE 2 : If the first string is empty (as in h @r / / world /)
then the previous search string is reused.
NOTE 3 : The search string (used for both search and replace
commands) is accessable in register _ at all times.
NOTE 4 : The modification character is arbitrary. It must not
occur in either search- or replacement string.
NOTE 5 : The RETURN character is allowed anywhere in the search-
or replacement string.
MATRIX