| // Copyright 2018 The Fuchsia Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #pragma once |
| |
| #include <functional> |
| |
| #include "lib/fxl/memory/ref_counted.h" |
| |
| namespace zxdb { |
| |
| class Err; |
| class ExprValue; |
| class Identifier; |
| class Symbol; |
| class SymbolDataProvider; |
| class SymbolVariableResolver; |
| class Variable; |
| |
| // Interface used by expression evaluation to communicate with the outside |
| // world. This provides access to the variables currently in scope. |
| class ExprEvalContext : public fxl::RefCountedThreadSafe<ExprEvalContext> { |
| public: |
| using ValueCallback = std::function<void( |
| const Err& err, fxl::RefPtr<Symbol> symbol, ExprValue value)>; |
| |
| virtual ~ExprEvalContext() = default; |
| |
| // Issues the callback with the value of the given named value in the context |
| // of the current expression evaluation. This will handle things like |
| // implicit |this| members in addition to normal local variables. |
| // |
| // The callback also returns the Symbol associated with the variable it |
| // found. This can be used for diagnostics. It is possible for the symbol |
| // to be valid but the err to be set if the symbol was found but it could not |
| // be evaluated. |
| // |
| // The callback may be issued asynchronously in the future if communication |
| // with the remote debugged application is required. The callback may be |
| // issued reentrantly for synchronously available data. |
| virtual void GetNamedValue(const Identifier& identifier, |
| ValueCallback cb) = 0; |
| |
| // Returns the SymbolVariableResolver used to create variables from |
| // memory for this context. |
| virtual SymbolVariableResolver& GetVariableResolver() = 0; |
| |
| virtual fxl::RefPtr<SymbolDataProvider> GetDataProvider() = 0; |
| }; |
| |
| } // namespace zxdb |