core/com.nokia.carbide.cpp.doc.user/html/debugger/breakpoints/conditional_breakpoints.htm
author fturovic <frank.turovich@nokia.com>
Fri, 16 Apr 2010 09:51:37 -0500
branchRCL_2_4
changeset 1225 a546534a48de
parent 0 fb279309251b
child 1791 727385d8e2b3
permissions -rw-r--r--
minor edits to remote conn pages, updated copyrights, fixed some broken links
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1225
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<html>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<head>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     7
<title>Creating Conditional Breakpoints </title>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
</head>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    10
<body bgcolor="#FFFFFF">
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    11
<h2> Creating Conditional Breakpoints </h2>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    12
<p>Use the <b>Properties for Breakpoint  &gt; Common &gt; Conditional</b> option to create conditional breakpoints. Where regular breakpoints  suspend execution each time they are hit, a condition breakpoint evaluates an expression to determine if it is true or not. If the expression evaluates true, then program execuation is suspended and the <a href="../../reference/perspective_debug.htm">Debug</a> perpective shown. If the expression evaluates to false, execution continues. </p>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    13
<p align="center"><img src="../images/option_condition.png" width="434" height="202"></p>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    14
<p class="figure">Figure 1. Condition field in Properties for Breakpoint window </p>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    15
<p>You create a conditional breakpoint in the <b>Conditional</b> field by entering a valid expression.  Valid expressions include:</p>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
<ul>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    17
  <li class="code">meters == 10</li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    18
  <li class="code">height &gt;= 5</li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
  <li class="code">count != 10    </li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    20
</ul>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    21
<p>When creating the expression some things to consider include:</p>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    22
<ul>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    23
  <li>expressions must evaluate to true </li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    24
  <li>the value being examined must be within the scope of the function</li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
  <li>normal syntax rules apply when creating the expression</li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
  <li>only a single expression can be evaluated within the Condition field </li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
  <li>function and method calls cannot be used as part of the expression  </li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
</ul>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
<h4>Other references</h4>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
<ul>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
  <li><a href="breakpoints.htm">Breakpoints overview </a></li>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    32
</ul>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
</body>
a546534a48de minor edits to remote conn pages, updated copyrights, fixed some broken links
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
</html>