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 "core.dart"; | 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 |