blob: 4ddd69d6bf665dbcaeb3d84d2d05933e0c10288c [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML>
<HEAD>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<TITLE>Expressions</TITLE>
<link rel="stylesheet" type="text/css" HREF="../book.css">
</HEAD>
<BODY BGCOLOR="#ffffff">
<h3>Expressions</h3>
<p>An <b>expression</b> is a snippet of code that can be evaluated to produce a
value. The context for an expression depends on the particular debug
model. Some expressions may need to be evaluated at a specific location in
the program so that its variables can be referenced.
<a href="../reference/api/org/eclipse/debug/core/model/IExpression.html"><b>IExpression</b></a>
defines a general interface for debug expressions.</p>
<p>An expression manager (<a href="../reference/api/org/eclipse/debug/core/IExpressionManager.html"><b>IExpressionManager</b></a>)
keeps track of all of the expressions in the workspace. It will also fire
events to interested listeners as expressions are added, removed, or changed.</p>
<p>Expressions can be used to implement &quot;inspectors,&quot; or &quot;scrapbooks&quot; that let users evaluate
code snippets. The Java tooling uses expressions to implement the
expression generated when the user inspects the source code.</p>
<p>A <b>watch expression</b> is an expression that is repeatedly evaluated as the program executes.
<a href="../reference/api/org/eclipse/debug/core/model/IWatchExpression.html"><b>IWatchExpression</b></a>
defines a specialized kind of <a href="../reference/api/org/eclipse/debug/core/model/IExpression.html"><b>IExpression</b></a>
that updates the value of the expression when supplied with a new debug context. Watch expressions are used to implement
&quot;watch lists,&quot; which show changes in the value of an expression as the program executes.</p>
</BODY>
</HTML>