Add Dart_IsExternalString and Dart_ExternalStringGetPeer to the dart

runtime/include/dart_api.h

 // Copyright (c) 2011, 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 770 matching lines @@
  *
  * \return The String object if no error occurs. Otherwise returns
  *   an error handle.
  */
 DART_EXPORT Dart_Handle Dart_NewString32(const uint32_t* codepoints,
                                          intptr_t length);
 
 
 typedef void (*Dart_PeerFinalizer)(void* peer);
 
+/**
+ * Is this object an external String?
+ *
+ * An external String is a String which references a fixed array of
+ * codepoints which is external to the Dart heap.
+ */
+DART_EXPORT bool Dart_IsExternalString(Dart_Handle object);
+
+/**
+ * Retrieves the peer pointer associated with an external String.
+ */
+DART_EXPORT Dart_Handle Dart_ExternalStringGetPeer(Dart_Handle object,
+                                                   void** peer);
+
+
+/**
+ * Returns a String which references an external array of 8-bit codepoints.
+ *
+ * \param value An array of 8-bit codepoints.  This array must not move.
+ * \param length The length of the codepoints array.
+ * \param peer An external pointer to associate with this string.
+ * \param callback A callback to be called when this string is finalized.
+ *
+ * \return The String object if no error occurs. Otherwise returns
+ *   an error handle.
+ */
 DART_EXPORT Dart_Handle Dart_NewExternalString8(const uint8_t* codepoints,
                                                 intptr_t length,
                                                 void* peer,
                                                 Dart_PeerFinalizer callback);
 
+/**
+ * Returns a String which references an external array of 16-bit codepoints.
+ *
+ * \param value An array of 16-bit codepoints.  This array must not move.
+ * \param length The length of the codepoints array.
+ * \param peer An external pointer to associate with this string.
+ * \param callback A callback to be called when this string is finalized.
+ *
+ * \return The String object if no error occurs. Otherwise returns
+ *   an error handle.
+ */
 DART_EXPORT Dart_Handle Dart_NewExternalString16(const uint16_t* codepoints,
                                                  intptr_t length,
                                                  void* peer,
                                                  Dart_PeerFinalizer callback);
 
+/**
+ * Returns a String which references an external array of 32-bit codepoints.
+ *
+ * \param value An array of 32-bit codepoints.  This array must not move.
+ * \param length The length of the codepoints array.
+ * \param peer An external pointer to associate with this string.
+ * \param callback A callback to be called when this string is finalized.
+ *
+ * \return The String object if no error occurs. Otherwise returns
+ *   an error handle.
+ */
 DART_EXPORT Dart_Handle Dart_NewExternalString32(const uint32_t* codepoints,
                                                  intptr_t length,
                                                  void* peer,
                                                  Dart_PeerFinalizer callback);
 
 /**
  * Gets the codepoints from a String.
  *
  * This function is only valid on strings for which Dart_IsString8 is
  * true. Otherwise an error occurs.
@@ skipping 416 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_