CONTENTS | INDEX | PREV | NEXT
SYNTAX : RANGE @S / STRING /
: RANGE @S / /
RESULTING ARGUMENT: Number of matches
FUNCTION : Search for a 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 match found. 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
search command. This character is followed by the
search string, which is terminated by the 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 @s / test / =
Will find the last occurrence of string test and show
the number of occurrences.
NOTE 1 : Search-behaviour is governed by the Search Mode setting
(see CTRL_X)
NOTE 2 : If the search string is empty (as in h @s / /) 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 he search string.
NOTE 5 : The RETURN character is allowed anywhere in the search
string.
MATRIX