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_
 
 #ifdef __cplusplus
 #define DART_EXTERN_C extern "C"
 #else
@@ skipping 80 matching lines @@
 // TODO(iposva): Pass a specification of the app file being spawned.
 typedef void* (*Dart_IsolateInitCallback)(void* data);
 
 typedef void (*Dart_NativeFunction)(Dart_NativeArguments arguments);
 typedef Dart_NativeFunction (*Dart_NativeEntryResolver)(Dart_Handle name,
                                                         int num_of_arguments);
 typedef Dart_Result (*Dart_LibraryTagHandler)(Dart_LibraryTag tag,
                                               Dart_Handle library,
                                               Dart_Handle url);
 
+typedef void (*Dart_ExternalString8Finalizer)(uint8_t* codepoints,

[Anton Muhin, 2011/10/26 14:11:53]

I think codepoints may go away---embedder should be able to restore codepoints
from peer if need be.

+                                              void* peer);
+typedef void (*Dart_ExternalString16Finalizer)(uint16_t* codepoints,
+                                               void* peer);
+typedef void (*Dart_ExternalString32Finalizer)(uint32_t* codepoints,
+                                               void* peer);
+
 // TODO(iposva): This is a placeholder for the eventual external Dart API.
 
 // Return value handling after a Dart API call.
 DART_EXPORT bool Dart_IsValidResult(const Dart_Result& result);
 
 inline intptr_t Dart_GetResultAsCIntptr(const Dart_Result& result) {
   assert(result.type_ == kRetCIntptr);  // Valid to access result as C int.
   return result.retval_.int_value;
 }
 inline  Dart_Result Dart_ResultAsCIntptr(intptr_t value) {
@@ skipping 175 matching lines @@
 DART_EXPORT Dart_Result Dart_StringLength(Dart_Handle str);
 
 DART_EXPORT Dart_Handle Dart_NewString(const char* str);
 DART_EXPORT Dart_Handle Dart_NewString8(const uint8_t* codepoints,
                                         intptr_t length);
 DART_EXPORT Dart_Handle Dart_NewString16(const uint16_t* codepoints,
                                          intptr_t length);
 DART_EXPORT Dart_Handle Dart_NewString32(const uint32_t* codepoints,
                                          intptr_t length);
 
+DART_EXPORT Dart_Handle Dart_NewExternalString8(
+    uint8_t* codepoints,
+    intptr_t length,
+    void* peer,
+    Dart_ExternalString8Finalizer finalizer);
+DART_EXPORT Dart_Handle Dart_NewExternalString16(
+    uint16_t* codepoints,
+    intptr_t length,
+    void* peer,
+    Dart_ExternalString16Finalizer finalizer);
+DART_EXPORT Dart_Handle Dart_NewExternalString32(
+    uint32_t* codepoints,
+    intptr_t length,
+    void* peer,
+    Dart_ExternalString32Finalizer finalizer);
+
+
 // The functions below test whether the object is a String and its codepoints
 // all fit into 8 or 16 bits respectively.
 DART_EXPORT bool Dart_IsString8(Dart_Handle object);
 DART_EXPORT bool Dart_IsString16(Dart_Handle object);
 
 DART_EXPORT Dart_Result Dart_StringGet8(Dart_Handle str,
                                         uint8_t* codepoints,
                                         intptr_t length);
 DART_EXPORT Dart_Result Dart_StringGet16(Dart_Handle str,
                                          uint16_t* codepoints,
@@ skipping 129 matching lines @@
 // 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);
 
 // Check set vm flags.
 DART_EXPORT bool Dart_IsVMFlagSet(const char* flag_name);
 
 #endif  // INCLUDE_DART_API_H_