| blob | 68dc943a73ad5c82193ce8a2266cb4dcfeb5feee |
1 ;;; isearch.el --- incremental search commands
3 ;; Copyright (C) 1985, 1986 Free Software Foundation, Inc.
5 ;; This file is part of GNU Emacs.
7 ;; GNU Emacs is free software; you can redistribute it and/or modify
8 ;; it under the terms of the GNU General Public License as published by
9 ;; the Free Software Foundation; either version 1, or (at your option)
10 ;; any later version.
12 ;; GNU Emacs is distributed in the hope that it will be useful,
13 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
14 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 ;; GNU General Public License for more details.
17 ;; You should have received a copy of the GNU General Public License
18 ;; along with GNU Emacs; see the file COPYING. If not, write to
19 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
21 ;;;###autoload
23 Last string search for by a non-regexp search command.
24 This does not include direct calls to the primitive search functions,
27 ;;;###autoload
29 Last string searched for by a regexp search command.
30 This does not include direct calls to the primitive search functions,
34 ;;;###autoload
37 ;;;###autoload
40 ;;;###autoload
43 ;;;###autoload
46 ;;;###autoload
49 ;;;###autoload
52 ;;;###autoload
55 ;;;###autoload
58 ;;;###autoload
62 ;;;###autoload
66 ;;;###autoload
68 *Number of lines in slow search display windows.
69 These are the short windows used during incremental search on slow terminals.
70 Negative means put the slow search window at the top (normally it's at bottom)
73 ;;;###autoload
76 This is the style where a one-line window is created to show the line
80 "*Non-nil means an upper-case letter as search input means case-sensitive.
81 Any upper-case letter given explicitly as input to the incremental search
82 has the effect of turning off `case-fold-search' for the rest of this search.
89 "List of recent non-regexp incremental searches.
93 "List of recent regexp incremental searches.
103 "The tail of the regular expression search ring whose car is the last
107 ;;;###autoload
109 "Do incremental search forward.
110 As you type characters, they add to the search string and are found.
111 Type Delete to cancel characters from end of search string.
112 Type RET to exit, leaving point at location found.
113 Type C-s to search again forward, C-r to search again backward.
114 Type C-w to yank word from buffer onto end of search string and search for it.
115 Type C-y to yank rest of line onto end of search string, etc.
116 Type C-q to quote control character to search for it.
117 Other control and meta characters terminate the search
118 and are then executed normally.
119 The above special characters are mostly controlled by parameters;
120 do M-x apropos on search-.*-char to find them.
121 C-g while searching or when search has failed
122 cancels input back to what has been found successfully.
123 C-g when search is successful aborts and moves point to starting point."
126 ;;;###autoload
129 ;;;###autoload
131 "Do incremental search forward for regular expression.
132 Like ordinary incremental search except that your input
136 ;;;###autoload
139 ;;;###autoload
141 "Do incremental search backward.
145 ;;;###autoload
148 ;;;###autoload
150 "Do incremental search backward for regular expression.
151 Like ordinary incremental search except that your input
155 ;;;###autoload
159 ;; This function does all the work of incremental search.
160 ;; The functions attached to ^R and ^S are trivial,
161 ;; merely calling this one, but they are always loaded by default
162 ;; whereas this file can optionally be autoloadable.
163 ;; This is the only entry point in this file.
165 ;; OP-FUN is a function to be called after each input character is processed.
166 ;; (It is not called after characters that exit the search.)
171 ;; List of previous states during this search.
173 ;; t means search is currently successful.
175 ;; Set once the search has wrapped around the end of the buffer.
177 ;; Nominal starting point for searching
178 ;; Usually this is the same as the opoint,
179 ;; but it is changed by wrapping
180 ;; and also by repeating the search.
182 ;; Set temporarily when adding a character to a regexp
183 ;; enables it to match more rather than fewer places in the buffer.
184 liberalized
185 ;; Set temporarily by yanking text into the search string.
186 yank-flag
188 ;; non-nil means an explicit uppercase letter seen in the input
190 ;; Non-nil means start using a small window
191 ;; if the search moves outside what is currently on the screen.
195 ;; t means a small window is currently in use.
197 ;; These variables preserve information from the small window
198 ;; through exit from the save-window-excursion.
201 ;; Point is at one end of the last match.
202 ;; This variable records the other end of that match.
204 ;; Value of point at start of search,
205 ;; for moving the cursor back on quitting.
208 ;; The screen we're working on; if this changes, we exit isearch.
239 ?\C-g
246 search-exit-option)
250 ;; If the user switches to a different screen, exit.
256 ;; RET means exit search normally.
257 ;; Except, if first thing typed, it means do nonincremental
262 ;; ^G means the user tried to quit.
266 ;; If search is successful, move back to starting point
267 ;; and really do quit.
270 ;; If search is failing, rub out until it is once more
271 ;; successful.
276 ;; C-s in forward or C-r in reverse.
278 ;; If search string is empty, use last one.
280 ;; If already have what to search for, repeat it.
284 ;; C-s in reverse or C-r in forward, change direction.
290 ;; If repeating a search that found an empty string,
291 ;; ensure we advance. Test history to make sure we
292 ;; actually have done a search already; otherwise,
293 ;; the match data will be random.
300 ;; Rubout means discard last input item and move point
301 ;; back. If buffer is empty, just beep.
310 ()
313 length)
314 regexp-search-ring))
318 ()
321 length)
322 search-ring))
331 ()
335 length)
336 regexp-search-ring))
340 ()
344 length)
345 search-ring))
352 ;; ^W means gobble next word from buffer.
353 ;; ^Y means gobble rest of line from buffer.
367 search-message
371 ;; Don't move cursor in reverse search.
372 yank-flag t)))
373 ;; Any other control char =>
374 ;; unread it and exit the search normally.
384 ;; Any other character => add it to the
385 ;; search string and search.
390 ;; RET translates to newline.
399 ;; unsuccessful regexp search may become
400 ;; successful by addition of characters which
401 ;; make search-string valid
403 nil
404 ;; Check for chars that can make a regexp more liberal.
405 ;; They can make a regexp match sooner
406 ;; or make it succeed instead of failing.
407 ;; So go back to place last successful search started
408 ;; or to the last ^S/^R (barrier), whichever is nearer.
411 ;; Don't treat *, ? as special
412 ;; within [] or after \.
415 ;; This used to use element 2
416 ;; in a reverse search, but it seems that 5
417 ;; (which is the end of the old match)
418 ;; is better in that case too.
421 ;; (car history) is after last search;
422 ;; (car (cdr history)) is from before it.
431 ;; Turn off case-sensitivity if string requests it.
435 search-upper-case)))))
436 ;; In reverse search, adding stuff at
437 ;; the end may cause zero or many more chars to be
438 ;; matched, in the string following point.
439 ;; Allow all those possibilities without moving point as
440 ;; long as the match does not extend past search origin.
447 ;; Used to have (min opoint barrier)
448 ;; instead of barrier.
449 ;; This lost when wrapping.
453 ;; Not regexp, not reverse, or no match at point.
456 ;; Used to have opoint inside the min.
457 ;; This lost when wrapping.
468 regexp-search-ring)
469 regexp-search-ring-yank-pointer regexp-search-ring)
475 search-ring)
476 search-ring-yank-pointer search-ring)
479 ;; If we displayed a single-line window, set point in this window.
482 ;; If there was movement, mark the starting position.
483 ;; Maybe should test difference between and set mark iff > threshold.
488 ;; Exiting the save-window-excursion clobbers this; restore it.
492 ;; If about to search, and previous search regexp was invalid,
493 ;; check that it still is. If it is valid now,
494 ;; let the message we display while searching say that it is valid.
500 ;; If currently failing, display no ellipsis.
508 "I-search"
510 search-message
519 ;; Get the search string from the "front" of the ring of previous searches.
524 ;; ELT describes the most recent search or where we have rotated the ring.
529 ;; Let's give this one the benefit of the doubt.
549 success forward other-end invalid-regexp
550 wrapped barrier uppercase-flag)
551 history)))
557 search-upper-case)))))
567 search-string nil t))
575 invalid-regexp)
578 nil
579 ;; Ding if failed this time after succeeding last time.
584 ;; This is called from incremental-search
585 ;; if the first input character is the exit character.
586 ;; The interactive-arg-reader uses free variables `forward' and `regexp'
587 ;; which are bound by `incremental-search'.
589 ;; We store the search string in `search-string'
590 ;; which has been bound already by `incremental-search'
591 ;; so that, when we exit, it is copied into `search-last-string'.
596 ;; Prompt assuming not word search,
602 ;; Read 1 char and switch to word search if it is ^W.
606 ;; Otherwise let that 1 char be part of the search string.
614 ;; Read the search string with corrected prompt.
616 ;; Empty means use default.
619 ;; Set last search string now so it is set even if we fail.
621 ;; Since we used the minibuffer, we should be available for redo.
623 ;; Go ahead and search.
626 ;;; isearch.el ends here