org.eclipse.cdt.debug.core.model
Interface ICStackFrame

All Superinterfaces:
org.eclipse.core.runtime.IAdaptable, ICDebugElement, org.eclipse.debug.core.model.IDebugElement, IJumpToAddress, IJumpToLine, IRunToAddress, IRunToLine, org.eclipse.debug.core.model.IStackFrame, org.eclipse.debug.core.model.IStep, org.eclipse.debug.core.model.ISuspendResume, org.eclipse.debug.core.model.ITerminate
All Known Implementing Classes:
CStackFrame

public interface ICStackFrame
extends IRunToLine, IRunToAddress, IJumpToLine, IJumpToAddress, org.eclipse.debug.core.model.IStackFrame, ICDebugElement

C/C++ specific extension of IStackFrame.


Method Summary
 boolean canEvaluate()
          Returns whether this stack frame can currently evaluate an expression.
 org.eclipse.debug.core.model.IValue evaluateExpression(java.lang.String expression)
          Evaluates the given expression in the context of this stack frame.
 java.lang.String evaluateExpressionToString(java.lang.String expression)
          Evaluates the specified expression in the context of this stack frame and returns the evaluation result as a string.
 IAddress getAddress()
          Returns the address of this stack frame.
 java.lang.String getFile()
          Returns the source file of this stack frame or null if the source file is unknown.
 int getFrameLineNumber()
          Returns the line number of this stack frame or 0 if the line number is unknown.
 java.lang.String getFunction()
          Returns the function of this stack frame or null if the function is unknown.
 int getLevel()
          Returns the level of this stack frame.
 
Methods inherited from interface org.eclipse.cdt.debug.core.model.IRunToLine
canRunToLine, canRunToLine, runToLine, runToLine
 
Methods inherited from interface org.eclipse.cdt.debug.core.model.IRunToAddress
canRunToAddress, runToAddress
 
Methods inherited from interface org.eclipse.cdt.debug.core.model.IJumpToLine
canJumpToLine, canJumpToLine, jumpToLine, jumpToLine
 
Methods inherited from interface org.eclipse.cdt.debug.core.model.IJumpToAddress
canJumpToAddress, jumpToAddress
 
Methods inherited from interface org.eclipse.debug.core.model.IStackFrame
getCharEnd, getCharStart, getLineNumber, getName, getRegisterGroups, getThread, getVariables, hasRegisterGroups, hasVariables
 
Methods inherited from interface org.eclipse.debug.core.model.IDebugElement
getDebugTarget, getLaunch, getModelIdentifier
 
Methods inherited from interface org.eclipse.core.runtime.IAdaptable
getAdapter
 
Methods inherited from interface org.eclipse.debug.core.model.IStep
canStepInto, canStepOver, canStepReturn, isStepping, stepInto, stepOver, stepReturn
 
Methods inherited from interface org.eclipse.debug.core.model.ISuspendResume
canResume, canSuspend, isSuspended, resume, suspend
 
Methods inherited from interface org.eclipse.debug.core.model.ITerminate
canTerminate, isTerminated, terminate
 
Methods inherited from interface org.eclipse.cdt.debug.core.model.ICDebugElement
getCurrentStateInfo, getState
 
Methods inherited from interface org.eclipse.debug.core.model.IDebugElement
getDebugTarget, getLaunch, getModelIdentifier
 
Methods inherited from interface org.eclipse.core.runtime.IAdaptable
getAdapter
 

Method Detail

getAddress

IAddress getAddress()
Returns the address of this stack frame.

Returns:
the address of this stack frame

getFile

java.lang.String getFile()
Returns the source file of this stack frame or null if the source file is unknown.

Returns:
the source file of this stack frame

getFunction

java.lang.String getFunction()
Returns the function of this stack frame or null if the function is unknown.

Returns:
the function of this stack frame

getFrameLineNumber

int getFrameLineNumber()
Returns the line number of this stack frame or 0 if the line number is unknown.

Returns:
the line number of this stack frame

getLevel

int getLevel()
Returns the level of this stack frame.

Returns:
the level of this stack frame

evaluateExpression

org.eclipse.debug.core.model.IValue evaluateExpression(java.lang.String expression)
                                                       throws org.eclipse.debug.core.DebugException
Evaluates the given expression in the context of this stack frame.

Parameters:
expression - expression to evaluate
Returns:
the evaluation result
Throws:
org.eclipse.debug.core.DebugException - if this method fails.

evaluateExpressionToString

java.lang.String evaluateExpressionToString(java.lang.String expression)
                                            throws org.eclipse.debug.core.DebugException
Evaluates the specified expression in the context of this stack frame and returns the evaluation result as a string.

Parameters:
expression - the expression to evaluate
Returns:
the evaluation result
Throws:
org.eclipse.debug.core.DebugException - on failure. Reasons include:

canEvaluate

boolean canEvaluate()
Returns whether this stack frame can currently evaluate an expression.

Returns:
whether this stack frame can currently evaluate an expression