CONTENTS | INDEX | PREV | NEXT
SYNTAX : ARG S STRING ESC
: ARG S ESC
RESULTING ARGUMENT: None
FUNCTION : Search for a character string as many times as specified,
or as many times as the string exists (whichever is
smaller). Search starts at the current position in the
buffer. After execution, the cursor (and implicitly the
value of . ) is positioned immediately after the last
match found.
The string immediately follows the command in the
command sequence, and is terminated by an ESC.
A negative argument forces backward search in the buffer.
In these cases, the cursor is positioned before the last
match found (counting backwards!).
If not all requested matches are found, an error is
raised.
ARGUMENT : The number of times to perform the search-action.
DEFAULT : 1
EXAMPLE : 3 s test ESC
Will find the third occurrence of string test.
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 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