Add new Dart API function Dart_IsolateData which returns the peer isolate data associated with an i…

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
@@ skipping 858 matching lines @@
 DART_EXPORT void Dart_ShutdownIsolate();
 /* TODO(turnidge): Document behavior when there is no current isolate. */
 
 /**
  * Returns the current isolate. Will return NULL if there is no
  * current isolate.
  */
 DART_EXPORT Dart_Isolate Dart_CurrentIsolate();
 
 /**
- * Returns the callback data which was passed to the isolate when it
- * was created.
+ * Returns the callback data associated with the current Isolate. This data was
+ * passed to the isolate when it was created.
  */
 DART_EXPORT void* Dart_CurrentIsolateData();
 
 /**
+ * Returns the callback data associated with the specified Isolate. This data
+ * was passed to the isolate when it was created.
+ * The embedder is responsible for ensuring the consistency of this data
+ * with respect to the lifecycle of an Isolate.
+ */
+DART_EXPORT void* Dart_IsolateData(Dart_Isolate isolate);
+
+/**
  * Returns the debugging name for the current isolate.
  *
  * This name is unique to each isolate and should only be used to make
  * debugging messages more comprehensible.
  */
 DART_EXPORT Dart_Handle Dart_DebugName();
 
 /**
  * Enters an isolate. After calling this function,
  * the current isolate will be set to the provided isolate.
@@ skipping 1556 matching lines @@
  * be loaded in and the isolate can be run by the embedder.
  *
  * NOTE: It is not safe to call this from multiple threads concurrently.
  *
  * \return Returns NULL if an error occurred.
  */
 DART_EXPORT Dart_Isolate Dart_GetServiceIsolate(void* callback_data);
 
 
 #endif  /* INCLUDE_DART_API_H_ */  /* NOLINT */