Added Dart_FunctionEnclosingClassOrLibrary.

runtime/include/dart_api.h

Index: runtime/include/dart_api.h
===================================================================
--- runtime/include/dart_api.h	(revision 10077)
+++ runtime/include/dart_api.h	(working copy)
@@ -2071,6 +2071,17 @@
 DART_EXPORT Dart_Handle Dart_FunctionName(Dart_Handle function);
 
 /**
+ * Returns a handle on the enclosing class of a function (if it is an instance
+ * method, a static method, or a closure defined in such) or its enclosing
+ * library (if it is a top-level function or a closure defined in such).

[turnidge, 2012/07/31 22:22:07]

can you split the description into a short first sentence and then a second
paragraph with the details?

1st sentence: Returns a handle to the enclosing class or library for a function.

2nd paragraph: If this function is a blah, then....

Note that in this file we say a "handle to" instead of a "handle on"

+ *
+ * \return A valid handle on the enclosing class or library of the function, or
+ * an error handle if the argument is not a valid handle on a function.
+ */
+DART_EXPORT Dart_Handle Dart_FunctionEnclosingClassOrLibrary(
+    Dart_Handle function);
+
+/**
  * Determines whether a function handle refers to an abstract method.
  *
  * \param function A handle to a function or method declaration.