| OLD | NEW |
| 1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 // Dart core library. | 5 // Dart core library. |
| 6 | 6 |
| 7 /** | 7 /** |
| 8 * The signature of a generic comparison function. | 8 * The signature of a generic comparison function. |
| 9 * | 9 * |
| 10 * A comparison function represents an ordering on a type of objects. | 10 * A comparison function represents an ordering on a type of objects. |
| (...skipping 13 matching lines...) Expand all Loading... |
| 24 */ | 24 */ |
| 25 abstract class Comparable { | 25 abstract class Comparable { |
| 26 /** | 26 /** |
| 27 * Compares this object to another [Comparable] | 27 * Compares this object to another [Comparable] |
| 28 * | 28 * |
| 29 * Returns a value like a [Comparator] when comparing [:this:] to [other]. | 29 * Returns a value like a [Comparator] when comparing [:this:] to [other]. |
| 30 * | 30 * |
| 31 * May throw an [ArgumentError] if [other] is of a type that | 31 * May throw an [ArgumentError] if [other] is of a type that |
| 32 * is not comparable to [:this:]. | 32 * is not comparable to [:this:]. |
| 33 */ | 33 */ |
| 34 abstract int compareTo(Comparable other); | 34 int compareTo(Comparable other); |
| 35 | 35 |
| 36 /** | 36 /** |
| 37 * Compare one comparable to another. | 37 * Compare one comparable to another. |
| 38 * | 38 * |
| 39 * This utility function is used as the default comparator | 39 * This utility function is used as the default comparator |
| 40 * for the [List] sort function. | 40 * for the [List] sort function. |
| 41 */ | 41 */ |
| 42 static int compare(Comparable a, Comparable b) => a.compareTo(b); | 42 static int compare(Comparable a, Comparable b) => a.compareTo(b); |
| 43 } | 43 } |
| OLD | NEW |