Added Dart_FunctionEnclosingClassOrLibrary.

runtime/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 2053 matching lines @@
 
 /**
  * Returns the name for the provided function or method.
  *
  * \return A valid string handle if no error occurs during the
  * operation.
  */
 DART_EXPORT Dart_Handle Dart_FunctionName(Dart_Handle function);
 
 /**
+ * Returns a handle to the enclosing class or library for a function. If this
+ * function is an instance method, a static method or the function of a closure
+ * defined in such, it has an enclosing class. If this function is a top-level
+ * function or the function of a closure defined in such, it has an enclosing
+ * library.
+ *
+ * \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 to 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.
  * \param is_static Returns whether the handle refers to an abstract method.
  *
  * \return A valid handle if no error occurs during the operation.
  */
 DART_EXPORT Dart_Handle Dart_FunctionIsAbstract(Dart_Handle function,
                                                 bool* is_abstract);
 
@@ skipping 509 matching lines @@
 
 typedef void (*Dart_FileWriterFunction)(const char* buffer, int64_t num_bytes);
 
 // Support for generating symbol maps for use by the Linux perf tool.
 DART_EXPORT void Dart_InitPerfEventsSupport(Dart_FileWriterFunction function);
 
 // Support for generating flow graph compiler debugging output into a file.
 DART_EXPORT void Dart_InitFlowGraphPrinting(Dart_FileWriterFunction function);
 
 #endif  // INCLUDE_DART_API_H_