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