| 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 part of "dart:core"; | 5 part of dart.core; |
| 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. |
| 11 * A total ordering on a type means that for two values, either they | 11 * A total ordering on a type means that for two values, either they |
| 12 * are equal or one is greater than the other (and the latter must then be | 12 * are equal or one is greater than the other (and the latter must then be |
| 13 * smaller than the former). | 13 * smaller than the former). |
| 14 * | 14 * |
| 15 * A [Comparator] function represents such a total ordering by returning | 15 * A [Comparator] function represents such a total ordering by returning |
| (...skipping 69 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 85 /** | 85 /** |
| 86 * A [Comparator] that compares one comparable to another. | 86 * A [Comparator] that compares one comparable to another. |
| 87 * | 87 * |
| 88 * It returns the result of `a.compareTo(b)`. | 88 * It returns the result of `a.compareTo(b)`. |
| 89 * | 89 * |
| 90 * This utility function is used as the default comparator | 90 * This utility function is used as the default comparator |
| 91 * for ordering collections, for example in the [List] sort function. | 91 * for ordering collections, for example in the [List] sort function. |
| 92 */ | 92 */ |
| 93 static int compare(Comparable a, Comparable b) => a.compareTo(b); | 93 static int compare(Comparable a, Comparable b) => a.compareTo(b); |
| 94 } | 94 } |
| OLD | NEW |