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-2021 Free Software Foundation, Inc. 4 5Permission is granted to copy, distribute and/or modify this document 6under the terms of the GNU Free Documentation License, Version 1.3 or 7any later version published by the Free Software Foundation; with the 8Invariant Sections being "Free Software" and "Free Software Needs 9Free Documentation", with the Front-Cover Texts being "A GNU Manual," 10and 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 13this GNU Manual. Buying copies from GNU Press supports the FSF in 14developing GNU and promoting software freedom." --> 15<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ --> 16<head> 17<title>Debugging with GDB: Method Names in Commands</title> 18 19<meta name="description" content="Debugging with GDB: Method Names in Commands"> 20<meta name="keywords" content="Debugging with GDB: Method Names in Commands"> 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="Objective_002dC.html#Objective_002dC" rel="up" title="Objective-C"> 29<link href="The-Print-Command-with-Objective_002dC.html#The-Print-Command-with-Objective_002dC" rel="next" title="The Print Command with Objective-C"> 30<link href="Objective_002dC.html#Objective_002dC" rel="previous" title="Objective-C"> 31<style type="text/css"> 32<!-- 33a.summary-letter {text-decoration: none} 34blockquote.smallquotation {font-size: smaller} 35div.display {margin-left: 3.2em} 36div.example {margin-left: 3.2em} 37div.indentedblock {margin-left: 3.2em} 38div.lisp {margin-left: 3.2em} 39div.smalldisplay {margin-left: 3.2em} 40div.smallexample {margin-left: 3.2em} 41div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 42div.smalllisp {margin-left: 3.2em} 43kbd {font-style:oblique} 44pre.display {font-family: inherit} 45pre.format {font-family: inherit} 46pre.menu-comment {font-family: serif} 47pre.menu-preformatted {font-family: serif} 48pre.smalldisplay {font-family: inherit; font-size: smaller} 49pre.smallexample {font-size: smaller} 50pre.smallformat {font-family: inherit; font-size: smaller} 51pre.smalllisp {font-size: smaller} 52span.nocodebreak {white-space:nowrap} 53span.nolinebreak {white-space:nowrap} 54span.roman {font-family:serif; font-weight:normal} 55span.sansserif {font-family:sans-serif; font-weight:normal} 56ul.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="Method-Names-in-Commands"></a> 65<div class="header"> 66<p> 67Next: <a href="The-Print-Command-with-Objective_002dC.html#The-Print-Command-with-Objective_002dC" accesskey="n" rel="next">The Print Command with Objective-C</a>, Up: <a href="Objective_002dC.html#Objective_002dC" accesskey="u" rel="up">Objective-C</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="Method-Names-in-Commands-1"></a> 71<h4 class="subsubsection">15.4.4.1 Method Names in Commands</h4> 72 73<p>The following commands have been extended to accept Objective-C method 74names as line specifications: 75</p> 76<a name="index-clear_002c-and-Objective_002dC"></a> 77<a name="index-break_002c-and-Objective_002dC"></a> 78<a name="index-info-line_002c-and-Objective_002dC"></a> 79<a name="index-jump_002c-and-Objective_002dC"></a> 80<a name="index-list_002c-and-Objective_002dC"></a> 81<ul> 82<li> <code>clear</code> 83</li><li> <code>break</code> 84</li><li> <code>info line</code> 85</li><li> <code>jump</code> 86</li><li> <code>list</code> 87</li></ul> 88 89<p>A fully qualified Objective-C method name is specified as 90</p> 91<div class="smallexample"> 92<pre class="smallexample">-[<var>Class</var> <var>methodName</var>] 93</pre></div> 94 95<p>where the minus sign is used to indicate an instance method and a 96plus sign (not shown) is used to indicate a class method. The class 97name <var>Class</var> and method name <var>methodName</var> are enclosed in 98brackets, similar to the way messages are specified in Objective-C 99source code. For example, to set a breakpoint at the <code>create</code> 100instance method of class <code>Fruit</code> in the program currently being 101debugged, enter: 102</p> 103<div class="smallexample"> 104<pre class="smallexample">break -[Fruit create] 105</pre></div> 106 107<p>To list ten program lines around the <code>initialize</code> class method, 108enter: 109</p> 110<div class="smallexample"> 111<pre class="smallexample">list +[NSText initialize] 112</pre></div> 113 114<p>In the current version of <small>GDB</small>, the plus or minus sign is 115required. In future versions of <small>GDB</small>, the plus or minus 116sign will be optional, but you can use it to narrow the search. It 117is also possible to specify just a method name: 118</p> 119<div class="smallexample"> 120<pre class="smallexample">break create 121</pre></div> 122 123<p>You must specify the complete method name, including any colons. If 124your program’s source files contain more than one <code>create</code> method, 125you’ll be presented with a numbered list of classes that implement that 126method. Indicate your choice by number, or type ‘<samp>0</samp>’ to exit if 127none apply. 128</p> 129<p>As another example, to clear a breakpoint established at the 130<code>makeKeyAndOrderFront:</code> method of the <code>NSWindow</code> class, enter: 131</p> 132<div class="smallexample"> 133<pre class="smallexample">clear -[NSWindow makeKeyAndOrderFront:] 134</pre></div> 135 136<hr> 137<div class="header"> 138<p> 139Next: <a href="The-Print-Command-with-Objective_002dC.html#The-Print-Command-with-Objective_002dC" accesskey="n" rel="next">The Print Command with Objective-C</a>, Up: <a href="Objective_002dC.html#Objective_002dC" accesskey="u" rel="up">Objective-C</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> 140</div> 141 142 143 144</body> 145</html> 146