isearch-forward - Search forward incrementally (interactive)
isearch-backward - Search backwards incrementally (interactive)
n isearch-forward [ "arg" ] (C-s)
n isearch-backward [ "arg" ] (C-r)
isearch-forward provides an interactive search in the forward direction. This command is similar to search-forward(2), but it processes the search as each character of the input string is typed in. This allows the user to only use as many key-strokes as are needed to uniquely specify the string being searched. The string argument arg is not supplied when invoked interactively.
The follow keys can be used at the start of an incremental search only:
C-s - Search for last string.
C-m - Perform a search-forward instead.
esc p,
esc n - Scroll through history list etc (See
ml-bind-key(2)).
Several control characters are active while isearching:
C-s or C-x
C-r
C-h
C-w
C-g
esc or C-m
isearch-backward is the same as isearch-forward, but it searches in the reverse direction.
For both commands when the end of the buffer is reached, an alarm is raised (bell etc.) a further search request (C-s) causes the search to commence from the start of the buffer.
The numeric argument n controls the behavior of isearch-* at the end of the buffer. When specified as 0 then the search exits when the start/end of the buffer is reached and the search is exhausted. When omitted (or specified as 1) then the search recommences again at the start/end of the buffer, this is the default behavior.
When isearch-* is invoked from a macro then the string argument arg specifies the search string. isearch is primarily designed for for interactive use and is not typically used from within a macro. When embedded in a macro then it is typically invoked with the 0 argument so that the calling macro may handle the start/end of buffer condition. The macro page-file(3) uses isearch-* and performs exactly this operation, for a comprehensive example refer to macro file pagefile.emf.
The ml-bind-key(2) bindings are used.
The incremental search supports buffer modes exact(2m) and magic(2m).
The numeric argument to isearch-* was first introduced into MicroEmacs '04.
Due to the dynamic nature of active ipipe-shell-command(2) buffers the search history cannot be stored in the same way (list of fixed locations). As a result the search history is stored as a list of searches which are not guaranteed to be consistent.
exact(2m),
hunt-forward(2),
magic(2m),
ml-bind-key(2),
narrow-search-forward(3),
page-file(3),
search-forward(2).
Regular Expressions
Copyright (c) 1998-2006 JASSPA
Last Modified: 2005/01/16
Generated On: 2006/10/07