Add external byte array API and finalize external strings and byte arrays.

runtime/vm/dart_api_impl.cc

 // 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.
 
 #include "include/dart_api.h"
 
 #include "vm/bigint_operations.h"
 #include "vm/class_finalizer.h"
 #include "vm/compiler.h"
 #include "vm/dart.h"
@@ skipping 388 matching lines @@
   const Object& old_ref = Object::Handle(Api::UnwrapHandle(object));
   PersistentHandle* new_ref = state->persistent_handles().AllocateHandle();
   new_ref->set_raw(old_ref);
   return reinterpret_cast<Dart_Handle>(new_ref);
 }
 
 
 DART_EXPORT Dart_Handle Dart_NewWeakPersistentHandle(
     Dart_Handle object,
     void* peer,
-    Dart_PeerFinalizer callback) {
+    Dart_WeakPersistentHandleFinalizer callback) {
   Isolate* isolate = Isolate::Current();
   CHECK_ISOLATE(isolate);
   DARTSCOPE_NOCHECKS(isolate);
   ApiState* state = isolate->api_state();
   ASSERT(state != NULL);
-  const Object& old_ref = Object::Handle(Api::UnwrapHandle(object));
-  WeakPersistentHandle* new_ref =
+  const Object& ref = Object::Handle(Api::UnwrapHandle(object));
+  WeakPersistentHandle* weak_ref =
       state->weak_persistent_handles().AllocateHandle();
-  new_ref->set_raw(old_ref);
-  new_ref->set_peer(peer);
-  new_ref->set_callback(callback);
-  return reinterpret_cast<Dart_Handle>(new_ref);
+  weak_ref->set_raw(ref);
+  weak_ref->set_peer(peer);
+  weak_ref->set_callback(callback);
+  return reinterpret_cast<Dart_Handle>(weak_ref);
 }
 
 
 DART_EXPORT void Dart_DeletePersistentHandle(Dart_Handle object) {
   Isolate* isolate = Isolate::Current();
   CHECK_ISOLATE(isolate);
   ApiState* state = isolate->api_state();
   ASSERT(state != NULL);
   if (state->IsValidWeakPersistentHandle(object)) {
     WeakPersistentHandle* weak_ref =
@@ skipping 771 matching lines @@
   *peer = str.GetPeer();
   return Api::Success();
 }
 
 
 DART_EXPORT Dart_Handle Dart_NewExternalString8(const uint8_t* codepoints,
                                                 intptr_t length,
                                                 void* peer,
                                                 Dart_PeerFinalizer callback) {
   DARTSCOPE(Isolate::Current());
+  if (codepoints == NULL && length != 0) {
+    return Api::NewError("%s expects argument 'codepoints' to be non-null.",
+                         CURRENT_FUNC);
+  }
+  if (length < 0) {
+    return Api::NewError("%s expects argument 'length' to be greater than 0.",
+                         CURRENT_FUNC);
+  }
   const String& obj =
       String::Handle(String::NewExternal(codepoints, length, peer, callback));
   return Api::NewLocalHandle(obj);
 }
 
 
 DART_EXPORT Dart_Handle Dart_NewExternalString16(const uint16_t* codepoints,
                                                  intptr_t length,
                                                  void* peer,
                                                  Dart_PeerFinalizer callback) {
   DARTSCOPE(Isolate::Current());
+  if (codepoints == NULL && length != 0) {
+    return Api::NewError("%s expects argument 'codepoints' to be non-null.",
+                         CURRENT_FUNC);
+  }
+  if (length < 0) {
+    return Api::NewError("%s expects argument 'length' to be greater than 0.",
+                         CURRENT_FUNC);
+  }
   const String& obj =
       String::Handle(String::NewExternal(codepoints, length, peer, callback));
   return Api::NewLocalHandle(obj);
 }
 
 
 DART_EXPORT Dart_Handle Dart_NewExternalString32(const uint32_t* codepoints,
                                                  intptr_t length,
                                                  void* peer,
                                                  Dart_PeerFinalizer callback) {
   DARTSCOPE(Isolate::Current());
+  if (codepoints == NULL && length != 0) {
+    return Api::NewError("%s expects argument 'codepoints' to be non-null.",
+                         CURRENT_FUNC);
+  }
+  if (length < 0) {
+    return Api::NewError("%s expects argument 'length' to be greater than 0.",
+                         CURRENT_FUNC);
+  }
   const String& obj =
       String::Handle(String::NewExternal(codepoints, length, peer, callback));
   return Api::NewLocalHandle(obj);
 }
 
 
 DART_EXPORT Dart_Handle Dart_StringGet8(Dart_Handle str,
                                         uint8_t* codepoints,
                                         intptr_t* length) {
   DARTSCOPE(Isolate::Current());
@@ skipping 397 matching lines @@
 
 
 DART_EXPORT Dart_Handle Dart_NewByteArray(intptr_t length) {
   DARTSCOPE(Isolate::Current());
   const InternalByteArray& obj =
       InternalByteArray::Handle(InternalByteArray::New(length));
   return Api::NewLocalHandle(obj);
 }
 
 
+DART_EXPORT Dart_Handle Dart_NewExternalByteArray(uint8_t* data,
+                                                  intptr_t length,
+                                                  void* peer,
+                                                  Dart_PeerFinalizer callback) {
+  DARTSCOPE(Isolate::Current());
+  if (data == NULL && length != 0) {
+    return Api::NewError("%s expects argument 'data' to be non-null.",
+                         CURRENT_FUNC);
+  }
+  if (length < 0) {
+    return Api::NewError("%s expects argument 'length' to be greater than 0.",
+                         CURRENT_FUNC);
+  }
+  const ExternalByteArray& obj =
+      ExternalByteArray::Handle(ExternalByteArray::New(data,
+                                                       length,
+                                                       peer,
+                                                       callback));
+  return Api::NewLocalHandle(obj);
+}
+
+
+DART_EXPORT Dart_Handle Dart_ExternalByteArrayGetPeer(Dart_Handle object,
+                                                      void** peer) {
+  DARTSCOPE(Isolate::Current());
+  const ExternalByteArray& array =
+      Api::UnwrapExternalByteArrayHandle(object);
+  if (array.IsNull()) {
+    RETURN_TYPE_ERROR(object, ExternalByteArray);
+  }
+  if (peer == NULL) {
+    return Api::NewError("%s expects argument 'peer' to be non-null.",
+                         CURRENT_FUNC);
+  }
+  *peer = array.GetPeer();
+  return Api::Success();
+}
+
+
 // --- Closures ---
 
 
 DART_EXPORT bool Dart_IsClosure(Dart_Handle object) {
   DARTSCOPE(Isolate::Current());
   const Object& obj = Object::Handle(Api::UnwrapHandle(object));
   return obj.IsClosure();
 }
 
 
@@ skipping 770 matching lines @@
     }
     delete debug_region;
   } else {
     *buffer = NULL;
     *buffer_size = 0;
   }
 }
 
 
 }  // namespace dart