Searching.html 5.9 KB

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