1<html lang="en"> 2<head> 3<title>Searching - Debugging with GDB</title> 4<meta http-equiv="Content-Type" content="text/html"> 5<meta name="description" content="Debugging with GDB"> 6<meta name="generator" content="makeinfo 4.13"> 7<link title="Top" rel="start" href="index.html#Top"> 8<link rel="up" href="Readline-Interaction.html#Readline-Interaction" title="Readline Interaction"> 9<link rel="prev" href="Readline-Arguments.html#Readline-Arguments" title="Readline Arguments"> 10<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 11<!-- 12Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 131998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 14Free Software Foundation, Inc. 15 16Permission is granted to copy, distribute and/or modify this document 17under the terms of the GNU Free Documentation License, Version 1.3 or 18any later version published by the Free Software Foundation; with the 19Invariant Sections being ``Free Software'' and ``Free Software Needs 20Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,'' 21and with the Back-Cover Texts as in (a) below. 22 23(a) The FSF's Back-Cover Text is: ``You are free to copy and modify 24this GNU Manual. Buying copies from GNU Press supports the FSF in 25developing GNU and promoting software freedom.''--> 26<meta http-equiv="Content-Style-Type" content="text/css"> 27<style type="text/css"><!-- 28 pre.display { font-family:inherit } 29 pre.format { font-family:inherit } 30 pre.smalldisplay { font-family:inherit; font-size:smaller } 31 pre.smallformat { font-family:inherit; font-size:smaller } 32 pre.smallexample { font-size:smaller } 33 pre.smalllisp { font-size:smaller } 34 span.sc { font-variant:small-caps } 35 span.roman { font-family:serif; font-weight:normal; } 36 span.sansserif { font-family:sans-serif; font-weight:normal; } 37--></style> 38<link rel="stylesheet" type="text/css" href="../cs.css"> 39</head> 40<body> 41<div class="node"> 42<a name="Searching"></a> 43<p> 44Previous: <a rel="previous" accesskey="p" href="Readline-Arguments.html#Readline-Arguments">Readline Arguments</a>, 45Up: <a rel="up" accesskey="u" href="Readline-Interaction.html#Readline-Interaction">Readline Interaction</a> 46<hr> 47</div> 48 49<h4 class="subsection">31.2.5 Searching for Commands in the History</h4> 50 51<p>Readline provides commands for searching through the command history 52for lines containing a specified string. 53There are two search modes: <dfn>incremental</dfn> and <dfn>non-incremental</dfn>. 54 55 <p>Incremental searches begin before the user has finished typing the 56search string. 57As each character of the search string is typed, Readline displays 58the next entry from the history matching the string typed so far. 59An incremental search requires only as many characters as needed to 60find the desired history entry. 61To search backward in the history for a particular string, type 62<kbd>C-r</kbd>. Typing <kbd>C-s</kbd> searches forward through the history. 63The characters present in the value of the <code>isearch-terminators</code> variable 64are used to terminate an incremental search. 65If that variable has not been assigned a value, the <ESC> and 66<kbd>C-J</kbd> characters will terminate an incremental search. 67<kbd>C-g</kbd> will abort an incremental search and restore the original line. 68When the search is terminated, the history entry containing the 69search string becomes the current line. 70 71 <p>To find other matching entries in the history list, type <kbd>C-r</kbd> or 72<kbd>C-s</kbd> as appropriate. 73This will search backward or forward in the history for the next 74entry matching the search string typed so far. 75Any other key sequence bound to a Readline command will terminate 76the search and execute that command. 77For instance, a <RET> will terminate the search and accept 78the line, thereby executing the command from the history list. 79A movement command will terminate the search, make the last line found 80the current line, and begin editing. 81 82 <p>Readline remembers the last incremental search string. If two 83<kbd>C-r</kbd>s are typed without any intervening characters defining a new 84search string, any remembered search string is used. 85 86 <p>Non-incremental searches read the entire search string before starting 87to search for matching history lines. The search string may be 88typed by the user or be part of the contents of the current line. 89 90 </body></html> 91 92