class DwarfExprEval

Clears any existing values in the stack.

A complete expression has finished executing but may or may not have had an error. A successful

expression indicates execution is complete and there is a valid result to read.

When the result is computed, this will indicate if the result is directly from a register,

and if it is, which one. If the current result was the result of some computation and has no

direct register source, it will be RegisterID::kUnknown.

When the result is computed, this will indicate whether it's from a constant source (encoded in

the DWARF expression) or is the result of reading some memory or registers.

Pushes a value on the stack. Call before Eval() for the cases where an expression requires

some initial state.

Valid when is_success(), this indicates how to interpret the value from GetResult().

Valid when is_success() and type() == kPointer/kValue. Returns the result of evaluating the

expression. The meaning will be dependent on the context of the expression being evaluated.

Most results will be smaller than this in which case they will use only the low bits.

Destructively returns the generated data buffer. Valid when is_success() and type() == kData.

Evaluates the expression using the current stack. If the stack needs initial setup, callers

should call Push() first, or Clear() if there might be unwanted data.

This will take a reference to the SymbolDataProvider until the computation is complete.

The symbol context is used to evaluate relative addresses. It should be the context associated

with the module that this expression is from. Normally this will be retrieved from the

symbol that generated the dwarf expression (see DwarfExpr::source()).

The return value will indicate if the request completed synchronously. In synchronous

completion the callback will have been called reentrantly from within the stack of this

function. This does not indicate success as it could succeed or fail both synchronously and

asynchronously.

This class must not be deleted from within the completion callback.

Converts the given DWARF expression to a string. The result values on this class won't be

set since the expression won't actually be evaluated.

The data_provider is required to get the current architecture for pretty-printing register

names. To disable this, pass the default SymbolDataProvider implementation.

When "pretty" mode is enabled, operations will be simplified and platform register names will

be substituted.

Type of completion from a call. Async completion will happen in a callback

in the future.

A DWARF expression can compute either the address of the desired object in the debugged

programs address space, or it can compute the actual value of the object (because it may not

exist in memory).