Add Map constructors taking iterables.

sdk/lib/core/map.dart

 // Copyright (c) 2011, 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.
 
 part of dart.core;
 
 /**
  * A [Map] is an associative container, mapping a key to a value.
  * Null values are supported, but null keys are not.
  */
 abstract class Map<K, V> {
   /**
    * Creates a map with the default implementation.
    */
   factory Map() => new HashMap<K, V>();
 
   /**
    * Creates a [Map] that contains all key value pairs of [other].
    */
   factory Map.from(Map<K, V> other) => new HashMap<K, V>.from(other);
 
   /**
+   * Creates a [Map] associating the given [keys] to [values].
+   *
+   * This constructor iterates over [keys] and [values] and maps each element of
+   * [keys] to the corresponding element of [values].
+   *
+   * If [keys] contains the same object multiple times, the last occurrence
+   * overwrites the previous value.
+   *
+   * It is an error if the two [Iterable]s don't have the same length.
+   */
+  factory Map.fromIterables(Iterable<K> keys, Iterable<V> values)
+      = HashMap<K, V>.fromIterables;
+
+  /**
+   * Creates a [Map] where the keys and values are computed from the [iterable].
+   *
+   * For each element of the [iterable] this constructor computes a key/value pair,

[floitsch, 2013/06/27 13:07:17]

long lines.

[zarah, 2013/06/27 13:13:13]

Done.

+   * by applying [key] and [value] respectively.
+   *
+   * The keys of the key/value pairs do not need to be unique. The last occurrence of

[floitsch, 2013/06/27 13:07:17]

long line.

[zarah, 2013/06/27 13:13:13]

Done.

+   * a key will simply overwrite any previous value.
+   *
+   * If no values are specified for [key] and [value] the default is the
+   * identity function.
+   */
+  factory Map.fromIterable(Iterable iterable,
+      {K key(element), V value(element)}) = HashMap<K, V>.fromIterable;
+
+  /**
    * Returns whether this map contains the given [value].
    */
   bool containsValue(Object value);
 
   /**
    * Returns whether this map contains the given [key].
    */
   bool containsKey(Object key);
 
   /**
@@ skipping 68 matching lines @@
   /**
    * Returns true if there is no {key, value} pair in the map.
    */
   bool get isEmpty;
 
   /**
    * Returns true if there is at least one {key, value} pair in the map.
    */
   bool get isNotEmpty;
 }