|
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> |