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