CONTENTS | INDEX | PREV | NEXT

SYNTAX            : ARG @S / STRING /
                  : ARG @S / /

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 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.

                    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 /
                    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 search string is empty (as in @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