1 /* **************************************************************** */
3 /* I-Search and Searching */
5 /* **************************************************************** */
7 /* Copyright (C) 1987,1989 Free Software Foundation, Inc.
9 This file contains the Readline Library (the Library), a set of
10 routines for providing Emacs style line input to programs that ask
13 The Library is free software; you can redistribute it and/or modify
14 it under the terms of the GNU General Public License as published by
15 the Free Software Foundation; either version 1, or (at your option)
18 The Library is distributed in the hope that it will be useful, but
19 WITHOUT ANY WARRANTY; without even the implied warranty of
20 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21 General Public License for more details.
23 The GNU General Public License is often shipped with GNU software, and
24 is generally kept in a file called COPYING or LICENSE. If you do not
25 have a copy of the license, write to the Free Software Foundation,
26 675 Mass Ave, Cambridge, MA 02139, USA. */
27 #define READLINE_LIBRARY
29 #if defined (HAVE_CONFIG_H)
33 #include <sys/types.h>
37 #if defined (HAVE_UNISTD_H)
41 #if defined (HAVE_STDLIB_H)
44 # include "ansi_stdlib.h"
51 /* Variables exported to other files in the readline library. */
52 unsigned char *_rl_isearch_terminators = (unsigned char *)NULL;
54 /* Variables imported from other files in the readline library. */
55 extern Keymap _rl_keymap;
56 extern HIST_ENTRY *saved_line_for_history;
57 extern int rl_line_buffer_len;
58 extern int rl_point, rl_end;
59 extern char *rl_line_buffer;
61 extern int rl_execute_next ();
62 extern void rl_extend_line_buffer ();
64 extern int _rl_input_available ();
66 extern char *xmalloc (), *xrealloc ();
68 static int rl_search_history ();
70 /* Last line found by the current incremental search, so we don't `find'
71 identical lines many times in a row. */
72 static char *prev_line_found;
74 /* Search backwards through the history looking for a string which is typed
75 interactively. Start with the current line. */
77 rl_reverse_search_history (sign, key)
80 return (rl_search_history (-sign, key));
83 /* Search forwards through the history looking for a string which is typed
84 interactively. Start with the current line. */
86 rl_forward_search_history (sign, key)
89 return (rl_search_history (sign, key));
92 /* Display the current state of the search in the echo-area.
93 SEARCH_STRING contains the string that is being searched for,
94 DIRECTION is zero for forward, or 1 for reverse,
95 WHERE is the history list number of the current line. If it is
96 -1, then this line is the starting one. */
98 rl_display_search (search_string, reverse_p, where)
100 int reverse_p, where;
103 int msglen, searchlen;
105 searchlen = (search_string && *search_string) ? strlen (search_string) : 0;
107 message = xmalloc (searchlen + 33);
113 sprintf (message, "[%d]", where + history_base);
114 msglen = strlen (message);
118 message[msglen++] = '(';
122 strcpy (message + msglen, "reverse-");
126 strcpy (message + msglen, "i-search)`");
131 strcpy (message + msglen, search_string);
135 strcpy (message + msglen, "': ");
137 rl_message ("%s", message, 0);
139 (*rl_redisplay_function) ();
142 /* Search through the history looking for an interactively typed string.
143 This is analogous to i-search. We start the search in the current line.
144 DIRECTION is which direction to search; >= 0 means forward, < 0 means
147 rl_search_history (direction, invoking_key)
148 int direction, invoking_key;
150 /* The string that the user types in to search for. */
153 /* The current length of SEARCH_STRING. */
154 int search_string_index;
156 /* The amount of space that SEARCH_STRING has allocated to it. */
157 int search_string_size;
159 /* The list of lines to search through. */
160 char **lines, *allocated_line;
162 /* The length of LINES. */
165 /* Where we get LINES from. */
169 int orig_point, orig_line, last_found_line;
170 int c, found, failed, sline_len;
172 /* The line currently being searched. */
175 /* Offset in that line. */
178 /* Non-zero if we are doing a reverse search. */
181 /* The list of characters which terminate the search, but are not
182 subsequently executed. If the variable isearch-terminators has
183 been set, we use that value, otherwise we use ESC and C-J. */
184 unsigned char *isearch_terminators;
186 orig_point = rl_point;
187 last_found_line = orig_line = where_history ();
188 reverse = direction < 0;
189 hlist = history_list ();
190 allocated_line = (char *)NULL;
192 isearch_terminators = _rl_isearch_terminators ? _rl_isearch_terminators
193 : (unsigned char *)"\033\012";
195 /* Create an arrary of pointers to the lines that we want to search. */
196 maybe_replace_line ();
199 for (i = 0; hlist[i]; i++);
201 /* Allocate space for this many lines, +1 for the current input line,
202 and remember those lines. */
203 lines = (char **)xmalloc ((1 + (hlen = i)) * sizeof (char *));
204 for (i = 0; i < hlen; i++)
205 lines[i] = hlist[i]->line;
207 if (saved_line_for_history)
208 lines[i] = saved_line_for_history->line;
211 /* Keep track of this so we can free it. */
212 allocated_line = xmalloc (1 + strlen (rl_line_buffer));
213 strcpy (allocated_line, &rl_line_buffer[0]);
214 lines[i] = allocated_line;
219 /* The line where we start the search. */
224 /* Initialize search parameters. */
225 search_string = xmalloc (search_string_size = 128);
226 *search_string = '\0';
227 search_string_index = 0;
228 prev_line_found = (char *)0; /* XXX */
230 /* Normalize DIRECTION into 1 or -1. */
231 direction = (direction >= 0) ? 1 : -1;
233 rl_display_search (search_string, reverse, -1);
235 sline = rl_line_buffer;
236 sline_len = strlen (sline);
237 line_index = rl_point;
242 Function *f = (Function *)NULL;
244 /* Read a key and decide how to proceed. */
247 if (_rl_keymap[c].type == ISFUNC)
249 f = _rl_keymap[c].function;
251 if (f == rl_reverse_search_history)
252 c = reverse ? -1 : -2;
253 else if (f == rl_forward_search_history)
254 c = !reverse ? -1 : -2;
258 /* Let NEWLINE (^J) terminate the search for people who don't like
259 using ESC. ^M can still be used to terminate the search and
260 immediately execute the command. */
261 if (c == ESC || c == NEWLINE)
263 /* The characters in isearch_terminators (set from the user-settable
264 variable isearch-terminators) are used to terminate the search but
265 not subsequently execute the character as a command. The default
266 value is "\033\012" (ESC and C-J). */
267 if (strchr (isearch_terminators, c))
270 /* ESC still terminates the search, but if there is pending
271 input or if input arrives within 0.1 seconds (on systems
272 with select(2)) it is used as a prefix character
273 with rl_execute_next. WATCH OUT FOR THIS! This is intended
274 to allow the arrow keys to be used like ^F and ^B are used
275 to terminate the search and execute the movement command. */
276 if (c == ESC && _rl_input_available ()) /* XXX */
277 rl_execute_next (ESC);
281 if (c >= 0 && (CTRL_CHAR (c) || META_CHAR (c) || c == RUBOUT) && c != CTRL ('G'))
290 if (search_string_index == 0)
294 else if (line_index != sline_len)
300 /* switch directions */
302 direction = -direction;
303 reverse = direction < 0;
307 strcpy (rl_line_buffer, lines[orig_line]);
308 rl_point = orig_point;
309 rl_end = strlen (rl_line_buffer);
313 free (allocated_line);
318 /* delete character from search string. */
320 if (search_string_index == 0)
324 search_string[--search_string_index] = '\0';
325 /* This is tricky. To do this right, we need to keep a
326 stack of search positions for the current search, with
327 sentinels marking the beginning and end. */
333 /* Add character to search string and continue search. */
334 if (search_string_index + 2 >= search_string_size)
336 search_string_size += 128;
337 search_string = xrealloc (search_string, search_string_size);
339 search_string[search_string_index++] = c;
340 search_string[search_string_index] = '\0';
344 for (found = failed = 0;;)
346 int limit = sline_len - search_string_index + 1;
348 /* Search the current line. */
349 while (reverse ? (line_index >= 0) : (line_index < limit))
351 if (STREQN (search_string, sline + line_index, search_string_index))
357 line_index += direction;
362 /* Move to the next line, but skip new copies of the line
363 we just found and lines shorter than the string we're
367 /* Move to the next line. */
370 /* At limit for direction? */
371 if (reverse ? (i < 0) : (i == hlen))
377 /* We will need these later. */
379 sline_len = strlen (sline);
381 while ((prev_line_found && STREQ (prev_line_found, lines[i])) ||
382 (search_string_index > sline_len));
387 /* Now set up the line for searching... */
388 line_index = reverse ? sline_len - search_string_index : 0;
393 /* We cannot find the search string. Ding the bell. */
396 continue; /* XXX - was break */
399 /* We have found the search string. Just display it. But don't
400 actually move there in the history list until the user accepts
406 prev_line_found = lines[i];
407 line_len = strlen (lines[i]);
409 if (line_len >= rl_line_buffer_len)
410 rl_extend_line_buffer (line_len);
412 strcpy (rl_line_buffer, lines[i]);
413 rl_point = line_index;
416 rl_display_search (search_string, reverse, (i == orig_line) ? -1 : i);
420 /* The searching is over. The user may have found the string that she
421 was looking for, or else she may have exited a failing search. If
422 LINE_INDEX is -1, then that shows that the string searched for was
423 not found. We use this to determine where to place rl_point. */
425 /* First put back the original state. */
426 strcpy (rl_line_buffer, lines[orig_line]);
428 rl_restore_prompt ();
430 /* Free the search string. */
431 free (search_string);
433 if (last_found_line < orig_line)
434 rl_get_previous_history (orig_line - last_found_line, 0);
436 rl_get_next_history (last_found_line - orig_line, 0);
438 /* If the string was not found, put point at the end of the line. */
440 line_index = strlen (rl_line_buffer);
441 rl_point = line_index;
445 free (allocated_line);