Skip to content

Commit cc3b2f9

Browse files
committed
Add more examples to lexicographic cmp on Iterators.
The most important rule of lexicographical comparison is that two arrays of equal length will be compared until the first difference occured. The examples provided only focuses on the second rule that says that the shorter array will be filled with some T2 that is less than every T. Which is only possible because of the first rule.
1 parent 2c3dc04 commit cc3b2f9

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

library/core/src/iter/traits/iterator.rs

+4
Original file line numberDiff line numberDiff line change
@@ -3077,6 +3077,7 @@ pub trait Iterator {
30773077
/// assert_eq!([1].iter().lt([1].iter()), false);
30783078
/// assert_eq!([1].iter().lt([1, 2].iter()), true);
30793079
/// assert_eq!([1, 2].iter().lt([1].iter()), false);
3080+
/// assert_eq!([1, 2].iter().lt([1, 2].iter()), false);
30803081
/// ```
30813082
#[stable(feature = "iter_order", since = "1.5.0")]
30823083
fn lt<I>(self, other: I) -> bool
@@ -3097,6 +3098,7 @@ pub trait Iterator {
30973098
/// assert_eq!([1].iter().le([1].iter()), true);
30983099
/// assert_eq!([1].iter().le([1, 2].iter()), true);
30993100
/// assert_eq!([1, 2].iter().le([1].iter()), false);
3101+
/// assert_eq!([1, 2].iter().le([1, 2].iter()), true);
31003102
/// ```
31013103
#[stable(feature = "iter_order", since = "1.5.0")]
31023104
fn le<I>(self, other: I) -> bool
@@ -3117,6 +3119,7 @@ pub trait Iterator {
31173119
/// assert_eq!([1].iter().gt([1].iter()), false);
31183120
/// assert_eq!([1].iter().gt([1, 2].iter()), false);
31193121
/// assert_eq!([1, 2].iter().gt([1].iter()), true);
3122+
/// assert_eq!([1, 2].iter().gt([1, 2].iter()), false);
31203123
/// ```
31213124
#[stable(feature = "iter_order", since = "1.5.0")]
31223125
fn gt<I>(self, other: I) -> bool
@@ -3137,6 +3140,7 @@ pub trait Iterator {
31373140
/// assert_eq!([1].iter().ge([1].iter()), true);
31383141
/// assert_eq!([1].iter().ge([1, 2].iter()), false);
31393142
/// assert_eq!([1, 2].iter().ge([1].iter()), true);
3143+
/// assert_eq!([1, 2].iter().ge([1, 2].iter()), true);
31403144
/// ```
31413145
#[stable(feature = "iter_order", since = "1.5.0")]
31423146
fn ge<I>(self, other: I) -> bool

0 commit comments

Comments
 (0)