Added method map to Collection interface and all its implementations (except classes generated fr...

corelib/src/collection.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.
 
 /**
  * The [Collection] interface is the public interface of all
  * collections.
  */
 interface Collection<E> extends Iterable<E> {
   /**
    * Applies the function [f] to each element of this collection.
    */
   void forEach(void f(E element));
 
   /**
+   * Returns a new collection with the elements [: f(e) :]
+   * for each element [e] of this collection. 
+   *
+   * Note on typing: the return type of f() could be an arbitrary
+   * type R and consequently the returned collection's
+   * type would be Collection<R>.  

[ahe, 2012/01/05 22:36:54]

This comment is confusing. The static type may conceptually be Collection<R>,
but the runtime type will always be Collection.

[Ivan Posva, 2012/01/05 22:47:03]

I don't think this comment is entirely correct. The return type is probably
Collection<Dynamic>, no? I don't think there is a way to construct Collection<R>
based on the function alone.

+   */
+  Collection map(f(E element));
+
+  /**
    * Returns a new collection with the elements of this collection
    * that satisfy the predicate [f].
    *
    * An element satisfies the predicate [f] if [:f(element):]
    * returns true.
    */
   Collection<E> filter(bool f(E element));
 

[ahe, 2012/01/05 22:36:54]

Extra line.

+
   /**
    * Returns true if every elements of this collection satisify the
    * predicate [f]. Returns false otherwise.
    */
   bool every(bool f(E element));
 
   /**
    * Returns true if one element of this collection satisfies the
    * predicate [f]. Returns false otherwise.
    */
   bool some(bool f(E element));
 
   /**
    * Returns true if there is no element in this collection.
    */
   bool isEmpty();
 
   /**
    * Returns the number of elements in this collection.
    */
   int get length();
 }