GNU Info

Info Node: (emacs)Nonincremental Search

(emacs)Nonincremental Search


Next: Word Search Prev: Incremental Search Up: Search
Enter node , (file) or (file)node

Nonincremental Search
=====================

   Emacs also has conventional nonincremental search commands, which
require you to type the entire search string before searching begins.

`C-s <RET> STRING <RET>'
     Search for STRING.

`C-r <RET> STRING <RET>'
     Search backward for STRING.

   To do a nonincremental search, first type `C-s <RET>'.  This enters
the minibuffer to read the search string; terminate the string with
<RET>, and then the search takes place.  If the string is not found,
the search command signals an error.

   When you type `C-s <RET>', the `C-s' invokes incremental search as
usual.  That command is specially programmed to invoke nonincremental
search, `search-forward', if the string you specify is empty.  (Such an
empty argument would otherwise be useless.)  But it does not call
`search-forward' right away.  First it checks the next input character
to see if is `C-w', which specifies a word search.  Note: Word Search.
`C-r <RET>' does likewise, for a reverse incremental search.

   Forward and backward nonincremental searches are implemented by the
commands `search-forward' and `search-backward'.  These commands may be
bound to keys in the usual manner.  The feature that you can get to
them via the incremental search commands exists for historical reasons,
and to avoid the need to find key sequences for them.


automatically generated by info2www version 1.2.2.9