| Fuad Tabba | c588ecf | 2021-02-04 13:59:53 +0000 | [diff] [blame^] | 1 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| 2 | <html> |
| 3 | <!-- Copyright (C) 1988-2015 Free Software Foundation, Inc. |
| 4 | |
| 5 | Permission is granted to copy, distribute and/or modify this document |
| 6 | under the terms of the GNU Free Documentation License, Version 1.3 or |
| 7 | any later version published by the Free Software Foundation; with the |
| 8 | Invariant Sections being "Free Software" and "Free Software Needs |
| 9 | Free Documentation", with the Front-Cover Texts being "A GNU Manual," |
| 10 | and with the Back-Cover Texts as in (a) below. |
| 11 | |
| 12 | (a) The FSF's Back-Cover Text is: "You are free to copy and modify |
| 13 | this GNU Manual. Buying copies from GNU Press supports the FSF in |
| 14 | developing GNU and promoting software freedom." --> |
| 15 | <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ --> |
| 16 | <head> |
| 17 | <title>Debugging with GDB: Searching</title> |
| 18 | |
| 19 | <meta name="description" content="Debugging with GDB: Searching"> |
| 20 | <meta name="keywords" content="Debugging with GDB: Searching"> |
| 21 | <meta name="resource-type" content="document"> |
| 22 | <meta name="distribution" content="global"> |
| 23 | <meta name="Generator" content="makeinfo"> |
| 24 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
| 25 | <link href="index.html#Top" rel="start" title="Top"> |
| 26 | <link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index"> |
| 27 | <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> |
| 28 | <link href="Readline-Interaction.html#Readline-Interaction" rel="up" title="Readline Interaction"> |
| 29 | <link href="Readline-Init-File.html#Readline-Init-File" rel="next" title="Readline Init File"> |
| 30 | <link href="Readline-Arguments.html#Readline-Arguments" rel="prev" title="Readline Arguments"> |
| 31 | <style type="text/css"> |
| 32 | <!-- |
| 33 | a.summary-letter {text-decoration: none} |
| 34 | blockquote.smallquotation {font-size: smaller} |
| 35 | div.display {margin-left: 3.2em} |
| 36 | div.example {margin-left: 3.2em} |
| 37 | div.indentedblock {margin-left: 3.2em} |
| 38 | div.lisp {margin-left: 3.2em} |
| 39 | div.smalldisplay {margin-left: 3.2em} |
| 40 | div.smallexample {margin-left: 3.2em} |
| 41 | div.smallindentedblock {margin-left: 3.2em; font-size: smaller} |
| 42 | div.smalllisp {margin-left: 3.2em} |
| 43 | kbd {font-style:oblique} |
| 44 | pre.display {font-family: inherit} |
| 45 | pre.format {font-family: inherit} |
| 46 | pre.menu-comment {font-family: serif} |
| 47 | pre.menu-preformatted {font-family: serif} |
| 48 | pre.smalldisplay {font-family: inherit; font-size: smaller} |
| 49 | pre.smallexample {font-size: smaller} |
| 50 | pre.smallformat {font-family: inherit; font-size: smaller} |
| 51 | pre.smalllisp {font-size: smaller} |
| 52 | span.nocodebreak {white-space:nowrap} |
| 53 | span.nolinebreak {white-space:nowrap} |
| 54 | span.roman {font-family:serif; font-weight:normal} |
| 55 | span.sansserif {font-family:sans-serif; font-weight:normal} |
| 56 | ul.no-bullet {list-style: none} |
| 57 | --> |
| 58 | </style> |
| 59 | |
| 60 | |
| 61 | </head> |
| 62 | |
| 63 | <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> |
| 64 | <a name="Searching"></a> |
| 65 | <div class="header"> |
| 66 | <p> |
| 67 | Previous: <a href="Readline-Arguments.html#Readline-Arguments" accesskey="p" rel="prev">Readline Arguments</a>, Up: <a href="Readline-Interaction.html#Readline-Interaction" accesskey="u" rel="up">Readline Interaction</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p> |
| 68 | </div> |
| 69 | <hr> |
| 70 | <a name="Searching-for-Commands-in-the-History"></a> |
| 71 | <h4 class="subsection">32.2.5 Searching for Commands in the History</h4> |
| 72 | |
| 73 | <p>Readline provides commands for searching through the command history |
| 74 | for lines containing a specified string. |
| 75 | There are two search modes: <em>incremental</em> and <em>non-incremental</em>. |
| 76 | </p> |
| 77 | <p>Incremental searches begin before the user has finished typing the |
| 78 | search string. |
| 79 | As each character of the search string is typed, Readline displays |
| 80 | the next entry from the history matching the string typed so far. |
| 81 | An incremental search requires only as many characters as needed to |
| 82 | find the desired history entry. |
| 83 | To search backward in the history for a particular string, type |
| 84 | <kbd>C-r</kbd>. Typing <kbd>C-s</kbd> searches forward through the history. |
| 85 | The characters present in the value of the <code>isearch-terminators</code> variable |
| 86 | are used to terminate an incremental search. |
| 87 | If that variable has not been assigned a value, the <tt class="key">ESC</tt> and |
| 88 | <kbd>C-J</kbd> characters will terminate an incremental search. |
| 89 | <kbd>C-g</kbd> will abort an incremental search and restore the original line. |
| 90 | When the search is terminated, the history entry containing the |
| 91 | search string becomes the current line. |
| 92 | </p> |
| 93 | <p>To find other matching entries in the history list, type <kbd>C-r</kbd> or |
| 94 | <kbd>C-s</kbd> as appropriate. |
| 95 | This will search backward or forward in the history for the next |
| 96 | entry matching the search string typed so far. |
| 97 | Any other key sequence bound to a Readline command will terminate |
| 98 | the search and execute that command. |
| 99 | For instance, a <tt class="key">RET</tt> will terminate the search and accept |
| 100 | the line, thereby executing the command from the history list. |
| 101 | A movement command will terminate the search, make the last line found |
| 102 | the current line, and begin editing. |
| 103 | </p> |
| 104 | <p>Readline remembers the last incremental search string. If two |
| 105 | <kbd>C-r</kbd>s are typed without any intervening characters defining a new |
| 106 | search string, any remembered search string is used. |
| 107 | </p> |
| 108 | <p>Non-incremental searches read the entire search string before starting |
| 109 | to search for matching history lines. The search string may be |
| 110 | typed by the user or be part of the contents of the current line. |
| 111 | </p> |
| 112 | <hr> |
| 113 | <div class="header"> |
| 114 | <p> |
| 115 | Previous: <a href="Readline-Arguments.html#Readline-Arguments" accesskey="p" rel="prev">Readline Arguments</a>, Up: <a href="Readline-Interaction.html#Readline-Interaction" accesskey="u" rel="up">Readline Interaction</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p> |
| 116 | </div> |
| 117 | |
| 118 | |
| 119 | |
| 120 | </body> |
| 121 | </html> |
