Initialize dart-lang/tuple with the tuple package at v1.0.1.

lib/src/tuple.dart

+// Copyright (c) 2014, the tuple 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.
+
+part of tuple;
+
+/// Represents a 2-tuple, or pair.
+class Tuple2<T1, T2> {
+  /// Returns the first item of the tuple
+  final T1 item1;
+
+  /// Returns the second item of the tuple
+  final T2 item2;
+
+  /// Creates a new tuple value with the specified items.
+  const Tuple2(this.item1, this.item2);
+
+  /// Create a new tuple value with the specified list [items].
+  factory Tuple2.fromList(List items) {
+    if (items.length != 2) {
+      throw new ArgumentError('items must have length 2');
+    }
+
+    return new Tuple2<T1, T2>(items[0] as T1, items[1] as T2);
+  }
+
+  /// Returns a tuple with the first item set to the specified value.
+  Tuple2<T1, T2> withItem1(T1 v) {
+    return new Tuple2<T1, T2>(v, item2);
+  }
+
+  /// Returns a tuple with the second item set to the specified value.
+  Tuple2<T1, T2> withItem2(T2 v) {
+    return new Tuple2<T1, T2>(item1, v);
+  }
+
+  /// Creates a [List] containing the items of this [Tuple2].
+  ///
+  /// The elements are in item order. The list is variable-length
+  /// if [growable] is true.
+  List toList({bool growable: false}) =>
+      new List.from([item1, item2], growable: growable);
+
+  @override
+  String toString() => '[$item1, $item2]';
+
+  @override
+  bool operator ==(o) => o is Tuple2 && o.item1 == item1 && o.item2 == item2;
+
+  @override
+  int get hashCode => hash2(item1.hashCode, item2.hashCode);
+}
+
+/// Represents a 3-tuple, or triple.
+class Tuple3<T1, T2, T3> {
+  /// Returns the first item of the tuple
+  final T1 item1;
+
+  /// Returns the second item of the tuple
+  final T2 item2;
+
+  /// Returns the third item of the tuple
+  final T3 item3;
+
+  /// Creates a new tuple value with the specified items.
+  const Tuple3(this.item1, this.item2, this.item3);
+
+  /// Create a new tuple value with the specified list [items].
+  factory Tuple3.fromList(List items) {
+    if (items.length != 3) {
+      throw new ArgumentError('items must have length 3');
+    }
+
+    return new Tuple3<T1, T2, T3>(
+        items[0] as T1, items[1] as T2, items[2] as T3);
+  }
+
+  /// Returns a tuple with the first item set to the specified value.
+  Tuple3<T1, T2, T3> withItem1(T1 v) {
+    return new Tuple3<T1, T2, T3>(v, item2, item3);
+  }
+
+  /// Returns a tuple with the second item set to the specified value.
+  Tuple3<T1, T2, T3> withItem2(T2 v) {
+    return new Tuple3<T1, T2, T3>(item1, v, item3);
+  }
+
+  /// Returns a tuple with the third item set to the specified value.
+  Tuple3<T1, T2, T3> withItem3(T3 v) {
+    return new Tuple3<T1, T2, T3>(item1, item2, v);
+  }
+
+  /// Creates a [List] containing the items of this [Tuple3].
+  ///
+  /// The elements are in item order. The list is variable-length
+  /// if [growable] is true.
+  List toList({bool growable: false}) =>
+      new List.from([item1, item2, item3], growable: growable);
+
+  @override
+  String toString() => '[$item1, $item2, $item3]';
+
+  @override
+  bool operator ==(o) =>
+      o is Tuple3 && o.item1 == item1 && o.item2 == item2 && o.item3 == item3;
+
+  @override
+  int get hashCode => hash3(item1.hashCode, item2.hashCode, item3.hashCode);
+}
+
+/// Represents a 4-tuple, or quadruple.
+class Tuple4<T1, T2, T3, T4> {
+  /// Returns the first item of the tuple
+  final T1 item1;
+
+  /// Returns the second item of the tuple
+  final T2 item2;
+
+  /// Returns the third item of the tuple
+  final T3 item3;
+
+  /// Returns the fourth item of the tuple
+  final T4 item4;
+
+  /// Creates a new tuple value with the specified items.
+  const Tuple4(this.item1, this.item2, this.item3, this.item4);
+
+  /// Create a new tuple value with the specified list [items].
+  factory Tuple4.fromList(List items) {
+    if (items.length != 4) {
+      throw new ArgumentError('items must have length 4');
+    }
+
+    return new Tuple4<T1, T2, T3, T4>(
+        items[0] as T1, items[1] as T2, items[2] as T3, items[3] as T4);
+  }
+
+  /// Returns a tuple with the first item set to the specified value.
+  Tuple4<T1, T2, T3, T4> withItem1(T1 v) {
+    return new Tuple4<T1, T2, T3, T4>(v, item2, item3, item4);
+  }
+
+  /// Returns a tuple with the second item set to the specified value.
+  Tuple4<T1, T2, T3, T4> withItem2(T2 v) {
+    return new Tuple4<T1, T2, T3, T4>(item1, v, item3, item4);
+  }
+
+  /// Returns a tuple with the third item set to the specified value.
+  Tuple4<T1, T2, T3, T4> withItem3(T3 v) {
+    return new Tuple4<T1, T2, T3, T4>(item1, item2, v, item4);
+  }
+
+  /// Returns a tuple with the fourth item set to the specified value.
+  Tuple4<T1, T2, T3, T4> withItem4(T4 v) {
+    return new Tuple4<T1, T2, T3, T4>(item1, item2, item3, v);
+  }
+
+  /// Creates a [List] containing the items of this [Tuple4].
+  ///
+  /// The elements are in item order. The list is variable-length
+  /// if [growable] is true.
+  List toList({bool growable: false}) =>
+      new List.from([item1, item2, item3, item4], growable: growable);
+
+  @override
+  String toString() => '[$item1, $item2, $item3, $item4]';
+
+  @override
+  bool operator ==(o) => o is Tuple4 &&
+      o.item1 == item1 &&
+      o.item2 == item2 &&
+      o.item3 == item3 &&
+      o.item4 == item4;
+
+  @override
+  int get hashCode =>
+      hash4(item1.hashCode, item2.hashCode, item3.hashCode, item4.hashCode);
+}
+
+/// Represents a 5-tuple, or quintuple.
+class Tuple5<T1, T2, T3, T4, T5> {
+  /// Returns the first item of the tuple
+  final T1 item1;
+
+  /// Returns the second item of the tuple
+  final T2 item2;
+
+  /// Returns the third item of the tuple
+  final T3 item3;
+
+  /// Returns the fourth item of the tuple
+  final T4 item4;
+
+  /// Returns the fifth item of the tuple
+  final T5 item5;
+
+  /// Creates a new tuple value with the specified items.
+  const Tuple5(this.item1, this.item2, this.item3, this.item4, this.item5);
+
+  /// Create a new tuple value with the specified list [items].
+  factory Tuple5.fromList(List items) {
+    if (items.length != 5) {
+      throw new ArgumentError('items must have length 5');
+    }
+
+    return new Tuple5<T1, T2, T3, T4, T5>(items[0] as T1, items[1] as T2,
+        items[2] as T3, items[3] as T4, items[4] as T5);
+  }
+
+  /// Returns a tuple with the first item set to the specified value.
+  Tuple5<T1, T2, T3, T4, T5> withItem1(T1 v) {
+    return new Tuple5<T1, T2, T3, T4, T5>(v, item2, item3, item4, item5);
+  }
+
+  /// Returns a tuple with the second item set to the specified value.
+  Tuple5<T1, T2, T3, T4, T5> withItem2(T2 v) {
+    return new Tuple5<T1, T2, T3, T4, T5>(item1, v, item3, item4, item5);
+  }
+
+  /// Returns a tuple with the third item set to the specified value.
+  Tuple5<T1, T2, T3, T4, T5> withItem3(T3 v) {
+    return new Tuple5<T1, T2, T3, T4, T5>(item1, item2, v, item4, item5);
+  }
+
+  /// Returns a tuple with the fourth item set to the specified value.
+  Tuple5<T1, T2, T3, T4, T5> withItem4(T4 v) {
+    return new Tuple5<T1, T2, T3, T4, T5>(item1, item2, item3, v, item5);
+  }
+
+  /// Returns a tuple with the fifth item set to the specified value.
+  Tuple5<T1, T2, T3, T4, T5> withItem5(T5 v) {
+    return new Tuple5<T1, T2, T3, T4, T5>(item1, item2, item3, item4, v);
+  }
+
+  /// Creates a [List] containing the items of this [Tuple5].
+  ///
+  /// The elements are in item order. The list is variable-length
+  /// if [growable] is true.
+  List toList({bool growable: false}) =>
+      new List.from([item1, item2, item3, item4, item5], growable: growable);
+
+  @override
+  String toString() => '[$item1, $item2, $item3, $item4, $item5]';
+
+  @override
+  bool operator ==(o) => o is Tuple5 &&
+      o.item1 == item1 &&
+      o.item2 == item2 &&
+      o.item3 == item3 &&
+      o.item4 == item4 &&
+      o.item5 == item5;
+
+  @override
+  int get hashCode => hashObjects([
+        item1.hashCode,
+        item2.hashCode,
+        item3.hashCode,
+        item4.hashCode,
+        item5.hashCode
+      ]);
+}
+
+/// Represents a 6-tuple, or sextuple.
+class Tuple6<T1, T2, T3, T4, T5, T6> {
+  /// Returns the first item of the tuple
+  final T1 item1;
+
+  /// Returns the second item of the tuple
+  final T2 item2;
+
+  /// Returns the third item of the tuple
+  final T3 item3;
+
+  /// Returns the fourth item of the tuple
+  final T4 item4;
+
+  /// Returns the fifth item of the tuple
+  final T5 item5;
+
+  /// Returns the sixth item of the tuple
+  final T6 item6;
+
+  /// Creates a new tuple value with the specified items.
+  const Tuple6(
+      this.item1, this.item2, this.item3, this.item4, this.item5, this.item6);
+
+  /// Create a new tuple value with the specified list [items].
+  factory Tuple6.fromList(List items) {
+    if (items.length != 6) {
+      throw new ArgumentError('items must have length 6');
+    }
+
+    return new Tuple6<T1, T2, T3, T4, T5, T6>(items[0] as T1, items[1] as T2,
+        items[2] as T3, items[3] as T4, items[4] as T5, items[5] as T6);
+  }
+
+  /// Returns a tuple with the first item set to the specified value.
+  Tuple6<T1, T2, T3, T4, T5, T6> withItem1(T1 v) {
+    return new Tuple6<T1, T2, T3, T4, T5, T6>(
+        v, item2, item3, item4, item5, item6);
+  }
+
+  /// Returns a tuple with the second item set to the specified value.
+  Tuple6<T1, T2, T3, T4, T5, T6> withItem2(T2 v) {
+    return new Tuple6<T1, T2, T3, T4, T5, T6>(
+        item1, v, item3, item4, item5, item6);
+  }
+
+  /// Returns a tuple with the third item set to the specified value.
+  Tuple6<T1, T2, T3, T4, T5, T6> withItem3(T3 v) {
+    return new Tuple6<T1, T2, T3, T4, T5, T6>(
+        item1, item2, v, item4, item5, item6);
+  }
+
+  /// Returns a tuple with the fourth item set to the specified value.
+  Tuple6<T1, T2, T3, T4, T5, T6> withItem4(T4 v) {
+    return new Tuple6<T1, T2, T3, T4, T5, T6>(
+        item1, item2, item3, v, item5, item6);
+  }
+
+  /// Returns a tuple with the fifth item set to the specified value.
+  Tuple6<T1, T2, T3, T4, T5, T6> withItem5(T5 v) {
+    return new Tuple6<T1, T2, T3, T4, T5, T6>(
+        item1, item2, item3, item4, v, item6);
+  }
+
+  /// Returns a tuple with the sixth item set to the specified value.
+  Tuple6<T1, T2, T3, T4, T5, T6> withItem6(T6 v) {
+    return new Tuple6<T1, T2, T3, T4, T5, T6>(
+        item1, item2, item3, item4, item5, v);
+  }
+
+  /// Creates a [List] containing the items of this [Tuple5].
+  ///
+  /// The elements are in item order. The list is variable-length
+  /// if [growable] is true.
+  List toList({bool growable: false}) =>
+      new List.from([item1, item2, item3, item4, item5, item6],
+          growable: growable);
+
+  @override
+  String toString() => '[$item1, $item2, $item3, $item4, $item5, $item6]';
+
+  @override
+  bool operator ==(o) => o is Tuple6 &&
+      o.item1 == item1 &&
+      o.item2 == item2 &&
+      o.item3 == item3 &&
+      o.item4 == item4 &&
+      o.item5 == item5 &&
+      o.item6 == item6;
+
+  @override
+  int get hashCode => hashObjects([
+        item1.hashCode,
+        item2.hashCode,
+        item3.hashCode,
+        item4.hashCode,
+        item5.hashCode,
+        item6.hashCode
+      ]);
+}
+
+/// Represents a 7-tuple, or septuple.
+class Tuple7<T1, T2, T3, T4, T5, T6, T7> {
+  /// Returns the first item of the tuple
+  final T1 item1;
+
+  /// Returns the second item of the tuple
+  final T2 item2;
+
+  /// Returns the third item of the tuple
+  final T3 item3;
+
+  /// Returns the fourth item of the tuple
+  final T4 item4;
+
+  /// Returns the fifth item of the tuple
+  final T5 item5;
+
+  /// Returns the sixth item of the tuple
+  final T6 item6;
+
+  /// Returns the seventh item of the tuple
+  final T7 item7;
+
+  /// Creates a new tuple value with the specified items.
+  const Tuple7(this.item1, this.item2, this.item3, this.item4, this.item5,
+      this.item6, this.item7);
+
+  /// Create a new tuple value with the specified list [items].
+  factory Tuple7.fromList(List items) {
+    if (items.length != 7) {
+      throw new ArgumentError('items must have length 7');
+    }
+
+    return new Tuple7<T1, T2, T3, T4, T5, T6, T7>(
+        items[0] as T1,
+        items[1] as T2,
+        items[2] as T3,
+        items[3] as T4,
+        items[4] as T5,
+        items[5] as T6,
+        items[6] as T7);
+  }
+
+  /// Returns a tuple with the first item set to the specified value.
+  Tuple7<T1, T2, T3, T4, T5, T6, T7> withItem1(T1 v) {
+    return new Tuple7<T1, T2, T3, T4, T5, T6, T7>(
+        v, item2, item3, item4, item5, item6, item7);
+  }
+
+  /// Returns a tuple with the second item set to the specified value.
+  Tuple7<T1, T2, T3, T4, T5, T6, T7> withItem2(T2 v) {
+    return new Tuple7<T1, T2, T3, T4, T5, T6, T7>(
+        item1, v, item3, item4, item5, item6, item7);
+  }
+
+  /// Returns a tuple with the third item set to the specified value.
+  Tuple7<T1, T2, T3, T4, T5, T6, T7> withItem3(T3 v) {
+    return new Tuple7<T1, T2, T3, T4, T5, T6, T7>(
+        item1, item2, v, item4, item5, item6, item7);
+  }
+
+  /// Returns a tuple with the fourth item set to the specified value.
+  Tuple7<T1, T2, T3, T4, T5, T6, T7> withItem4(T4 v) {
+    return new Tuple7<T1, T2, T3, T4, T5, T6, T7>(
+        item1, item2, item3, v, item5, item6, item7);
+  }
+
+  /// Returns a tuple with the fifth item set to the specified value.
+  Tuple7<T1, T2, T3, T4, T5, T6, T7> withItem5(T5 v) {
+    return new Tuple7<T1, T2, T3, T4, T5, T6, T7>(
+        item1, item2, item3, item4, v, item6, item7);
+  }
+
+  /// Returns a tuple with the sixth item set to the specified value.
+  Tuple7<T1, T2, T3, T4, T5, T6, T7> withItem6(T6 v) {
+    return new Tuple7<T1, T2, T3, T4, T5, T6, T7>(
+        item1, item2, item3, item4, item5, v, item7);
+  }
+
+  /// Returns a tuple with the seventh item set to the specified value.
+  Tuple7<T1, T2, T3, T4, T5, T6, T7> withItem7(T7 v) {
+    return new Tuple7<T1, T2, T3, T4, T5, T6, T7>(
+        item1, item2, item3, item4, item5, item6, v);
+  }
+
+  /// Creates a [List] containing the items of this [Tuple5].
+  ///
+  /// The elements are in item order. The list is variable-length
+  /// if [growable] is true.
+  List toList({bool growable: false}) =>
+      new List.from([item1, item2, item3, item4, item5, item6, item7],
+          growable: growable);
+
+  @override
+  String toString() =>
+      '[$item1, $item2, $item3, $item4, $item5, $item6, $item7]';
+
+  @override
+  bool operator ==(o) => o is Tuple7 &&
+      o.item1 == item1 &&
+      o.item2 == item2 &&
+      o.item3 == item3 &&
+      o.item4 == item4 &&
+      o.item5 == item5 &&
+      o.item5 == item6 &&
+      o.item6 == item7;
+
+  @override
+  int get hashCode => hashObjects([
+        item1.hashCode,
+        item2.hashCode,
+        item3.hashCode,
+        item4.hashCode,
+        item5.hashCode,
+        item6.hashCode,
+        item7.hashCode
+      ]);
+}