Add fromList constructor to typeddata typed lists.

sdk/lib/typeddata/typeddata.dart

 // Copyright (c) 2013, 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.
 
 library dart.typeddata;
 
 import 'dart:collection';
 
 /**
  * A sequence of bytes underlying a typed data object.
@@ skipping 309 matching lines @@
  * more space- and time-efficient than the default [List] implementation.
  */
 abstract class Int8List implements List<int>, TypedData {
   /**
    * Creates an [Int8List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
   external factory Int8List(int length);
 
   /**
+   * Creates a [Int8List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Int8List.fromList(List<int> elements);
+
+  /**
    * Creates an [Int8List] _view_ of the specified region in the specified
    * byte buffer. Changes in the [Int8List] will be visible in the byte
    * buffer and vice versa. If the [offsetInBytes] index of the region is not
    * specified, it defaults to zero (the first byte in the byte buffer).
    * If the length is not specified, it defaults to null, which indicates
    * that the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 11 matching lines @@
  * more space- and time-efficient than the default [List] implementation.
  */
 abstract class Uint8List implements List<int>, TypedData {
   /**
    * Creates a [Uint8List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
   external factory Uint8List(int length);
 
   /**
+   * Creates a [Uint8List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Uint8List.fromList(List<int> elements);
+
+  /**
    * Creates a [Uint8List] _view_ of the specified region in the specified
    * byte buffer. Changes in the [Uint8List] will be visible in the byte
    * buffer and vice versa. If the [offsetInBytes] index of the region is not
    * specified, it defaults to zero (the first byte in the byte buffer).
    * If the length is not specified, it defaults to null, which indicates
    * that the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 12 matching lines @@
  * Indexed store clamps the value to range 0..0xFF.
  */
 abstract class Uint8ClampedList implements List<int>, TypedData {
   /**
    * Creates a [Uint8ClampedList] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
   external factory Uint8ClampedList(int length);
 
   /**
+   * Creates a [Uint8ClampedList] of the same size as the [elements]
+   * list and copies over the values clamping when needed.
+   */
+  external factory Uint8ClampedList.fromList(List<int> elements);
+
+  /**
    * Creates a [Uint8ClampedList] _view_ of the specified region in the
    * specified byte [buffer]. Changes in the [Uint8List] will be visible in the
    * byte buffer and vice versa. If the [offsetInBytes] index of the region is
    * not specified, it defaults to zero (the first byte in the byte buffer).
    * If the length is not specified, it defaults to null, which indicates that
    * the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 11 matching lines @@
  * more space- and time-efficient than the default [List] implementation.
  */
 abstract class Int16List implements List<int>, TypedData {
   /**
    * Creates an [Int16List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
   external factory Int16List(int length);
 
   /**
+   * Creates a [Int16List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Int16List.fromList(List<int> elements);
+
+  /**
    * Creates an [Int16List] _view_ of the specified region in the specified
    * byte buffer. Changes in the [Int16List] will be visible in the byte
    * buffer and vice versa. If the [offsetInBytes] index of the region is not
    * specified, it defaults to zero (the first byte in the byte buffer).
    * If the length is not specified, it defaults to null, which indicates
    * that the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 14 matching lines @@
  * more space- and time-efficient than the default [List] implementation.
  */
 abstract class Uint16List implements List<int>, TypedData {
   /**
    * Creates a [Uint16List] of the specified length (in elements), all
    * of whose elements are initially zero.
    */
   external factory Uint16List(int length);
 
   /**
+   * Creates a [Uint16List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Uint16List.fromList(List<int> elements);
+
+  /**
    * Creates a [Uint16List] _view_ of the specified region in
    * the specified byte buffer. Changes in the [Uint16List] will be
    * visible in the byte buffer and vice versa. If the [offsetInBytes] index
    * of the region is not specified, it defaults to zero (the first byte in
    * the byte buffer). If the length is not specified, it defaults to null,
    * which indicates that the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 14 matching lines @@
  * more space- and time-efficient than the default [List] implementation.
  */
 abstract class Int32List implements List<int>, TypedData {
   /**
    * Creates an [Int32List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
   external factory Int32List(int length);
 
   /**
+   * Creates a [Int32List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Int32List.fromList(List<int> elements);
+
+  /**
    * Creates an [Int32List] _view_ of the specified region in the specified
    * byte buffer. Changes in the [Int32List] will be visible in the byte
    * buffer and vice versa. If the [offsetInBytes] index of the region is not
    * specified, it defaults to zero (the first byte in the byte buffer).
    * If the length is not specified, it defaults to null, which indicates
    * that the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 14 matching lines @@
  * more space- and time-efficient than the default [List] implementation.
  */
 abstract class Uint32List implements List<int>, TypedData {
   /**
    * Creates a [Uint32List] of the specified length (in elements), all
    * of whose elements are initially zero.
    */
   external factory Uint32List(int length);
 
   /**
+   * Creates a [Uint32List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Uint32List.fromList(List<int> elements);
+
+  /**
    * Creates a [Uint32List] _view_ of the specified region in
    * the specified byte buffer. Changes in the [Uint32] will be
    * visible in the byte buffer and vice versa. If the [offsetInBytes] index
    * of the region is not specified, it defaults to zero (the first byte in
    * the byte buffer). If the length is not specified, it defaults to null,
    * which indicates that the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 14 matching lines @@
  * more space- and time-efficient than the default [List] implementation.
  */
 abstract class Int64List implements List<int>, TypedData {
   /**
    * Creates an [Int64List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
   external factory Int64List(int length);
 
   /**
+   * Creates a [Int64List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Int64List.fromList(List<int> elements);
+
+  /**
    * Creates an [Int64List] _view_ of the specified region in the specified
    * byte buffer. Changes in the [Int64List] will be visible in the byte buffer
    * and vice versa. If the [offsetInBytes] index of the region is not
    * specified, it defaults to zero (the first byte in the byte buffer).
    * If the length is not specified, it defaults to null, which indicates that
    * the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 14 matching lines @@
  * more space- and time-efficient than the default [List] implementation.
  */
 abstract class Uint64List implements List<int>, TypedData {
   /**
    * Creates a [Uint64List] of the specified length (in elements), all
    * of whose elements are initially zero.
    */
   external factory Uint64List(int length);
 
   /**
+   * Creates a [Uint64List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Uint64List.fromList(List<int> elements);
+
+  /**
    * Creates an [Uint64List] _view_ of the specified region in
    * the specified byte buffer. Changes in the [Uint64List] will be
    * visible in the byte buffer and vice versa. If the [offsetInBytes]
    * index of the region is not specified, it defaults to zero (the first
    * byte in the byte buffer). If the length is not specified, it defaults
    * to null, which indicates that the view extends to the end of the byte
    * buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
@@ skipping 16 matching lines @@
  * the default [List] implementation.
  */
 abstract class Float32List implements List<double>, TypedData {
   /**
    * Creates a [Float32List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
   external factory Float32List(int length);
 
   /**
+   * Creates a [Float32List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Float32List.fromList(List<double> elements);
+
+  /**
    * Creates a [Float32List] _view_ of the specified region in the specified
    * byte buffer. Changes in the [Float32List] will be visible in the byte
    * buffer and vice versa. If the [offsetInBytes] index of the region is not
    * specified, it defaults to zero (the first byte in the byte buffer).
    * If the length is not specified, it defaults to null, which indicates
    * that the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 15 matching lines @@
  * the default [List] implementation.
  */
 abstract class Float64List implements List<double>, TypedData {
   /**
    * Creates a [Float64List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
   external factory Float64List(int length);
 
   /**
+   * Creates a [Float64List] with the same size as the [elements] list
+   * and copies over the elements.
+   */
+  external factory Float64List.fromList(List<double> elements);
+
+  /**
    * Creates a [Float64List] _view_ of the specified region in the specified
    * byte buffer. Changes in the [Float64List] will be visible in the byte
    * buffer and vice versa. If the [offsetInBytes] index of the region is not
    * specified, it defaults to zero (the first byte in the byte buffer).
    * If the length is not specified, it defaults to null, which indicates
    * that the view extends to the end of the byte buffer.
    *
    * Throws [RangeError] if [offsetInBytes] or [length] are negative, or
    * if [offsetInBytes] + ([length] * elementSizeInBytes) is greater than
    * the length of [buffer].
@@ skipping 184 matching lines @@
   Uint32x4 withFlagW(bool w);
 
   /// Merge [trueValue] and [falseValue] based on [this]' bit mask:
   /// Select bit from [trueValue] when bit in [this] is on.
   /// Select bit from [falseValue] when bit in [this] is off.
   Float32x4 select(Float32x4 trueValue, Float32x4 falseValue);
 
   /// Returns a bit-wise copy of [this] as a [Float32x4].
   Float32x4 toFloat32x4();
 }