Support evaluation of expressions in context of a stack frame

runtime/vm/object.h

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 #ifndef VM_OBJECT_H_
 #define VM_OBJECT_H_
 
 #include "include/dart_api.h"
 #include "platform/assert.h"
 #include "platform/utils.h"
@@ skipping 1032 matching lines @@
                                        RawFunction::Kind kind) const;
 
   void Finalize() const;
 
   // Apply given patch class to this class.
   // Return true on success, or false and error otherwise.
   bool ApplyPatch(const Class& patch, Error* error) const;
 
   // Evaluate the given expression as if it appeared in a static
   // method of this class and return the resulting value, or an
-  // error object if evaluating the expression fails.
-  RawObject* Evaluate(const String& expr) const;
+  // error object if evaluating the expression fails. The method has
+  // the formal parameters given in param_names, and is invoked with
+  // the argument values given in param_values.
+  RawObject* Evaluate(const String& expr,
+                      const Array& param_names,
+                      const Array& param_values) const;
 
   RawError* EnsureIsFinalized(Isolate* isolate) const;
 
   // Allocate a class used for VM internal objects.
   template <class FakeObject> static RawClass* New();
 
   // Allocate instance classes.
   static RawClass* New(const String& name,
                        const Script& script,
                        intptr_t token_pos);
@@ skipping 1470 matching lines @@
     return raw_ptr()->load_state_ == RawLibrary::kLoadError;
   }
   void SetLoadError() const;
 
   static intptr_t InstanceSize() {
     return RoundedAllocationSize(sizeof(RawLibrary));
   }
 
   static RawLibrary* New(const String& url);
 
-  RawObject* Evaluate(const String& expr) const;
+  // Evaluate the given expression as if it appeared in an top-level
+  // method of this library and return the resulting value, or an
+  // error object if evaluating the expression fails. The method has
+  // the formal parameters given in param_names, and is invoked with
+  // the argument values given in param_values.
+  RawObject* Evaluate(const String& expr,
+                      const Array& param_names,
+                      const Array& param_values) const;
 
   // Library scope name dictionary.
   //
   // TODO(turnidge): The Lookup functions are not consistent in how
   // they deal with private names.  Go through and make them a bit
   // more regular.
   void AddClass(const Class& cls) const;
   void AddObject(const Object& obj, const String& name) const;
   void ReplaceObject(const Object& obj, const String& name) const;
   RawObject* LookupReExport(const String& name) const;
@@ skipping 1499 matching lines @@
   bool IsClosure() const;
 
   // If the instance is a callable object, i.e. a closure or the instance of a
   // class implementing a 'call' method, return true and set the function
   // (if not NULL) to call and the context (if not NULL) to pass to the
   // function.
   bool IsCallable(Function* function, Context* context) const;
 
   // Evaluate the given expression as if it appeared in an instance
   // method of this instance and return the resulting value, or an
-  // error object if evaluating the expression fails.
-  RawObject* Evaluate(const String& expr) const;
+  // error object if evaluating the expression fails. The method has
+  // the formal parameters given in param_names, and is invoked with
+  // the argument values given in param_values.
+  RawObject* Evaluate(const String& expr,
+                      const Array& param_names,
+                      const Array& param_values) const;
 
   static intptr_t InstanceSize() {
     return RoundedAllocationSize(sizeof(RawInstance));
   }
 
   static RawInstance* New(const Class& cls, Heap::Space space = Heap::kNew);
 
  protected:
   virtual void PrintSharedInstanceJSON(JSONObject* jsobj, bool ref) const;
 
@@ skipping 2817 matching lines @@
 
 
 RawObject* MegamorphicCache::GetTargetFunction(const Array& array,
                                                intptr_t index) {
   return array.At((index * kEntryLength) + kTargetFunctionIndex);
 }
 
 }  // namespace dart
 
 #endif  // VM_OBJECT_H_