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