Implement external strings.

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 694 matching lines @@
  *
  * \param value An array of 32-bit codepoints.
  * \param length The length of the codepoints array.
  *
  * \return The String object if no errors occurs. Otherwise returns
  *   an invalid handle.
  */
 DART_EXPORT Dart_Handle Dart_NewString32(const uint32_t* codepoints,
                                          intptr_t length);
 
+
+typedef void (*Dart_PeerFinalizer)(void* peer);
+
+DART_EXPORT Dart_Handle Dart_NewExternalString8(const uint8_t* codepoints,
+                                                intptr_t length,
+                                                void* peer,
+                                                Dart_PeerFinalizer callback);
+
+DART_EXPORT Dart_Handle Dart_NewExternalString16(const uint16_t* codepoints,
+                                                 intptr_t length,
+                                                 void* peer,
+                                                 Dart_PeerFinalizer callback);
+
+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.
  *
  * \param str A string.
  * \param codepoints An array allocated by the caller, used to return
  *   the array of codepoints.
  * \param length Used to pass in the length of the provided array.
@@ skipping 406 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_