Rename XMatching to XWhere.

sdk/lib/core/iterable.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;
 
 /**
  * The [Iterable] interface allows to get an [Iterator] out of an
  * [Iterable] object.
  *
@@ skipping 305 matching lines @@
     return result;
   }
 
   /**
    * Returns the first element that satisfies the given predicate [f].
    *
    * If none matches, the result of invoking the [orElse] function is
    * returned. By default, when [orElse] is `null`, a [StateError] is
    * thrown.
    */
-  E firstMatching(bool test(E value), { E orElse() }) {
+  E firstWhere(bool test(E value), { E orElse() }) {
     // TODO(floitsch): check that arguments are of correct type?
     for (E element in this) {
       if (test(element)) return element;
     }
     if (orElse != null) return orElse();
     throw new StateError("No matching element");
   }
 
   /**
    * Returns the last element that satisfies the given predicate [f].
    *
    * If none matches, the result of invoking the [orElse] function is
    * returned. By default, when [orElse] is [:null:], a [StateError] is
    * thrown.
    */
-  E lastMatching(bool test(E value), {E orElse()}) {
+  E lastWhere(bool test(E value), {E orElse()}) {
     // TODO(floitsch): check that arguments are of correct type?
     E result = null;
     bool foundMatching = false;
     for (E element in this) {
       if (test(element)) {
         result = element;
         foundMatching = true;
       }
     }
     if (foundMatching) return result;
     if (orElse != null) return orElse();
     throw new StateError("No matching element");
   }
 
   /**
    * Returns the single element that satisfies [f]. If no or more than one
    * element match then a [StateError] is thrown.
    */
-  E singleMatching(bool test(E value)) {
+  E singleWhere(bool test(E value)) {
     // TODO(floitsch): check that argument is of correct type?
     E result = null;
     bool foundMatching = false;
     for (E element in this) {
       if (test(element)) {
         if (foundMatching) {
           throw new StateError("More than one matching element");
         }
         result = element;
         foundMatching = true;
@@ skipping 61 matching lines @@
  */
 abstract class BidirectionalIterator<T> extends Iterator<T> {
   /**
    * Move back to the previous element.
    *
    * Returns true and updates [current] if successful. Returns false
    * and sets [current] to null if there is no previous element.
    */
   bool movePrevious();
 }