Add Dart_Invoke, which will replace Dart_InvokeDynamic and Dart_InvokeStatic.

include/dart_api.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 INCLUDE_DART_API_H_
 #define INCLUDE_DART_API_H_
 
 /** \mainpage Dart Embedding API Reference
  *
  * Dart is a class-based programming language for creating structured
@@ skipping 1637 matching lines @@
 
 // DEPRECATED: The API below is a temporary hack.
 DART_EXPORT int64_t Dart_ClosureSmrck(Dart_Handle object);
 
 // DEPRECATED: The API below is a temporary hack.
 DART_EXPORT void Dart_ClosureSetSmrck(Dart_Handle object, int64_t value);
 
 // --- Methods and Fields ---
 
 /**
+ * Invokes a method or function.
+ *
+ * The 'target' parameter may be an object, class, or library.  If
+ * 'target' is an object, then this function will invoke an instance
+ * method.  If 'target' is a class, then this function will invoke a
+ * static method.  If 'target' is a library, then this function will
+ * invoke a top-level function from that library.
+ *
+ * This function ignores visibility (leading underscores in names).
+ *
+ * May generate an unhandled exception error.
+ *
+ * \param target An object, class, or library.
+ * \param name The name of the function or method to invoke.
+ * \param number_of_arguments Size of the arguments array.
+ * \param arguments An array of arguments to the function.
+ *
+ * \return If the function or method is called and completes
+ *   successfully, then the return value is returned. If an error
+ *   occurs during execution, then an error handle is returned.
+ */
+DART_EXPORT Dart_Handle Dart_Invoke(Dart_Handle target,
+                                    Dart_Handle name,
+                                    int number_of_arguments,
+                                    Dart_Handle* arguments);
+/**
+ * DEPRECATED: Use Dart_Invoke instead.
+ *
  * Invokes a static method with the given arguments.
  *
  * May generate an unhandled exception error.
  *
  * \return If no error occurs during execution, then the result of
  *   invoking the method is returned. If an error occurs during
  *   execution, then an error handle is returned.
  */
 DART_EXPORT Dart_Handle Dart_InvokeStatic(Dart_Handle library,
                                           Dart_Handle class_name,
                                           Dart_Handle function_name,
                                           int number_of_arguments,
                                           Dart_Handle* arguments);
 
 /**
+ * DEPRECATED: Use Dart_Invoke instead.
+ *
  * Invokes an instance method with the given arguments.
  *
  * May generate an unhandled exception error.
  *
  * \return If no error occurs during execution, then the result of
  *   invoking the method is returned. If an error occurs during
  *   execution, then an error handle is returned.
  */
 DART_EXPORT Dart_Handle Dart_InvokeDynamic(Dart_Handle receiver,
                                            Dart_Handle function_name,
                                            int number_of_arguments,
                                            Dart_Handle* arguments);
 
 /**
  * Gets the value of a field.
  *
- * The 'container' parameter may actually be an object, class, or
- * library.  If 'container' is an object, then this function will
- * access an instance field.  If 'container' is a class, then this
- * function will access a static field.  If 'container' is a library,
- * then this function will access a top-level variable.
+ * The 'container' parameter may be an object, class, or library.  If
+ * 'container' is an object, then this function will access an
+ * instance field.  If 'container' is a class, then this function will
+ * access a static field.  If 'container' is a library, then this
+ * function will access a top-level variable.
  *
  * This function ignores field visibility (leading underscores in names).
  *
  * May generate an unhandled exception error.
  *
  * \param container An object, class, or library.
- * \param name A field name
+ * \param name A field name.
  *
  * \return If no error occurs, then the value of the field is
  *   returned. Otherwise an error handle is returned.
  */
 DART_EXPORT Dart_Handle Dart_GetField(Dart_Handle container,
                                       Dart_Handle name);
 
 /**
  * Sets the value of a field.
  *
  * The 'container' parameter may actually be an object, class, or
  * library.  If 'container' is an object, then this function will
  * access an instance field.  If 'container' is a class, then this
  * function will access a static field.  If 'container' is a library,
  * then this function will access a top-level variable.
  *
  * This function ignores field visibility (leading underscores in names).
  *
  * May generate an unhandled exception error.
  *
  * \param container An object, class, or library.
- * \param name A field name
- * \param value The new field value
+ * \param name A field name.
+ * \param value The new field value.
  *
  * \return A valid handle if no error occurs.
  */
 DART_EXPORT Dart_Handle Dart_SetField(Dart_Handle container,
                                       Dart_Handle name,
                                       Dart_Handle value);
 
 /**
  * DEPRECATED: Use Dart_SetField/Dart_GetField instead.
  *
@@ skipping 242 matching lines @@
 
 // --- Profiling support ----
 
 // External pprof support for gathering and dumping symbolic
 // information that can be used for better profile reports for
 // dynamically generated code.
 DART_EXPORT void Dart_InitPprofSupport();
 DART_EXPORT void Dart_GetPprofSymbolInfo(void** buffer, int* buffer_size);
 
 #endif  // INCLUDE_DART_API_H_