CONTENTS | INDEX | PREV | NEXT
SYNTAX : RANGE S STRING ESC
: RANGE S ESC
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 string immediately follows the command in the
command sequence, and is terminated by an ESC.
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 ESC =
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 string is empty (the terminating ESC follows the
command, as in h s ESC) 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 ESC character must not occur in the search string.
NOTE 5 : The RETURN character is allowed anywhere in the search
string.
MATRIX