Add Dart class for _ExternalUint8ClampedArray and API to allocate it.

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
  *
  * Dart is a class-based programming language for creating structured
@@ skipping 1654 matching lines @@
  *
  * \return The ByteArray object if no error occurs. Otherwise returns
  *   an error handle.
  */
 DART_EXPORT Dart_Handle Dart_NewExternalByteArray(uint8_t* data,
                                                   intptr_t length,
                                                   void* peer,
                                                   Dart_PeerFinalizer callback);
 
 /**
+ * Returns a clamped ByteArray which references an external array of
+ * 8-bit bytes.

[siva, 2013/01/15 00:54:23]

Maybe we should also add a line here which explains what a clamped ByteArray is.

[srdjan, 2013/01/15 01:11:10]

Done.

+ *
+ * \param value An array of 8-bit bytes. This array must not move.
+ * \param length The length of the array.
+ * \param peer An external pointer to associate with this byte array.
+ *
+ * \return The ByteArray object if no error occurs. Otherwise returns

[siva, 2013/01/15 00:54:23]

The clamped ByteArray object if

[srdjan, 2013/01/15 01:11:10]

Done.

+ *   an error handle.
+ */
+DART_EXPORT Dart_Handle Dart_NewExternalClampedByteArray(
+    uint8_t* data,
+    intptr_t length,
+    void* peer,
+    Dart_PeerFinalizer callback);
+
+/**
  * Retrieves the data pointer associated with an external ByteArray.
  */
 DART_EXPORT Dart_Handle Dart_ExternalByteArrayGetData(Dart_Handle object,
                                                       void** data);
 
 /**
  * Retrieves the peer pointer associated with an external ByteArray.
  */
 DART_EXPORT Dart_Handle Dart_ExternalByteArrayGetPeer(Dart_Handle object,
                                                       void** peer);
@@ skipping 1122 matching lines @@
  *
  * \param object An object.
  * \param peer A value to store in the peer field.
  *
  * \return Returns an error if 'object' is a subtype of Null, num, or
  *   bool.
  */
 DART_EXPORT Dart_Handle Dart_SetPeer(Dart_Handle object, void* peer);
 
 #endif  // INCLUDE_DART_API_H_