core/com.nokia.carbide.cpp.doc.user/html/reference/view_expressions.htm
author fturovic <frank.turovich@nokia.com>
Fri, 13 Aug 2010 15:06:59 -0500
changeset 1828 bcf84b8ee3f9
parent 1791 727385d8e2b3
permissions -rw-r--r--
replaced carbide portal with carbide.c++ portal
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<html>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<head>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     7
<title>Expressions Window</title>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
</head>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1532
diff changeset
    10
<body >
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    11
<h2>Expressions View </h2>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    12
<p>  Use the <b>Expressions</b> view to monitor and manipulate:</p>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    13
<ul>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    14
  <li>global and local variables</li>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    15
  <li>structure members</li>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
  <li>array elements</li>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    17
</ul>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    18
<p>The Expressions view displays these panes: </p>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
<ul>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    20
  <li>Expression pane (left) &#8212; Lists expressions and expression hierarchies. Click the hierarchical controls to expand or collapse the expression view.</li>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    21
  <li>Value pane (right) &#8212; Shows the current value of each corresponding expression. Double-click a value to change it.</li>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    22
</ul>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    23
<p>Figure 1 shows the <b>Expressions</b> view.</p>
1532
d9c69c1b932e remove old images and add new one with revised pages
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    24
<p align="center"><img src="images/view_expressions.png" width="439" height="144" /></p>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
<p class="figure">Figure 1 - Expressions view </p>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
<h5>Table 1. Expressions view &mdash;items </h5>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
<table width="88%"  border="0" cellpadding="2" cellspacing="0">
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
  <tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
      <th width="34%" scope="col">Item</th>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
      <th width="14%" scope="col">Icons</th>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
      <th width="52%" scope="col">Explanation</th>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    32
  </tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
    <tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
      <td><b>Show Type Names </b></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
      <td><div align="center"><img src="../images/icons/var_toggle_type_names_icon.png" width="19" height="19" /></div></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    36
      <td>Toggles the display of type names in the Expressions view. </td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    37
    </tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    38
    <tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    39
      <td><b>Show Logical Structure </b></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    40
      <td><div align="center"><img src="../images/icons/var_show_logical_struct_icon.png" width="19" height="19" /></div></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    41
      <td>Not available in C/C++ yet. </td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    42
    </tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    43
    <tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    44
      <td><b>Collapse All </b></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    45
      <td><div align="center"><img src="../images/icons/var_collapse_all_icon.png" width="17" height="18" /></div></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    46
      <td>Collapses all expanded expressions into the top level. </td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    47
    </tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    48
    <tr>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    49
      <td><b>New Watch Expression</b></td>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    50
      <td>&nbsp;</td>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    51
      <td>Click to open the <b>Add Watch Expression</b> dialog.</td>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    52
    </tr>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    53
    <tr>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    54
      <td><b>Remove Selected Expression </b></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    55
      <td><div align="center"><img src="../images/icons/var_remove_selected_globals_icon.png" width="18" height="16" /></div></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    56
      <td>Click to remove all currently selected expressions from the expressions list. </td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    57
    </tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    58
    <tr>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    59
      <td><b>Remove All Expressions </b></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    60
      <td><div align="center"><img src="../images/icons/var_remove_all_globals_icon.png" width="19" height="19" /></div></td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    61
      <td>Click to remove all expressions from the expressions list. </td>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    62
    </tr>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    63
    <tr>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    64
      <td><b>Refresh</b></td>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    65
      <td><center>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    66
      </center>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    67
      </td>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    68
      <td>Click to refresh view display.</td>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    69
    </tr>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    70
</table>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    71
<h4>Opening the Expressions View </h4>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    72
  <p>Use the Expressions view to inspect frequently used variables as their values change during a debugging session.</p>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    73
  <div class="step">
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    74
  <h4>Opening an Expressions view </h4>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    75
  <ul>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    76
    <li>Select Window &gt; Show View &gt; Expressions</li>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    77
    <li>OR</li>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    78
    <li>Right-click a variable in the <a href="view_variables.htm">Variables</a> or editor view and choose the Add Watchpoint (C/C++) menu item</li>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    79
    <p>An Expressions view appears in the current perspective.</p>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    80
  </ul>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    81
</div>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    82
<h5>Related tasks</h5>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    83
<ul>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    84
  <li><a href="../debugger/variables/adding_expressions.htm">Adding &amp; Removing Expressions</a></li>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    85
  <li><a href="../debugger/variables/editing_expressions.htm">Editing Expressions</a></li>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    86
</ul>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 475
diff changeset
    87
<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>
475
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    88
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    89
</body>
bb1095fec5b3 removed unused pages and images for watchpoints, variables, and expressions
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    90
</html>