Adds new apis Dart_GetField/Dart_SetField.

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 1597 matching lines @@
  * \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.
+ *
+ * This function ignores field visibility (underscores in names).

[Ivan Posva, 2012/03/07 20:02:58]

leading underscores

[turnidge, 2012/03/07 21:17:12]

Done.

+ *
+ * May generate an unhandled exception error.
+ *
+ * \param container An object, class, or library.
+ * \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.
+ *
+ * May generate an unhandled exception error.
+ *
+ * \param container An object, class, or library.
+ * \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,

[Ivan Posva, 2012/03/07 20:02:58]

Please document that this also ignores privacy.

[turnidge, 2012/03/07 21:17:12]

Done.

+                                      Dart_Handle name,
+                                      Dart_Handle value);
+
+/**
+ * DEPRECATED: Use Dart_SetField/Dart_GetField instead.
+ *
  * Gets the value of a static field.
  *
  * May generate an unhandled exception error.
  *
  * \return If no error occurs, then the value of the field is
  *   returned. Otherwise an error handle is returned.
  */
-DART_EXPORT Dart_Handle Dart_GetStaticField(Dart_Handle cls, Dart_Handle name);
-
+DART_EXPORT Dart_Handle Dart_GetStaticField(Dart_Handle cls,
+                                            Dart_Handle name);
 /**
+ * DEPRECATED: Use Dart_SetField/Dart_GetField instead.
+ *
  * Sets the value of a static field.
  *
  * May generate an unhandled exception error.
  *
  * \return A valid handle if no error occurs.
  */
 DART_EXPORT Dart_Handle Dart_SetStaticField(Dart_Handle cls,
                                             Dart_Handle name,
                                             Dart_Handle value);
 
 /**
+ * DEPRECATED: Use Dart_SetField/Dart_GetField instead.
+ *
  * Gets the value of an instance field.
  *
  * May generate an unhandled exception error.
  *
  * \return If no error occurs, then the value of the field is
  *   returned. Otherwise an error handle is returned.
  */
 DART_EXPORT Dart_Handle Dart_GetInstanceField(Dart_Handle obj,
                                               Dart_Handle name);
 /**
+ * DEPRECATED: Use Dart_SetField/Dart_GetField instead.
+ *
  * Sets the value of an instance field.
  *
  * May generate an unhandled exception error.
  *
  * \return A valid handle if no error occurs.
  */
 DART_EXPORT Dart_Handle Dart_SetInstanceField(Dart_Handle obj,
                                               Dart_Handle name,
                                               Dart_Handle value);
 
@@ skipping 191 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_