5
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
2 |
<html lang="en">
|
|
3 |
|
|
4 |
<head>
|
|
5 |
<meta http-equiv="Content-Language" content="en-us">
|
|
6 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
7 |
<title>Breakpoints</title>
|
|
8 |
<link rel="stylesheet" type="text/css" href="../help.css">
|
|
9 |
</head>
|
|
10 |
|
|
11 |
<body>
|
|
12 |
<h1>Breakpoints</h1>
|
|
13 |
|
|
14 |
<p>A breakpoint suspends the execution of a program at the location where the breakpoint is set.
|
|
15 |
To set a line breakpoint, right-click in the marker bar area on the left side of an editor beside
|
|
16 |
the line where you want the program to be suspended, then choose <b>Toggle Breakpoint</b>. You can
|
|
17 |
also double-click on the marker bar next to the source code line. A new breakpoint marker appears
|
|
18 |
on the marker bar, directly to the left of the line where you added the breakpoint. Also, the new
|
|
19 |
breakpoint appears in the Breakpoints view list.
|
|
20 |
</p>
|
|
21 |
<p>Once set, a breakpoint can be enabled and disabled by right-clicking on its icon or by
|
|
22 |
right-clicking on its description in the <b>Breakpoints</b> view.
|
|
23 |
</p>
|
|
24 |
|
|
25 |
<ul>
|
|
26 |
<li>When a breakpoint is enabled, it causes the program to suspend whenever it is hit.
|
|
27 |
Enabled breakpoints are indicated with a blue
|
|
28 |
<img src="../images/icon_breakpoint_obj.gif" alt="enabled breakpoint" border="0"> circle.
|
|
29 |
Enabled breakpoints that are successfully installed
|
|
30 |
are indicated with a checkmark overlay.</li>
|
|
31 |
<li>When a breakpoint is disabled, it will not affect the execution of the program.
|
|
32 |
Disabled breakpoints are indicated with a white
|
|
33 |
<img src="../images/icon_breakpoint_disable.gif" alt="disabled breakpoint" border="0"> circle.<br>
|
|
34 |
<img border="0" src="../images/add_breakpoint.png" ALT="Editor view with cursor highlighting breakpoint" width="453" height="335">
|
|
35 |
</li>
|
|
36 |
</ul>
|
|
37 |
|
|
38 |
|
|
39 |
|
|
40 |
<p><b>Note: </b>Execution will also suspend
|
|
41 |
if <b>Stop at main() on startup</b> is enabled
|
|
42 |
on the <b>Launch Configuration</b> dialog.
|
|
43 |
To access the <b>Launch Configuration</b> dialog,
|
|
44 |
from the menu bar choose <b>Run > Debug</b>.
|
|
45 |
</p>
|
|
46 |
|
|
47 |
<hr>
|
|
48 |
|
|
49 |
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
|
|
50 |
<br>
|
|
51 |
<a href="../reference/cdt_o_views.htm">Run menu</a><br>
|
|
52 |
<a href="../reference/cdt_o_views.htm">Breakpoints view</a>
|
|
53 |
</p>
|
|
54 |
|
|
55 |
<p>
|
|
56 |
<img src="../images/rh03_04.gif" ALT="Red Hat Statement"><br>
|
|
57 |
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement">
|
|
58 |
</p>
|
|
59 |
|
|
60 |
</body>
|
|
61 |
|
|
62 |
</html> |