Correctly mark scalarlists as abstract classes with factory

lib/scalarlist/byte_arrays.dart

 // 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.
 
 /**
  * A random-access sequence of bytes that also provides random access to
  * the fixed-width integers and floating point numbers represented by
  * those bytes. Byte arrays may be used to pack and unpack data from
  * external sources (such as networks or files systems), and to process
  * large quantities of numerical data more efficiently than would be possible
@@ skipping 335 matching lines @@
    */
   ByteArray asByteArray([int start, int length]);
 }
 
 
 /**
  * A fixed-length list of 8-bit signed integers that is viewable as a
  * [ByteArray]. For long lists, this implementation will be considerably
  * more space- and time-efficient than the default [List] implementation.
  */
-class Int8List implements List<int>, ByteArrayViewable {
+abstract class Int8List implements List<int>, ByteArrayViewable {
   /**
    * Creates an [Int8List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
-  external Int8List(int length);
+  external factory Int8List(int length);
 
   /**
    * Creates an [Int8List] _view_ of the specified region in the specified
    * byte [array]. Changes in the [Int8List] will be visible in the byte
    * array and vice versa. If the [start] index of the region is not specified,
    * it defaults to zero (the first byte in the byte array). If the length is
    * not specified, it defaults to null, which indicates that the view extends
    * to the end of the byte array.
    */
-  external Int8List.view(ByteArray array, [int start, int length]);
+  external factory Int8List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of 8-bit unsigned integers that is viewable as a
  * [ByteArray]. For long lists, this implementation will be considerably
  * more space- and time-efficient than the default [List] implementation.
  */
-class Uint8List implements List<int>, ByteArrayViewable {
+abstract class Uint8List implements List<int>, ByteArrayViewable {
   /**
    * Creates a [Uint8List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
-  external Uint8List(int length);
+  external factory Uint8List(int length);
 
   /**
    * Creates a [Uint8List] _view_ of the specified region in the specified
    * byte [array]. Changes in the [Uint8List] will be visible in the byte
    * array and vice versa. If the [start] index of the region is not specified,
    * it defaults to zero (the first byte in the byte array). If the length is
    * not specified, it defaults to null, which indicates that the view extends
    * to the end of the byte array.
    */
-  external Uint8List.view(ByteArray array, [int start, int length]);
+  external factory Uint8List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of 16-bit signed integers that is viewable as a
  * [ByteArray]. For long lists, this implementation will be considerably
  * more space- and time-efficient than the default [List] implementation.
  */
-class Int16List implements List<int>, ByteArrayViewable {
+abstract class Int16List implements List<int>, ByteArrayViewable {
   /**
    * Creates an [Int16List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
-  external Int16List(int length);
+  external factory Int16List(int length);
 
   /**
    * Creates an [Int16List] _view_ of the specified region in the specified
    * byte [array]. Changes in the [Int16List] will be visible in the byte
    * array and vice versa. If the [start] index of the region is not specified,
    * it defaults to zero (the first byte in the byte array). If the length is
    * not specified, it defaults to null, which indicates that the view extends
    * to the end of the byte array.
    *
    * Throws [ArgumentError] if the length of the specified region
    * is not divisible by 2 (the size of an "int16" in bytes), or if the
    * [start] of the region is not divisible by 2. If, however, [array]
    * is a view of another byte array, this constructor will throw
    * [ArgumentError] if the implicit starting position in the
    * "ultimately backing" byte array is not divisible by 2. In plain terms,
    * this constructor throws [ArgumentError] if the specified
    * region does not contain an integral number of "int16s," or if it
    * is not "int16-aligned."
    */
-  external Int16List.view(ByteArray array, [int start, int length]);
+  external factory Int16List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of 16-bit unsigned integers that is viewable as a
  * [ByteArray]. For long lists, this implementation will be considerably
  * more space- and time-efficient than the default [List] implementation.
  */
-class Uint16List implements List<int>, ByteArrayViewable {
+abstract class Uint16List implements List<int>, ByteArrayViewable {
   /**
    * Creates a [Uint16List] of the specified length (in elements), all
    * of whose elements are initially zero.
    */
-  external Uint16List(int length);
+  external factory Uint16List(int length);
 
   /**
    * Creates a [Uint16List] _view_ of the specified region in
    * the specified byte [array]. Changes in the [Uint16List] will be
    * visible in the byte array and vice versa. If the [start] index of the
    * region is not specified, it defaults to zero (the first byte in the byte
    * array). If the length is not specified, it defaults to null, which
    * indicates that the view extends to the end of the byte array.
    *
    * Throws [ArgumentError] if the length of the specified region
    * is not divisible by 2 (the size of a "uint16" in bytes), or if the
    * [start] of the region is not divisible by 2. If, however, [array]
    * is a view of another byte array, this constructor will throw
    * [ArgumentError] if the implicit starting position in the
    * "ultimately backing" byte array is not divisible by 2. In plain terms,
    * this constructor throws [ArgumentError] if the specified
    * region does not contain an integral number of "uint16s," or if it
    * is not "uint16-aligned."
    */
-  external Uint16List.view(ByteArray array, [int start, int length]);
+  external factory Uint16List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of 32-bit signed integers that is viewable as a
  * [ByteArray]. For long lists, this implementation will be considerably
  * more space- and time-efficient than the default [List] implementation.
  */
-class Int32List implements List<int>, ByteArrayViewable {
+abstract class Int32List implements List<int>, ByteArrayViewable {
   /**
    * Creates an [Int32List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
-  external Int32List(int length);
+  external factory Int32List(int length);
 
   /**
    * Creates an [Int32List] _view_ of the specified region in the specified
    * byte [array]. Changes in the [Int32List] will be visible in the byte
    * array and vice versa. If the [start] index of the region is not specified,
    * it defaults to zero (the first byte in the byte array). If the length is
    * not specified, it defaults to null, which indicates that the view extends
    * to the end of the byte array.
    *
    * Throws [ArgumentError] if the length of the specified region
    * is not divisible by 4 (the size of an "int32" in bytes), or if the
    * [start] of the region is not divisible by 4. If, however, [array]
    * is a view of another byte array, this constructor will throw
    * [ArgumentError] if the implicit starting position in the
    * "ultimately backing" byte array is not divisible by 4. In plain terms,
    * this constructor throws [ArgumentError] if the specified
    * region does not contain an integral number of "int32s," or if it
    * is not "int32-aligned."
    */
-  external Int32List.view(ByteArray array, [int start, int length]);
+  external factory Int32List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of 32-bit unsigned integers that is viewable as a
  * [ByteArray]. For long lists, this implementation will be considerably
  * more space- and time-efficient than the default [List] implementation.
  */
-class Uint32List implements List<int>, ByteArrayViewable {
+abstract class Uint32List implements List<int>, ByteArrayViewable {
   /**
    * Creates a [Uint32List] of the specified length (in elements), all
    * of whose elements are initially zero.
    */
-  external Uint32List(int length);
+  external factory Uint32List(int length);
 
   /**
    * Creates a [Uint32List] _view_ of the specified region in
    * the specified byte [array]. Changes in the [Uint32] will be
    * visible in the byte array and vice versa. If the [start] index of the
    * region is not specified, it defaults to zero (the first byte in the byte
    * array). If the length is not specified, it defaults to null, which
    * indicates that the view extends to the end of the byte array.
    *
    * Throws [ArgumentError] if the length of the specified region
    * is not divisible by 4 (the size of a "uint32" in bytes), or if the
    * [start] of the region is not divisible by 4. If, however, [array]
    * is a view of another byte array, this constructor will throw
    * [ArgumentError] if the implicit starting position in the
    * "ultimately backing" byte array is not divisible by 4. In plain terms,
    * this constructor throws [ArgumentError] if the specified
    * region does not contain an integral number of "uint32s," or if it
    * is not "uint32-aligned."
    */
-  external Uint32List.view(ByteArray array, [int start, int length]);
+  external factory Uint32List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of 64-bit signed integers that is viewable as a
  * [ByteArray]. For long lists, this implementation will be considerably
  * more space- and time-efficient than the default [List] implementation.
  */
-class Int64List implements List<int>, ByteArrayViewable {
+abstract class Int64List implements List<int>, ByteArrayViewable {
   /**
    * Creates an [Int64List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
-  external Int64List(int length);
+  external factory Int64List(int length);
 
   /**
    * Creates an [Int64List] _view_ of the specified region in the specified
    * byte [array]. Changes in the [Int64List] will be visible in the byte
    * array and vice versa. If the [start] index of the region is not specified,
    * it defaults to zero (the first byte in the byte array). If the length is
    * not specified, it defaults to null, which indicates that the view extends
    * to the end of the byte array.
    *
    * Throws [ArgumentError] if the length of the specified region
    * is not divisible by 8 (the size of an "int64" in bytes), or if the
    * [start] of the region is not divisible by 8. If, however, [array]
    * is a view of another byte array, this constructor will throw
    * [ArgumentError] if the implicit starting position in the
    * "ultimately backing" byte array is not divisible by 8. In plain terms,
    * this constructor throws [ArgumentError] if the specified
    * region does not contain an integral number of "int64s," or if it
    * is not "int64-aligned."
    */
-  external Int64List.view(ByteArray array, [int start, int length]);
+  external factory Int64List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of 64-bit unsigned integers that is viewable as a
  * [ByteArray]. For long lists, this implementation will be considerably
  * more space- and time-efficient than the default [List] implementation.
  */
-class Uint64List implements List<int>, ByteArrayViewable {
+abstract class Uint64List implements List<int>, ByteArrayViewable {
   /**
    * Creates a [Uint64List] of the specified length (in elements), all
    * of whose elements are initially zero.
    */
-  external Uint64List(int length);
+  external factory Uint64List(int length);
 
   /**
    * Creates an [Uint64List] _view_ of the specified region in
    * the specified byte [array]. Changes in the [Uint64List] will be
    * visible in the byte array and vice versa. If the [start] index of the
    * region is not specified, it defaults to zero (the first byte in the byte
    * array). If the length is not specified, it defaults to null, which
    * indicates that the view extends to the end of the byte array.
    *
    * Throws [ArgumentError] if the length of the specified region
    * is not divisible by 8 (the size of a "uint64" in bytes), or if the
    * [start] of the region is not divisible by 8. If, however, [array]
    * is a view of another byte array, this constructor will throw
    * [ArgumentError] if the implicit starting position in the
    * "ultimately backing" byte array is not divisible by 8. In plain terms,
    * this constructor throws [ArgumentError] if the specified
    * region does not contain an integral number of "uint64s," or if it
    * is not "uint64-aligned."
    */
-  external Uint64List.view(ByteArray array, [int start, int length]);
+  external factory Uint64List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of IEEE 754 single-precision binary floating-point
  * numbers  that is viewable as a [ByteArray]. For long lists, this
  * implementation will be considerably more space- and time-efficient than
  * the default [List] implementation.
  */
-class Float32List implements List<double>, ByteArrayViewable {
+abstract class Float32List implements List<double>, ByteArrayViewable {
   /**
    * Creates a [Float32List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
-  external Float32List(int length);
+  external factory Float32List(int length);
 
   /**
    * Creates a [Float32List] _view_ of the specified region in the specified
    * byte [array]. Changes in the [Float32List] will be visible in the byte
    * array and vice versa. If the [start] index of the region is not specified,
    * it defaults to zero (the first byte in the byte array). If the length is
    * not specified, it defaults to null, which indicates that the view extends
    * to the end of the byte array.
    *
    * Throws [ArgumentError] if the length of the specified region
    * is not divisible by 4 (the size of a "float32" in bytes), or if the
    * [start] of the region is not divisible by 4. If, however, [array]
    * is a view of another byte array, this constructor will throw
    * [ArgumentError] if the implicit starting position in the
    * "ultimately backing" byte array is not divisible by 4. In plain terms,
    * this constructor throws [ArgumentError] if the specified
    * region does not contain an integral number of "float32s," or if it
    * is not "float32-aligned."
    */
-  external Float32List.view(ByteArray array, [int start, int length]);
+  external factory Float32List.view(ByteArray array, [int start, int length]);
 }
 
 
 /**
  * A fixed-length list of IEEE 754 double-precision binary floating-point
  * numbers  that is viewable as a [ByteArray]. For long lists, this
  * implementation will be considerably more space- and time-efficient than
  * the default [List] implementation.
  */
-class Float64List implements List<double>, ByteArrayViewable {
+abstract class Float64List implements List<double>, ByteArrayViewable {
   /**
    * Creates a [Float64List] of the specified length (in elements), all of
    * whose elements are initially zero.
    */
-  external Float64List(int length);
+  external factory Float64List(int length);
 
   /**
    * Creates a [Float64List] _view_ of the specified region in the specified
    * byte [array]. Changes in the [Float64List] will be visible in the byte
    * array and vice versa. If the [start] index of the region is not specified,
    * it defaults to zero (the first byte in the byte array). If the length is
    * not specified, it defaults to null, which indicates that the view extends
    * to the end of the byte array.
    *
    * Throws [ArgumentError] if the length of the specified region
    * is not divisible by 8 (the size of a "float64" in bytes), or if the
    * [start] of the region is not divisible by 8. If, however, [array]
    * is a view of another byte array, this constructor will throw
    * [ArgumentError] if the implicit starting position in the
    * "ultimately backing" byte array is not divisible by 8. In plain terms,
    * this constructor throws [ArgumentError] if the specified
    * region does not contain an integral number of "float64s," or if it
    * is not "float64-aligned."
    */
-  external Float64List.view(ByteArray array, [int start, int length]);
+  external factory Float64List.view(ByteArray array, [int start, int length]);
 }