]> git.lizzy.rs Git - rust.git/blob - src/libcore/tests/iter.rs
Auto merge of #59619 - alexcrichton:wasi-fs, r=fitzgen
[rust.git] / src / libcore / tests / iter.rs
1 use core::cell::Cell;
2 use core::convert::TryFrom;
3 use core::iter::*;
4 use core::{i8, i16, isize};
5 use core::usize;
6
7 #[test]
8 fn test_lt() {
9     let empty: [isize; 0] = [];
10     let xs = [1,2,3];
11     let ys = [1,2,0];
12
13     assert!(!xs.iter().lt(ys.iter()));
14     assert!(!xs.iter().le(ys.iter()));
15     assert!( xs.iter().gt(ys.iter()));
16     assert!( xs.iter().ge(ys.iter()));
17
18     assert!( ys.iter().lt(xs.iter()));
19     assert!( ys.iter().le(xs.iter()));
20     assert!(!ys.iter().gt(xs.iter()));
21     assert!(!ys.iter().ge(xs.iter()));
22
23     assert!( empty.iter().lt(xs.iter()));
24     assert!( empty.iter().le(xs.iter()));
25     assert!(!empty.iter().gt(xs.iter()));
26     assert!(!empty.iter().ge(xs.iter()));
27
28     // Sequence with NaN
29     let u = [1.0f64, 2.0];
30     let v = [0.0f64/0.0, 3.0];
31
32     assert!(!u.iter().lt(v.iter()));
33     assert!(!u.iter().le(v.iter()));
34     assert!(!u.iter().gt(v.iter()));
35     assert!(!u.iter().ge(v.iter()));
36
37     let a = [0.0f64/0.0];
38     let b = [1.0f64];
39     let c = [2.0f64];
40
41     assert!(a.iter().lt(b.iter()) == (a[0] <  b[0]));
42     assert!(a.iter().le(b.iter()) == (a[0] <= b[0]));
43     assert!(a.iter().gt(b.iter()) == (a[0] >  b[0]));
44     assert!(a.iter().ge(b.iter()) == (a[0] >= b[0]));
45
46     assert!(c.iter().lt(b.iter()) == (c[0] <  b[0]));
47     assert!(c.iter().le(b.iter()) == (c[0] <= b[0]));
48     assert!(c.iter().gt(b.iter()) == (c[0] >  b[0]));
49     assert!(c.iter().ge(b.iter()) == (c[0] >= b[0]));
50 }
51
52 #[test]
53 fn test_multi_iter() {
54     let xs = [1,2,3,4];
55     let ys = [4,3,2,1];
56     assert!(xs.iter().eq(ys.iter().rev()));
57     assert!(xs.iter().lt(xs.iter().skip(2)));
58 }
59
60 #[test]
61 fn test_counter_from_iter() {
62     let it = (0..).step_by(5).take(10);
63     let xs: Vec<isize> = FromIterator::from_iter(it);
64     assert_eq!(xs, [0, 5, 10, 15, 20, 25, 30, 35, 40, 45]);
65 }
66
67 #[test]
68 fn test_iterator_chain() {
69     let xs = [0, 1, 2, 3, 4, 5];
70     let ys = [30, 40, 50, 60];
71     let expected = [0, 1, 2, 3, 4, 5, 30, 40, 50, 60];
72     let it = xs.iter().chain(&ys);
73     let mut i = 0;
74     for &x in it {
75         assert_eq!(x, expected[i]);
76         i += 1;
77     }
78     assert_eq!(i, expected.len());
79
80     let ys = (30..).step_by(10).take(4);
81     let it = xs.iter().cloned().chain(ys);
82     let mut i = 0;
83     for x in it {
84         assert_eq!(x, expected[i]);
85         i += 1;
86     }
87     assert_eq!(i, expected.len());
88 }
89
90 #[test]
91 fn test_iterator_chain_nth() {
92     let xs = [0, 1, 2, 3, 4, 5];
93     let ys = [30, 40, 50, 60];
94     let zs = [];
95     let expected = [0, 1, 2, 3, 4, 5, 30, 40, 50, 60];
96     for (i, x) in expected.iter().enumerate() {
97         assert_eq!(Some(x), xs.iter().chain(&ys).nth(i));
98     }
99     assert_eq!(zs.iter().chain(&xs).nth(0), Some(&0));
100
101     let mut it = xs.iter().chain(&zs);
102     assert_eq!(it.nth(5), Some(&5));
103     assert_eq!(it.next(), None);
104 }
105
106 #[test]
107 fn test_iterator_chain_last() {
108     let xs = [0, 1, 2, 3, 4, 5];
109     let ys = [30, 40, 50, 60];
110     let zs = [];
111     assert_eq!(xs.iter().chain(&ys).last(), Some(&60));
112     assert_eq!(zs.iter().chain(&ys).last(), Some(&60));
113     assert_eq!(ys.iter().chain(&zs).last(), Some(&60));
114     assert_eq!(zs.iter().chain(&zs).last(), None);
115 }
116
117 #[test]
118 fn test_iterator_chain_count() {
119     let xs = [0, 1, 2, 3, 4, 5];
120     let ys = [30, 40, 50, 60];
121     let zs = [];
122     assert_eq!(xs.iter().chain(&ys).count(), 10);
123     assert_eq!(zs.iter().chain(&ys).count(), 4);
124 }
125
126 #[test]
127 fn test_iterator_chain_find() {
128     let xs = [0, 1, 2, 3, 4, 5];
129     let ys = [30, 40, 50, 60];
130     let mut iter = xs.iter().chain(&ys);
131     assert_eq!(iter.find(|&&i| i == 4), Some(&4));
132     assert_eq!(iter.next(), Some(&5));
133     assert_eq!(iter.find(|&&i| i == 40), Some(&40));
134     assert_eq!(iter.next(), Some(&50));
135     assert_eq!(iter.find(|&&i| i == 100), None);
136     assert_eq!(iter.next(), None);
137 }
138
139 #[test]
140 fn test_zip_nth() {
141     let xs = [0, 1, 2, 4, 5];
142     let ys = [10, 11, 12];
143
144     let mut it = xs.iter().zip(&ys);
145     assert_eq!(it.nth(0), Some((&0, &10)));
146     assert_eq!(it.nth(1), Some((&2, &12)));
147     assert_eq!(it.nth(0), None);
148
149     let mut it = xs.iter().zip(&ys);
150     assert_eq!(it.nth(3), None);
151
152     let mut it = ys.iter().zip(&xs);
153     assert_eq!(it.nth(3), None);
154 }
155
156 #[test]
157 fn test_zip_nth_side_effects() {
158     let mut a = Vec::new();
159     let mut b = Vec::new();
160     let value = [1, 2, 3, 4, 5, 6].iter().cloned()
161         .map(|n| {
162             a.push(n);
163             n * 10
164         })
165         .zip([2, 3, 4, 5, 6, 7, 8].iter().cloned().map(|n| {
166             b.push(n * 100);
167             n * 1000
168         }))
169         .skip(1)
170         .nth(3);
171     assert_eq!(value, Some((50, 6000)));
172     assert_eq!(a, vec![1, 2, 3, 4, 5]);
173     assert_eq!(b, vec![200, 300, 400, 500, 600]);
174 }
175
176 #[test]
177 fn test_iterator_step_by() {
178     // Identity
179     let mut it = (0..).step_by(1).take(3);
180     assert_eq!(it.next(), Some(0));
181     assert_eq!(it.next(), Some(1));
182     assert_eq!(it.next(), Some(2));
183     assert_eq!(it.next(), None);
184
185     let mut it = (0..).step_by(3).take(4);
186     assert_eq!(it.next(), Some(0));
187     assert_eq!(it.next(), Some(3));
188     assert_eq!(it.next(), Some(6));
189     assert_eq!(it.next(), Some(9));
190     assert_eq!(it.next(), None);
191 }
192
193 #[test]
194 fn test_iterator_step_by_nth() {
195     let mut it = (0..16).step_by(5);
196     assert_eq!(it.nth(0), Some(0));
197     assert_eq!(it.nth(0), Some(5));
198     assert_eq!(it.nth(0), Some(10));
199     assert_eq!(it.nth(0), Some(15));
200     assert_eq!(it.nth(0), None);
201
202     let it = (0..18).step_by(5);
203     assert_eq!(it.clone().nth(0), Some(0));
204     assert_eq!(it.clone().nth(1), Some(5));
205     assert_eq!(it.clone().nth(2), Some(10));
206     assert_eq!(it.clone().nth(3), Some(15));
207     assert_eq!(it.clone().nth(4), None);
208     assert_eq!(it.clone().nth(42), None);
209 }
210
211 #[test]
212 fn test_iterator_step_by_nth_overflow() {
213     #[cfg(target_pointer_width = "8")]
214     type Bigger = u16;
215     #[cfg(target_pointer_width = "16")]
216     type Bigger = u32;
217     #[cfg(target_pointer_width = "32")]
218     type Bigger = u64;
219     #[cfg(target_pointer_width = "64")]
220     type Bigger = u128;
221
222     #[derive(Clone)]
223     struct Test(Bigger);
224     impl Iterator for &mut Test {
225         type Item = i32;
226         fn next(&mut self) -> Option<Self::Item> { Some(21) }
227         fn nth(&mut self, n: usize) -> Option<Self::Item> {
228             self.0 += n as Bigger + 1;
229             Some(42)
230         }
231     }
232
233     let mut it = Test(0);
234     let root = usize::MAX >> (::std::mem::size_of::<usize>() * 8 / 2);
235     let n = root + 20;
236     (&mut it).step_by(n).nth(n);
237     assert_eq!(it.0, n as Bigger * n as Bigger);
238
239     // large step
240     let mut it = Test(0);
241     (&mut it).step_by(usize::MAX).nth(5);
242     assert_eq!(it.0, (usize::MAX as Bigger) * 5);
243
244     // n + 1 overflows
245     let mut it = Test(0);
246     (&mut it).step_by(2).nth(usize::MAX);
247     assert_eq!(it.0, (usize::MAX as Bigger) * 2);
248
249     // n + 1 overflows
250     let mut it = Test(0);
251     (&mut it).step_by(1).nth(usize::MAX);
252     assert_eq!(it.0, (usize::MAX as Bigger) * 1);
253 }
254
255 #[test]
256 #[should_panic]
257 fn test_iterator_step_by_zero() {
258     let mut it = (0..).step_by(0);
259     it.next();
260 }
261
262 #[test]
263 fn test_iterator_step_by_size_hint() {
264     struct StubSizeHint(usize, Option<usize>);
265     impl Iterator for StubSizeHint {
266         type Item = ();
267         fn next(&mut self) -> Option<()> {
268             self.0 -= 1;
269             if let Some(ref mut upper) = self.1 {
270                 *upper -= 1;
271             }
272             Some(())
273         }
274         fn size_hint(&self) -> (usize, Option<usize>) {
275             (self.0, self.1)
276         }
277     }
278
279     // The two checks in each case are needed because the logic
280     // is different before the first call to `next()`.
281
282     let mut it = StubSizeHint(10, Some(10)).step_by(1);
283     assert_eq!(it.size_hint(), (10, Some(10)));
284     it.next();
285     assert_eq!(it.size_hint(), (9, Some(9)));
286
287     // exact multiple
288     let mut it = StubSizeHint(10, Some(10)).step_by(3);
289     assert_eq!(it.size_hint(), (4, Some(4)));
290     it.next();
291     assert_eq!(it.size_hint(), (3, Some(3)));
292
293     // larger base range, but not enough to get another element
294     let mut it = StubSizeHint(12, Some(12)).step_by(3);
295     assert_eq!(it.size_hint(), (4, Some(4)));
296     it.next();
297     assert_eq!(it.size_hint(), (3, Some(3)));
298
299     // smaller base range, so fewer resulting elements
300     let mut it = StubSizeHint(9, Some(9)).step_by(3);
301     assert_eq!(it.size_hint(), (3, Some(3)));
302     it.next();
303     assert_eq!(it.size_hint(), (2, Some(2)));
304
305     // infinite upper bound
306     let mut it = StubSizeHint(usize::MAX, None).step_by(1);
307     assert_eq!(it.size_hint(), (usize::MAX, None));
308     it.next();
309     assert_eq!(it.size_hint(), (usize::MAX-1, None));
310
311     // still infinite with larger step
312     let mut it = StubSizeHint(7, None).step_by(3);
313     assert_eq!(it.size_hint(), (3, None));
314     it.next();
315     assert_eq!(it.size_hint(), (2, None));
316
317     // propagates ExactSizeIterator
318     let a = [1,2,3,4,5];
319     let it = a.iter().step_by(2);
320     assert_eq!(it.len(), 3);
321
322     // Cannot be TrustedLen as a step greater than one makes an iterator
323     // with (usize::MAX, None) no longer meet the safety requirements
324     trait TrustedLenCheck { fn test(self) -> bool; }
325     impl<T:Iterator> TrustedLenCheck for T {
326         default fn test(self) -> bool { false }
327     }
328     impl<T:TrustedLen> TrustedLenCheck for T {
329         fn test(self) -> bool { true }
330     }
331     assert!(TrustedLenCheck::test(a.iter()));
332     assert!(!TrustedLenCheck::test(a.iter().step_by(1)));
333 }
334
335 #[test]
336 fn test_filter_map() {
337     let it = (0..).step_by(1).take(10)
338         .filter_map(|x| if x % 2 == 0 { Some(x*x) } else { None });
339     assert_eq!(it.collect::<Vec<usize>>(), [0*0, 2*2, 4*4, 6*6, 8*8]);
340 }
341
342 #[test]
343 fn test_filter_map_fold() {
344     let xs = [0, 1, 2, 3, 4, 5, 6, 7, 8];
345     let ys = [0*0, 2*2, 4*4, 6*6, 8*8];
346     let it = xs.iter().filter_map(|&x| if x % 2 == 0 { Some(x*x) } else { None });
347     let i = it.fold(0, |i, x| {
348         assert_eq!(x, ys[i]);
349         i + 1
350     });
351     assert_eq!(i, ys.len());
352
353     let it = xs.iter().filter_map(|&x| if x % 2 == 0 { Some(x*x) } else { None });
354     let i = it.rfold(ys.len(), |i, x| {
355         assert_eq!(x, ys[i - 1]);
356         i - 1
357     });
358     assert_eq!(i, 0);
359 }
360
361 #[test]
362 fn test_iterator_enumerate() {
363     let xs = [0, 1, 2, 3, 4, 5];
364     let it = xs.iter().enumerate();
365     for (i, &x) in it {
366         assert_eq!(i, x);
367     }
368 }
369
370 #[test]
371 fn test_iterator_enumerate_nth() {
372     let xs = [0, 1, 2, 3, 4, 5];
373     for (i, &x) in xs.iter().enumerate() {
374         assert_eq!(i, x);
375     }
376
377     let mut it = xs.iter().enumerate();
378     while let Some((i, &x)) = it.nth(0) {
379         assert_eq!(i, x);
380     }
381
382     let mut it = xs.iter().enumerate();
383     while let Some((i, &x)) = it.nth(1) {
384         assert_eq!(i, x);
385     }
386
387     let (i, &x) = xs.iter().enumerate().nth(3).unwrap();
388     assert_eq!(i, x);
389     assert_eq!(i, 3);
390 }
391
392 #[test]
393 fn test_iterator_enumerate_count() {
394     let xs = [0, 1, 2, 3, 4, 5];
395     assert_eq!(xs.iter().enumerate().count(), 6);
396 }
397
398 #[test]
399 fn test_iterator_enumerate_fold() {
400     let xs = [0, 1, 2, 3, 4, 5];
401     let mut it = xs.iter().enumerate();
402     // steal a couple to get an interesting offset
403     assert_eq!(it.next(), Some((0, &0)));
404     assert_eq!(it.next(), Some((1, &1)));
405     let i = it.fold(2, |i, (j, &x)| {
406         assert_eq!(i, j);
407         assert_eq!(x, xs[j]);
408         i + 1
409     });
410     assert_eq!(i, xs.len());
411
412     let mut it = xs.iter().enumerate();
413     assert_eq!(it.next(), Some((0, &0)));
414     let i = it.rfold(xs.len() - 1, |i, (j, &x)| {
415         assert_eq!(i, j);
416         assert_eq!(x, xs[j]);
417         i - 1
418     });
419     assert_eq!(i, 0);
420 }
421
422 #[test]
423 fn test_iterator_filter_count() {
424     let xs = [0, 1, 2, 3, 4, 5, 6, 7, 8];
425     assert_eq!(xs.iter().filter(|&&x| x % 2 == 0).count(), 5);
426 }
427
428 #[test]
429 fn test_iterator_filter_fold() {
430     let xs = [0, 1, 2, 3, 4, 5, 6, 7, 8];
431     let ys = [0, 2, 4, 6, 8];
432     let it = xs.iter().filter(|&&x| x % 2 == 0);
433     let i = it.fold(0, |i, &x| {
434         assert_eq!(x, ys[i]);
435         i + 1
436     });
437     assert_eq!(i, ys.len());
438
439     let it = xs.iter().filter(|&&x| x % 2 == 0);
440     let i = it.rfold(ys.len(), |i, &x| {
441         assert_eq!(x, ys[i - 1]);
442         i - 1
443     });
444     assert_eq!(i, 0);
445 }
446
447 #[test]
448 fn test_iterator_peekable() {
449     let xs = vec![0, 1, 2, 3, 4, 5];
450     let mut it = xs.iter().cloned().peekable();
451
452     assert_eq!(it.len(), 6);
453     assert_eq!(it.peek().unwrap(), &0);
454     assert_eq!(it.len(), 6);
455     assert_eq!(it.next().unwrap(), 0);
456     assert_eq!(it.len(), 5);
457     assert_eq!(it.next().unwrap(), 1);
458     assert_eq!(it.len(), 4);
459     assert_eq!(it.next().unwrap(), 2);
460     assert_eq!(it.len(), 3);
461     assert_eq!(it.peek().unwrap(), &3);
462     assert_eq!(it.len(), 3);
463     assert_eq!(it.peek().unwrap(), &3);
464     assert_eq!(it.len(), 3);
465     assert_eq!(it.next().unwrap(), 3);
466     assert_eq!(it.len(), 2);
467     assert_eq!(it.next().unwrap(), 4);
468     assert_eq!(it.len(), 1);
469     assert_eq!(it.peek().unwrap(), &5);
470     assert_eq!(it.len(), 1);
471     assert_eq!(it.next().unwrap(), 5);
472     assert_eq!(it.len(), 0);
473     assert!(it.peek().is_none());
474     assert_eq!(it.len(), 0);
475     assert!(it.next().is_none());
476     assert_eq!(it.len(), 0);
477 }
478
479 #[test]
480 fn test_iterator_peekable_count() {
481     let xs = [0, 1, 2, 3, 4, 5];
482     let ys = [10];
483     let zs: [i32; 0] = [];
484
485     assert_eq!(xs.iter().peekable().count(), 6);
486
487     let mut it = xs.iter().peekable();
488     assert_eq!(it.peek(), Some(&&0));
489     assert_eq!(it.count(), 6);
490
491     assert_eq!(ys.iter().peekable().count(), 1);
492
493     let mut it = ys.iter().peekable();
494     assert_eq!(it.peek(), Some(&&10));
495     assert_eq!(it.count(), 1);
496
497     assert_eq!(zs.iter().peekable().count(), 0);
498
499     let mut it = zs.iter().peekable();
500     assert_eq!(it.peek(), None);
501
502 }
503
504 #[test]
505 fn test_iterator_peekable_nth() {
506     let xs = [0, 1, 2, 3, 4, 5];
507     let mut it = xs.iter().peekable();
508
509     assert_eq!(it.peek(), Some(&&0));
510     assert_eq!(it.nth(0), Some(&0));
511     assert_eq!(it.peek(), Some(&&1));
512     assert_eq!(it.nth(1), Some(&2));
513     assert_eq!(it.peek(), Some(&&3));
514     assert_eq!(it.nth(2), Some(&5));
515     assert_eq!(it.next(), None);
516 }
517
518 #[test]
519 fn test_iterator_peekable_last() {
520     let xs = [0, 1, 2, 3, 4, 5];
521     let ys = [0];
522
523     let mut it = xs.iter().peekable();
524     assert_eq!(it.peek(), Some(&&0));
525     assert_eq!(it.last(), Some(&5));
526
527     let mut it = ys.iter().peekable();
528     assert_eq!(it.peek(), Some(&&0));
529     assert_eq!(it.last(), Some(&0));
530
531     let mut it = ys.iter().peekable();
532     assert_eq!(it.next(), Some(&0));
533     assert_eq!(it.peek(), None);
534     assert_eq!(it.last(), None);
535 }
536
537 #[test]
538 fn test_iterator_peekable_fold() {
539     let xs = [0, 1, 2, 3, 4, 5];
540     let mut it = xs.iter().peekable();
541     assert_eq!(it.peek(), Some(&&0));
542     let i = it.fold(0, |i, &x| {
543         assert_eq!(x, xs[i]);
544         i + 1
545     });
546     assert_eq!(i, xs.len());
547 }
548
549 /// This is an iterator that follows the Iterator contract,
550 /// but it is not fused. After having returned None once, it will start
551 /// producing elements if .next() is called again.
552 pub struct CycleIter<'a, T: 'a> {
553     index: usize,
554     data: &'a [T],
555 }
556
557 pub fn cycle<T>(data: &[T]) -> CycleIter<T> {
558     CycleIter {
559         index: 0,
560         data,
561     }
562 }
563
564 impl<'a, T> Iterator for CycleIter<'a, T> {
565     type Item = &'a T;
566     fn next(&mut self) -> Option<Self::Item> {
567         let elt = self.data.get(self.index);
568         self.index += 1;
569         self.index %= 1 + self.data.len();
570         elt
571     }
572 }
573
574 #[test]
575 fn test_iterator_peekable_remember_peek_none_1() {
576     // Check that the loop using .peek() terminates
577     let data = [1, 2, 3];
578     let mut iter = cycle(&data).peekable();
579
580     let mut n = 0;
581     while let Some(_) = iter.next() {
582         let is_the_last = iter.peek().is_none();
583         assert_eq!(is_the_last, n == data.len() - 1);
584         n += 1;
585         if n > data.len() { break; }
586     }
587     assert_eq!(n, data.len());
588 }
589
590 #[test]
591 fn test_iterator_peekable_remember_peek_none_2() {
592     let data = [0];
593     let mut iter = cycle(&data).peekable();
594     iter.next();
595     assert_eq!(iter.peek(), None);
596     assert_eq!(iter.last(), None);
597 }
598
599 #[test]
600 fn test_iterator_peekable_remember_peek_none_3() {
601     let data = [0];
602     let mut iter = cycle(&data).peekable();
603     iter.peek();
604     assert_eq!(iter.nth(0), Some(&0));
605
606     let mut iter = cycle(&data).peekable();
607     iter.next();
608     assert_eq!(iter.peek(), None);
609     assert_eq!(iter.nth(0), None);
610 }
611
612 #[test]
613 fn test_iterator_take_while() {
614     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19];
615     let ys = [0, 1, 2, 3, 5, 13];
616     let it = xs.iter().take_while(|&x| *x < 15);
617     let mut i = 0;
618     for x in it {
619         assert_eq!(*x, ys[i]);
620         i += 1;
621     }
622     assert_eq!(i, ys.len());
623 }
624
625 #[test]
626 fn test_iterator_skip_while() {
627     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19];
628     let ys = [15, 16, 17, 19];
629     let it = xs.iter().skip_while(|&x| *x < 15);
630     let mut i = 0;
631     for x in it {
632         assert_eq!(*x, ys[i]);
633         i += 1;
634     }
635     assert_eq!(i, ys.len());
636 }
637
638 #[test]
639 fn test_iterator_skip_while_fold() {
640     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19];
641     let ys = [15, 16, 17, 19];
642     let it = xs.iter().skip_while(|&x| *x < 15);
643     let i = it.fold(0, |i, &x| {
644         assert_eq!(x, ys[i]);
645         i + 1
646     });
647     assert_eq!(i, ys.len());
648
649     let mut it = xs.iter().skip_while(|&x| *x < 15);
650     assert_eq!(it.next(), Some(&ys[0])); // process skips before folding
651     let i = it.fold(1, |i, &x| {
652         assert_eq!(x, ys[i]);
653         i + 1
654     });
655     assert_eq!(i, ys.len());
656 }
657
658 #[test]
659 fn test_iterator_skip() {
660     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19, 20, 30];
661     let ys = [13, 15, 16, 17, 19, 20, 30];
662     let mut it = xs.iter().skip(5);
663     let mut i = 0;
664     while let Some(&x) = it.next() {
665         assert_eq!(x, ys[i]);
666         i += 1;
667         assert_eq!(it.len(), xs.len()-5-i);
668     }
669     assert_eq!(i, ys.len());
670     assert_eq!(it.len(), 0);
671 }
672
673 #[test]
674 fn test_iterator_skip_doubleended() {
675     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19, 20, 30];
676     let mut it = xs.iter().rev().skip(5);
677     assert_eq!(it.next(), Some(&15));
678     assert_eq!(it.by_ref().rev().next(), Some(&0));
679     assert_eq!(it.next(), Some(&13));
680     assert_eq!(it.by_ref().rev().next(), Some(&1));
681     assert_eq!(it.next(), Some(&5));
682     assert_eq!(it.by_ref().rev().next(), Some(&2));
683     assert_eq!(it.next(), Some(&3));
684     assert_eq!(it.next(), None);
685     let mut it = xs.iter().rev().skip(5).rev();
686     assert_eq!(it.next(), Some(&0));
687     assert_eq!(it.rev().next(), Some(&15));
688     let mut it_base = xs.iter();
689     {
690         let mut it = it_base.by_ref().skip(5).rev();
691         assert_eq!(it.next(), Some(&30));
692         assert_eq!(it.next(), Some(&20));
693         assert_eq!(it.next(), Some(&19));
694         assert_eq!(it.next(), Some(&17));
695         assert_eq!(it.next(), Some(&16));
696         assert_eq!(it.next(), Some(&15));
697         assert_eq!(it.next(), Some(&13));
698         assert_eq!(it.next(), None);
699     }
700     // make sure the skipped parts have not been consumed
701     assert_eq!(it_base.next(), Some(&0));
702     assert_eq!(it_base.next(), Some(&1));
703     assert_eq!(it_base.next(), Some(&2));
704     assert_eq!(it_base.next(), Some(&3));
705     assert_eq!(it_base.next(), Some(&5));
706     assert_eq!(it_base.next(), None);
707     let it = xs.iter().skip(5).rev();
708     assert_eq!(it.last(), Some(&13));
709 }
710
711 #[test]
712 fn test_iterator_skip_nth() {
713     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19, 20, 30];
714
715     let mut it = xs.iter().skip(0);
716     assert_eq!(it.nth(0), Some(&0));
717     assert_eq!(it.nth(1), Some(&2));
718
719     let mut it = xs.iter().skip(5);
720     assert_eq!(it.nth(0), Some(&13));
721     assert_eq!(it.nth(1), Some(&16));
722
723     let mut it = xs.iter().skip(12);
724     assert_eq!(it.nth(0), None);
725
726 }
727
728 #[test]
729 fn test_iterator_skip_count() {
730     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19, 20, 30];
731
732     assert_eq!(xs.iter().skip(0).count(), 12);
733     assert_eq!(xs.iter().skip(1).count(), 11);
734     assert_eq!(xs.iter().skip(11).count(), 1);
735     assert_eq!(xs.iter().skip(12).count(), 0);
736     assert_eq!(xs.iter().skip(13).count(), 0);
737 }
738
739 #[test]
740 fn test_iterator_skip_last() {
741     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19, 20, 30];
742
743     assert_eq!(xs.iter().skip(0).last(), Some(&30));
744     assert_eq!(xs.iter().skip(1).last(), Some(&30));
745     assert_eq!(xs.iter().skip(11).last(), Some(&30));
746     assert_eq!(xs.iter().skip(12).last(), None);
747     assert_eq!(xs.iter().skip(13).last(), None);
748
749     let mut it = xs.iter().skip(5);
750     assert_eq!(it.next(), Some(&13));
751     assert_eq!(it.last(), Some(&30));
752 }
753
754 #[test]
755 fn test_iterator_skip_fold() {
756     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19, 20, 30];
757     let ys = [13, 15, 16, 17, 19, 20, 30];
758
759     let it = xs.iter().skip(5);
760     let i = it.fold(0, |i, &x| {
761         assert_eq!(x, ys[i]);
762         i + 1
763     });
764     assert_eq!(i, ys.len());
765
766     let mut it = xs.iter().skip(5);
767     assert_eq!(it.next(), Some(&ys[0])); // process skips before folding
768     let i = it.fold(1, |i, &x| {
769         assert_eq!(x, ys[i]);
770         i + 1
771     });
772     assert_eq!(i, ys.len());
773
774     let it = xs.iter().skip(5);
775     let i = it.rfold(ys.len(), |i, &x| {
776         let i = i - 1;
777         assert_eq!(x, ys[i]);
778         i
779     });
780     assert_eq!(i, 0);
781
782     let mut it = xs.iter().skip(5);
783     assert_eq!(it.next(), Some(&ys[0])); // process skips before folding
784     let i = it.rfold(ys.len(), |i, &x| {
785         let i = i - 1;
786         assert_eq!(x, ys[i]);
787         i
788     });
789     assert_eq!(i, 1);
790
791 }
792
793 #[test]
794 fn test_iterator_take() {
795     let xs = [0, 1, 2, 3, 5, 13, 15, 16, 17, 19];
796     let ys = [0, 1, 2, 3, 5];
797     let mut it = xs.iter().take(5);
798     let mut i = 0;
799     assert_eq!(it.len(), 5);
800     while let Some(&x) = it.next() {
801         assert_eq!(x, ys[i]);
802         i += 1;
803         assert_eq!(it.len(), 5-i);
804     }
805     assert_eq!(i, ys.len());
806     assert_eq!(it.len(), 0);
807 }
808
809 #[test]
810 fn test_iterator_take_nth() {
811     let xs = [0, 1, 2, 4, 5];
812     let mut it = xs.iter();
813     {
814         let mut take = it.by_ref().take(3);
815         let mut i = 0;
816         while let Some(&x) = take.nth(0) {
817             assert_eq!(x, i);
818             i += 1;
819         }
820     }
821     assert_eq!(it.nth(1), Some(&5));
822     assert_eq!(it.nth(0), None);
823
824     let xs = [0, 1, 2, 3, 4];
825     let mut it = xs.iter().take(7);
826     let mut i = 1;
827     while let Some(&x) = it.nth(1) {
828         assert_eq!(x, i);
829         i += 2;
830     }
831 }
832
833 #[test]
834 fn test_iterator_take_short() {
835     let xs = [0, 1, 2, 3];
836     let ys = [0, 1, 2, 3];
837     let mut it = xs.iter().take(5);
838     let mut i = 0;
839     assert_eq!(it.len(), 4);
840     while let Some(&x) = it.next() {
841         assert_eq!(x, ys[i]);
842         i += 1;
843         assert_eq!(it.len(), 4-i);
844     }
845     assert_eq!(i, ys.len());
846     assert_eq!(it.len(), 0);
847 }
848
849 #[test]
850 fn test_iterator_scan() {
851     // test the type inference
852     fn add(old: &mut isize, new: &usize) -> Option<f64> {
853         *old += *new as isize;
854         Some(*old as f64)
855     }
856     let xs = [0, 1, 2, 3, 4];
857     let ys = [0f64, 1.0, 3.0, 6.0, 10.0];
858
859     let it = xs.iter().scan(0, add);
860     let mut i = 0;
861     for x in it {
862         assert_eq!(x, ys[i]);
863         i += 1;
864     }
865     assert_eq!(i, ys.len());
866 }
867
868 #[test]
869 fn test_iterator_flat_map() {
870     let xs = [0, 3, 6];
871     let ys = [0, 1, 2, 3, 4, 5, 6, 7, 8];
872     let it = xs.iter().flat_map(|&x| (x..).step_by(1).take(3));
873     let mut i = 0;
874     for x in it {
875         assert_eq!(x, ys[i]);
876         i += 1;
877     }
878     assert_eq!(i, ys.len());
879 }
880
881 /// Tests `FlatMap::fold` with items already picked off the front and back,
882 /// to make sure all parts of the `FlatMap` are folded correctly.
883 #[test]
884 fn test_iterator_flat_map_fold() {
885     let xs = [0, 3, 6];
886     let ys = [1, 2, 3, 4, 5, 6, 7];
887     let mut it = xs.iter().flat_map(|&x| x..x+3);
888     assert_eq!(it.next(), Some(0));
889     assert_eq!(it.next_back(), Some(8));
890     let i = it.fold(0, |i, x| {
891         assert_eq!(x, ys[i]);
892         i + 1
893     });
894     assert_eq!(i, ys.len());
895
896     let mut it = xs.iter().flat_map(|&x| x..x+3);
897     assert_eq!(it.next(), Some(0));
898     assert_eq!(it.next_back(), Some(8));
899     let i = it.rfold(ys.len(), |i, x| {
900         assert_eq!(x, ys[i - 1]);
901         i - 1
902     });
903     assert_eq!(i, 0);
904 }
905
906 #[test]
907 fn test_iterator_flatten() {
908     let xs = [0, 3, 6];
909     let ys = [0, 1, 2, 3, 4, 5, 6, 7, 8];
910     let it = xs.iter().map(|&x| (x..).step_by(1).take(3)).flatten();
911     let mut i = 0;
912     for x in it {
913         assert_eq!(x, ys[i]);
914         i += 1;
915     }
916     assert_eq!(i, ys.len());
917 }
918
919 /// Tests `Flatten::fold` with items already picked off the front and back,
920 /// to make sure all parts of the `Flatten` are folded correctly.
921 #[test]
922 fn test_iterator_flatten_fold() {
923     let xs = [0, 3, 6];
924     let ys = [1, 2, 3, 4, 5, 6, 7];
925     let mut it = xs.iter().map(|&x| x..x+3).flatten();
926     assert_eq!(it.next(), Some(0));
927     assert_eq!(it.next_back(), Some(8));
928     let i = it.fold(0, |i, x| {
929         assert_eq!(x, ys[i]);
930         i + 1
931     });
932     assert_eq!(i, ys.len());
933
934     let mut it = xs.iter().map(|&x| x..x+3).flatten();
935     assert_eq!(it.next(), Some(0));
936     assert_eq!(it.next_back(), Some(8));
937     let i = it.rfold(ys.len(), |i, x| {
938         assert_eq!(x, ys[i - 1]);
939         i - 1
940     });
941     assert_eq!(i, 0);
942 }
943
944 #[test]
945 fn test_inspect() {
946     let xs = [1, 2, 3, 4];
947     let mut n = 0;
948
949     let ys = xs.iter()
950                .cloned()
951                .inspect(|_| n += 1)
952                .collect::<Vec<usize>>();
953
954     assert_eq!(n, xs.len());
955     assert_eq!(&xs[..], &ys[..]);
956 }
957
958 #[test]
959 fn test_inspect_fold() {
960     let xs = [1, 2, 3, 4];
961     let mut n = 0;
962     {
963         let it = xs.iter().inspect(|_| n += 1);
964         let i = it.fold(0, |i, &x| {
965             assert_eq!(x, xs[i]);
966             i + 1
967         });
968         assert_eq!(i, xs.len());
969     }
970     assert_eq!(n, xs.len());
971
972     let mut n = 0;
973     {
974         let it = xs.iter().inspect(|_| n += 1);
975         let i = it.rfold(xs.len(), |i, &x| {
976             assert_eq!(x, xs[i - 1]);
977             i - 1
978         });
979         assert_eq!(i, 0);
980     }
981     assert_eq!(n, xs.len());
982 }
983
984 #[test]
985 fn test_cycle() {
986     let cycle_len = 3;
987     let it = (0..).step_by(1).take(cycle_len).cycle();
988     assert_eq!(it.size_hint(), (usize::MAX, None));
989     for (i, x) in it.take(100).enumerate() {
990         assert_eq!(i % cycle_len, x);
991     }
992
993     let mut it = (0..).step_by(1).take(0).cycle();
994     assert_eq!(it.size_hint(), (0, Some(0)));
995     assert_eq!(it.next(), None);
996
997     assert_eq!(empty::<i32>().cycle().fold(0, |acc, x| acc + x), 0);
998
999     assert_eq!(once(1).cycle().skip(1).take(4).fold(0, |acc, x| acc + x), 4);
1000 }
1001
1002 #[test]
1003 fn test_iterator_nth() {
1004     let v: &[_] = &[0, 1, 2, 3, 4];
1005     for i in 0..v.len() {
1006         assert_eq!(v.iter().nth(i).unwrap(), &v[i]);
1007     }
1008     assert_eq!(v.iter().nth(v.len()), None);
1009 }
1010
1011 #[test]
1012 fn test_iterator_nth_back() {
1013     let v: &[_] = &[0, 1, 2, 3, 4];
1014     for i in 0..v.len() {
1015         assert_eq!(v.iter().nth_back(i).unwrap(), &v[v.len() - 1 - i]);
1016     }
1017     assert_eq!(v.iter().nth_back(v.len()), None);
1018 }
1019
1020 #[test]
1021 fn test_iterator_rev_nth_back() {
1022     let v: &[_] = &[0, 1, 2, 3, 4];
1023     for i in 0..v.len() {
1024         assert_eq!(v.iter().rev().nth_back(i).unwrap(), &v[i]);
1025     }
1026     assert_eq!(v.iter().rev().nth_back(v.len()), None);
1027 }
1028
1029 #[test]
1030 fn test_iterator_rev_nth() {
1031     let v: &[_] = &[0, 1, 2, 3, 4];
1032     for i in 0..v.len() {
1033         assert_eq!(v.iter().rev().nth(i).unwrap(), &v[v.len() - 1 - i]);
1034     }
1035     assert_eq!(v.iter().rev().nth(v.len()), None);
1036 }
1037
1038 #[test]
1039 fn test_iterator_last() {
1040     let v: &[_] = &[0, 1, 2, 3, 4];
1041     assert_eq!(v.iter().last().unwrap(), &4);
1042     assert_eq!(v[..1].iter().last().unwrap(), &0);
1043 }
1044
1045 #[test]
1046 fn test_iterator_len() {
1047     let v: &[_] = &[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
1048     assert_eq!(v[..4].iter().count(), 4);
1049     assert_eq!(v[..10].iter().count(), 10);
1050     assert_eq!(v[..0].iter().count(), 0);
1051 }
1052
1053 #[test]
1054 fn test_iterator_sum() {
1055     let v: &[i32] = &[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
1056     assert_eq!(v[..4].iter().cloned().sum::<i32>(), 6);
1057     assert_eq!(v.iter().cloned().sum::<i32>(), 55);
1058     assert_eq!(v[..0].iter().cloned().sum::<i32>(), 0);
1059 }
1060
1061 #[test]
1062 fn test_iterator_sum_result() {
1063     let v: &[Result<i32, ()>] = &[Ok(1), Ok(2), Ok(3), Ok(4)];
1064     assert_eq!(v.iter().cloned().sum::<Result<i32, _>>(), Ok(10));
1065     let v: &[Result<i32, ()>] = &[Ok(1), Err(()), Ok(3), Ok(4)];
1066     assert_eq!(v.iter().cloned().sum::<Result<i32, _>>(), Err(()));
1067 }
1068
1069 #[test]
1070 fn test_iterator_product() {
1071     let v: &[i32] = &[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
1072     assert_eq!(v[..4].iter().cloned().product::<i32>(), 0);
1073     assert_eq!(v[1..5].iter().cloned().product::<i32>(), 24);
1074     assert_eq!(v[..0].iter().cloned().product::<i32>(), 1);
1075 }
1076
1077 #[test]
1078 fn test_iterator_product_result() {
1079     let v: &[Result<i32, ()>] = &[Ok(1), Ok(2), Ok(3), Ok(4)];
1080     assert_eq!(v.iter().cloned().product::<Result<i32, _>>(), Ok(24));
1081     let v: &[Result<i32, ()>] = &[Ok(1), Err(()), Ok(3), Ok(4)];
1082     assert_eq!(v.iter().cloned().product::<Result<i32, _>>(), Err(()));
1083 }
1084
1085 /// A wrapper struct that implements `Eq` and `Ord` based on the wrapped
1086 /// integer modulo 3. Used to test that `Iterator::max` and `Iterator::min`
1087 /// return the correct element if some of them are equal.
1088 #[derive(Debug)]
1089 struct Mod3(i32);
1090
1091 impl PartialEq for Mod3 {
1092     fn eq(&self, other: &Self) -> bool {
1093         self.0 % 3 == other.0 % 3
1094     }
1095 }
1096
1097 impl Eq for Mod3 {}
1098
1099 impl PartialOrd for Mod3 {
1100     fn partial_cmp(&self, other: &Self) -> Option<core::cmp::Ordering> {
1101         Some(self.cmp(other))
1102     }
1103 }
1104
1105 impl Ord for Mod3 {
1106     fn cmp(&self, other: &Self) -> core::cmp::Ordering {
1107         (self.0 % 3).cmp(&(other.0 % 3))
1108     }
1109 }
1110
1111 #[test]
1112 fn test_iterator_max() {
1113     let v: &[_] = &[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
1114     assert_eq!(v[..4].iter().cloned().max(), Some(3));
1115     assert_eq!(v.iter().cloned().max(), Some(10));
1116     assert_eq!(v[..0].iter().cloned().max(), None);
1117     assert_eq!(v.iter().cloned().map(Mod3).max().map(|x| x.0), Some(8));
1118 }
1119
1120 #[test]
1121 fn test_iterator_min() {
1122     let v: &[_] = &[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
1123     assert_eq!(v[..4].iter().cloned().min(), Some(0));
1124     assert_eq!(v.iter().cloned().min(), Some(0));
1125     assert_eq!(v[..0].iter().cloned().min(), None);
1126     assert_eq!(v.iter().cloned().map(Mod3).min().map(|x| x.0), Some(0));
1127 }
1128
1129 #[test]
1130 fn test_iterator_size_hint() {
1131     let c = (0..).step_by(1);
1132     let v: &[_] = &[0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
1133     let v2 = &[10, 11, 12];
1134     let vi = v.iter();
1135
1136     assert_eq!((0..).size_hint(), (usize::MAX, None));
1137     assert_eq!(c.size_hint(), (usize::MAX, None));
1138     assert_eq!(vi.clone().size_hint(), (10, Some(10)));
1139
1140     assert_eq!(c.clone().take(5).size_hint(), (5, Some(5)));
1141     assert_eq!(c.clone().skip(5).size_hint().1, None);
1142     assert_eq!(c.clone().take_while(|_| false).size_hint(), (0, None));
1143     assert_eq!(c.clone().skip_while(|_| false).size_hint(), (0, None));
1144     assert_eq!(c.clone().enumerate().size_hint(), (usize::MAX, None));
1145     assert_eq!(c.clone().chain(vi.clone().cloned()).size_hint(), (usize::MAX, None));
1146     assert_eq!(c.clone().zip(vi.clone()).size_hint(), (10, Some(10)));
1147     assert_eq!(c.clone().scan(0, |_,_| Some(0)).size_hint(), (0, None));
1148     assert_eq!(c.clone().filter(|_| false).size_hint(), (0, None));
1149     assert_eq!(c.clone().map(|_| 0).size_hint(), (usize::MAX, None));
1150     assert_eq!(c.filter_map(|_| Some(0)).size_hint(), (0, None));
1151
1152     assert_eq!(vi.clone().take(5).size_hint(), (5, Some(5)));
1153     assert_eq!(vi.clone().take(12).size_hint(), (10, Some(10)));
1154     assert_eq!(vi.clone().skip(3).size_hint(), (7, Some(7)));
1155     assert_eq!(vi.clone().skip(12).size_hint(), (0, Some(0)));
1156     assert_eq!(vi.clone().take_while(|_| false).size_hint(), (0, Some(10)));
1157     assert_eq!(vi.clone().skip_while(|_| false).size_hint(), (0, Some(10)));
1158     assert_eq!(vi.clone().enumerate().size_hint(), (10, Some(10)));
1159     assert_eq!(vi.clone().chain(v2).size_hint(), (13, Some(13)));
1160     assert_eq!(vi.clone().zip(v2).size_hint(), (3, Some(3)));
1161     assert_eq!(vi.clone().scan(0, |_,_| Some(0)).size_hint(), (0, Some(10)));
1162     assert_eq!(vi.clone().filter(|_| false).size_hint(), (0, Some(10)));
1163     assert_eq!(vi.clone().map(|&i| i+1).size_hint(), (10, Some(10)));
1164     assert_eq!(vi.filter_map(|_| Some(0)).size_hint(), (0, Some(10)));
1165 }
1166
1167 #[test]
1168 fn test_collect() {
1169     let a = vec![1, 2, 3, 4, 5];
1170     let b: Vec<isize> = a.iter().cloned().collect();
1171     assert!(a == b);
1172 }
1173
1174 #[test]
1175 fn test_all() {
1176     let v: Box<[isize]> = Box::new([1, 2, 3, 4, 5]);
1177     assert!(v.iter().all(|&x| x < 10));
1178     assert!(!v.iter().all(|&x| x % 2 == 0));
1179     assert!(!v.iter().all(|&x| x > 100));
1180     assert!(v[..0].iter().all(|_| panic!()));
1181 }
1182
1183 #[test]
1184 fn test_any() {
1185     let v: Box<[isize]> = Box::new([1, 2, 3, 4, 5]);
1186     assert!(v.iter().any(|&x| x < 10));
1187     assert!(v.iter().any(|&x| x % 2 == 0));
1188     assert!(!v.iter().any(|&x| x > 100));
1189     assert!(!v[..0].iter().any(|_| panic!()));
1190 }
1191
1192 #[test]
1193 fn test_find() {
1194     let v: &[isize] = &[1, 3, 9, 27, 103, 14, 11];
1195     assert_eq!(*v.iter().find(|&&x| x & 1 == 0).unwrap(), 14);
1196     assert_eq!(*v.iter().find(|&&x| x % 3 == 0).unwrap(), 3);
1197     assert!(v.iter().find(|&&x| x % 12 == 0).is_none());
1198 }
1199
1200 #[test]
1201 fn test_find_map() {
1202     let xs: &[isize] = &[];
1203     assert_eq!(xs.iter().find_map(half_if_even), None);
1204     let xs: &[isize] = &[3, 5];
1205     assert_eq!(xs.iter().find_map(half_if_even), None);
1206     let xs: &[isize] = &[4, 5];
1207     assert_eq!(xs.iter().find_map(half_if_even), Some(2));
1208     let xs: &[isize] = &[3, 6];
1209     assert_eq!(xs.iter().find_map(half_if_even), Some(3));
1210
1211     let xs: &[isize] = &[1, 2, 3, 4, 5, 6, 7];
1212     let mut iter = xs.iter();
1213     assert_eq!(iter.find_map(half_if_even), Some(1));
1214     assert_eq!(iter.find_map(half_if_even), Some(2));
1215     assert_eq!(iter.find_map(half_if_even), Some(3));
1216     assert_eq!(iter.next(), Some(&7));
1217
1218     fn half_if_even(x: &isize) -> Option<isize> {
1219         if x % 2 == 0 {
1220             Some(x / 2)
1221         } else {
1222             None
1223         }
1224     }
1225 }
1226
1227 #[test]
1228 fn test_position() {
1229     let v = &[1, 3, 9, 27, 103, 14, 11];
1230     assert_eq!(v.iter().position(|x| *x & 1 == 0).unwrap(), 5);
1231     assert_eq!(v.iter().position(|x| *x % 3 == 0).unwrap(), 1);
1232     assert!(v.iter().position(|x| *x % 12 == 0).is_none());
1233 }
1234
1235 #[test]
1236 fn test_count() {
1237     let xs = &[1, 2, 2, 1, 5, 9, 0, 2];
1238     assert_eq!(xs.iter().filter(|x| **x == 2).count(), 3);
1239     assert_eq!(xs.iter().filter(|x| **x == 5).count(), 1);
1240     assert_eq!(xs.iter().filter(|x| **x == 95).count(), 0);
1241 }
1242
1243 #[test]
1244 fn test_max_by_key() {
1245     let xs: &[isize] = &[-3, 0, 1, 5, -10];
1246     assert_eq!(*xs.iter().max_by_key(|x| x.abs()).unwrap(), -10);
1247 }
1248
1249 #[test]
1250 fn test_max_by() {
1251     let xs: &[isize] = &[-3, 0, 1, 5, -10];
1252     assert_eq!(*xs.iter().max_by(|x, y| x.abs().cmp(&y.abs())).unwrap(), -10);
1253 }
1254
1255 #[test]
1256 fn test_min_by_key() {
1257     let xs: &[isize] = &[-3, 0, 1, 5, -10];
1258     assert_eq!(*xs.iter().min_by_key(|x| x.abs()).unwrap(), 0);
1259 }
1260
1261 #[test]
1262 fn test_min_by() {
1263     let xs: &[isize] = &[-3, 0, 1, 5, -10];
1264     assert_eq!(*xs.iter().min_by(|x, y| x.abs().cmp(&y.abs())).unwrap(), 0);
1265 }
1266
1267 #[test]
1268 fn test_by_ref() {
1269     let mut xs = 0..10;
1270     // sum the first five values
1271     let partial_sum = xs.by_ref().take(5).fold(0, |a, b| a + b);
1272     assert_eq!(partial_sum, 10);
1273     assert_eq!(xs.next(), Some(5));
1274 }
1275
1276 #[test]
1277 fn test_rev() {
1278     let xs = [2, 4, 6, 8, 10, 12, 14, 16];
1279     let mut it = xs.iter();
1280     it.next();
1281     it.next();
1282     assert!(it.rev().cloned().collect::<Vec<isize>>() ==
1283             vec![16, 14, 12, 10, 8, 6]);
1284 }
1285
1286 #[test]
1287 fn test_copied() {
1288     let xs = [2, 4, 6, 8];
1289
1290     let mut it = xs.iter().copied();
1291     assert_eq!(it.len(), 4);
1292     assert_eq!(it.next(), Some(2));
1293     assert_eq!(it.len(), 3);
1294     assert_eq!(it.next(), Some(4));
1295     assert_eq!(it.len(), 2);
1296     assert_eq!(it.next_back(), Some(8));
1297     assert_eq!(it.len(), 1);
1298     assert_eq!(it.next_back(), Some(6));
1299     assert_eq!(it.len(), 0);
1300     assert_eq!(it.next_back(), None);
1301 }
1302
1303 #[test]
1304 fn test_cloned() {
1305     let xs = [2, 4, 6, 8];
1306
1307     let mut it = xs.iter().cloned();
1308     assert_eq!(it.len(), 4);
1309     assert_eq!(it.next(), Some(2));
1310     assert_eq!(it.len(), 3);
1311     assert_eq!(it.next(), Some(4));
1312     assert_eq!(it.len(), 2);
1313     assert_eq!(it.next_back(), Some(8));
1314     assert_eq!(it.len(), 1);
1315     assert_eq!(it.next_back(), Some(6));
1316     assert_eq!(it.len(), 0);
1317     assert_eq!(it.next_back(), None);
1318 }
1319
1320 #[test]
1321 fn test_cloned_side_effects() {
1322     let mut count = 0;
1323     {
1324         let iter = [1, 2, 3]
1325             .iter()
1326             .map(|x| {
1327                 count += 1;
1328                 x
1329             })
1330             .cloned()
1331             .zip(&[1]);
1332         for _ in iter {}
1333     }
1334     assert_eq!(count, 2);
1335 }
1336
1337 #[test]
1338 fn test_double_ended_map() {
1339     let xs = [1, 2, 3, 4, 5, 6];
1340     let mut it = xs.iter().map(|&x| x * -1);
1341     assert_eq!(it.next(), Some(-1));
1342     assert_eq!(it.next(), Some(-2));
1343     assert_eq!(it.next_back(), Some(-6));
1344     assert_eq!(it.next_back(), Some(-5));
1345     assert_eq!(it.next(), Some(-3));
1346     assert_eq!(it.next_back(), Some(-4));
1347     assert_eq!(it.next(), None);
1348 }
1349
1350 #[test]
1351 fn test_double_ended_enumerate() {
1352     let xs = [1, 2, 3, 4, 5, 6];
1353     let mut it = xs.iter().cloned().enumerate();
1354     assert_eq!(it.next(), Some((0, 1)));
1355     assert_eq!(it.next(), Some((1, 2)));
1356     assert_eq!(it.next_back(), Some((5, 6)));
1357     assert_eq!(it.next_back(), Some((4, 5)));
1358     assert_eq!(it.next_back(), Some((3, 4)));
1359     assert_eq!(it.next_back(), Some((2, 3)));
1360     assert_eq!(it.next(), None);
1361 }
1362
1363 #[test]
1364 fn test_double_ended_zip() {
1365     let xs = [1, 2, 3, 4, 5, 6];
1366     let ys = [1, 2, 3, 7];
1367     let a = xs.iter().cloned();
1368     let b = ys.iter().cloned();
1369     let mut it = a.zip(b);
1370     assert_eq!(it.next(), Some((1, 1)));
1371     assert_eq!(it.next(), Some((2, 2)));
1372     assert_eq!(it.next_back(), Some((4, 7)));
1373     assert_eq!(it.next_back(), Some((3, 3)));
1374     assert_eq!(it.next(), None);
1375 }
1376
1377 #[test]
1378 fn test_double_ended_filter() {
1379     let xs = [1, 2, 3, 4, 5, 6];
1380     let mut it = xs.iter().filter(|&x| *x & 1 == 0);
1381     assert_eq!(it.next_back().unwrap(), &6);
1382     assert_eq!(it.next_back().unwrap(), &4);
1383     assert_eq!(it.next().unwrap(), &2);
1384     assert_eq!(it.next_back(), None);
1385 }
1386
1387 #[test]
1388 fn test_double_ended_filter_map() {
1389     let xs = [1, 2, 3, 4, 5, 6];
1390     let mut it = xs.iter().filter_map(|&x| if x & 1 == 0 { Some(x * 2) } else { None });
1391     assert_eq!(it.next_back().unwrap(), 12);
1392     assert_eq!(it.next_back().unwrap(), 8);
1393     assert_eq!(it.next().unwrap(), 4);
1394     assert_eq!(it.next_back(), None);
1395 }
1396
1397 #[test]
1398 fn test_double_ended_chain() {
1399     let xs = [1, 2, 3, 4, 5];
1400     let ys = [7, 9, 11];
1401     let mut it = xs.iter().chain(&ys).rev();
1402     assert_eq!(it.next().unwrap(), &11);
1403     assert_eq!(it.next().unwrap(), &9);
1404     assert_eq!(it.next_back().unwrap(), &1);
1405     assert_eq!(it.next_back().unwrap(), &2);
1406     assert_eq!(it.next_back().unwrap(), &3);
1407     assert_eq!(it.next_back().unwrap(), &4);
1408     assert_eq!(it.next_back().unwrap(), &5);
1409     assert_eq!(it.next_back().unwrap(), &7);
1410     assert_eq!(it.next_back(), None);
1411
1412
1413     // test that .chain() is well behaved with an unfused iterator
1414     struct CrazyIterator(bool);
1415     impl CrazyIterator { fn new() -> CrazyIterator { CrazyIterator(false) } }
1416     impl Iterator for CrazyIterator {
1417         type Item = i32;
1418         fn next(&mut self) -> Option<i32> {
1419             if self.0 { Some(99) } else { self.0 = true; None }
1420         }
1421     }
1422
1423     impl DoubleEndedIterator for CrazyIterator {
1424         fn next_back(&mut self) -> Option<i32> {
1425             self.next()
1426         }
1427     }
1428
1429     assert_eq!(CrazyIterator::new().chain(0..10).rev().last(), Some(0));
1430     assert!((0..10).chain(CrazyIterator::new()).rev().any(|i| i == 0));
1431 }
1432
1433 #[test]
1434 fn test_rposition() {
1435     fn f(xy: &(isize, char)) -> bool { let (_x, y) = *xy; y == 'b' }
1436     fn g(xy: &(isize, char)) -> bool { let (_x, y) = *xy; y == 'd' }
1437     let v = [(0, 'a'), (1, 'b'), (2, 'c'), (3, 'b')];
1438
1439     assert_eq!(v.iter().rposition(f), Some(3));
1440     assert!(v.iter().rposition(g).is_none());
1441 }
1442
1443 #[test]
1444 #[should_panic]
1445 fn test_rposition_panic() {
1446     let v: [(Box<_>, Box<_>); 4] =
1447         [(box 0, box 0), (box 0, box 0),
1448          (box 0, box 0), (box 0, box 0)];
1449     let mut i = 0;
1450     v.iter().rposition(|_elt| {
1451         if i == 2 {
1452             panic!()
1453         }
1454         i += 1;
1455         false
1456     });
1457 }
1458
1459
1460 #[test]
1461 fn test_double_ended_flat_map() {
1462     let u = [0,1];
1463     let v = [5,6,7,8];
1464     let mut it = u.iter().flat_map(|x| &v[*x..v.len()]);
1465     assert_eq!(it.next_back().unwrap(), &8);
1466     assert_eq!(it.next().unwrap(),      &5);
1467     assert_eq!(it.next_back().unwrap(), &7);
1468     assert_eq!(it.next_back().unwrap(), &6);
1469     assert_eq!(it.next_back().unwrap(), &8);
1470     assert_eq!(it.next().unwrap(),      &6);
1471     assert_eq!(it.next_back().unwrap(), &7);
1472     assert_eq!(it.next_back(), None);
1473     assert_eq!(it.next(),      None);
1474     assert_eq!(it.next_back(), None);
1475 }
1476
1477 #[test]
1478 fn test_double_ended_flatten() {
1479     let u = [0,1];
1480     let v = [5,6,7,8];
1481     let mut it = u.iter().map(|x| &v[*x..v.len()]).flatten();
1482     assert_eq!(it.next_back().unwrap(), &8);
1483     assert_eq!(it.next().unwrap(),      &5);
1484     assert_eq!(it.next_back().unwrap(), &7);
1485     assert_eq!(it.next_back().unwrap(), &6);
1486     assert_eq!(it.next_back().unwrap(), &8);
1487     assert_eq!(it.next().unwrap(),      &6);
1488     assert_eq!(it.next_back().unwrap(), &7);
1489     assert_eq!(it.next_back(), None);
1490     assert_eq!(it.next(),      None);
1491     assert_eq!(it.next_back(), None);
1492 }
1493
1494 #[test]
1495 fn test_double_ended_range() {
1496     assert_eq!((11..14).rev().collect::<Vec<_>>(), [13, 12, 11]);
1497     for _ in (10..0).rev() {
1498         panic!("unreachable");
1499     }
1500
1501     assert_eq!((11..14).rev().collect::<Vec<_>>(), [13, 12, 11]);
1502     for _ in (10..0).rev() {
1503         panic!("unreachable");
1504     }
1505 }
1506
1507 #[test]
1508 fn test_range() {
1509     assert_eq!((0..5).collect::<Vec<_>>(), [0, 1, 2, 3, 4]);
1510     assert_eq!((-10..-1).collect::<Vec<_>>(), [-10, -9, -8, -7, -6, -5, -4, -3, -2]);
1511     assert_eq!((0..5).rev().collect::<Vec<_>>(), [4, 3, 2, 1, 0]);
1512     assert_eq!((200..-5).count(), 0);
1513     assert_eq!((200..-5).rev().count(), 0);
1514     assert_eq!((200..200).count(), 0);
1515     assert_eq!((200..200).rev().count(), 0);
1516
1517     assert_eq!((0..100).size_hint(), (100, Some(100)));
1518     // this test is only meaningful when sizeof usize < sizeof u64
1519     assert_eq!((usize::MAX - 1..usize::MAX).size_hint(), (1, Some(1)));
1520     assert_eq!((-10..-1).size_hint(), (9, Some(9)));
1521     assert_eq!((-1..-10).size_hint(), (0, Some(0)));
1522
1523     assert_eq!((-70..58).size_hint(), (128, Some(128)));
1524     assert_eq!((-128..127).size_hint(), (255, Some(255)));
1525     assert_eq!((-2..isize::MAX).size_hint(),
1526                (isize::MAX as usize + 2, Some(isize::MAX as usize + 2)));
1527 }
1528
1529 #[test]
1530 fn test_range_exhaustion() {
1531     let mut r = 10..10;
1532     assert!(r.is_empty());
1533     assert_eq!(r.next(), None);
1534     assert_eq!(r.next_back(), None);
1535     assert_eq!(r, 10..10);
1536
1537     let mut r = 10..12;
1538     assert_eq!(r.next(), Some(10));
1539     assert_eq!(r.next(), Some(11));
1540     assert!(r.is_empty());
1541     assert_eq!(r, 12..12);
1542     assert_eq!(r.next(), None);
1543
1544     let mut r = 10..12;
1545     assert_eq!(r.next_back(), Some(11));
1546     assert_eq!(r.next_back(), Some(10));
1547     assert!(r.is_empty());
1548     assert_eq!(r, 10..10);
1549     assert_eq!(r.next_back(), None);
1550
1551     let mut r = 100..10;
1552     assert!(r.is_empty());
1553     assert_eq!(r.next(), None);
1554     assert_eq!(r.next_back(), None);
1555     assert_eq!(r, 100..10);
1556 }
1557
1558 #[test]
1559 fn test_range_inclusive_exhaustion() {
1560     let mut r = 10..=10;
1561     assert_eq!(r.next(), Some(10));
1562     assert!(r.is_empty());
1563     assert_eq!(r.next(), None);
1564     assert_eq!(r.next(), None);
1565
1566     let mut r = 10..=10;
1567     assert_eq!(r.next_back(), Some(10));
1568     assert!(r.is_empty());
1569     assert_eq!(r.next_back(), None);
1570
1571     let mut r = 10..=12;
1572     assert_eq!(r.next(), Some(10));
1573     assert_eq!(r.next(), Some(11));
1574     assert_eq!(r.next(), Some(12));
1575     assert!(r.is_empty());
1576     assert_eq!(r.next(), None);
1577
1578     let mut r = 10..=12;
1579     assert_eq!(r.next_back(), Some(12));
1580     assert_eq!(r.next_back(), Some(11));
1581     assert_eq!(r.next_back(), Some(10));
1582     assert!(r.is_empty());
1583     assert_eq!(r.next_back(), None);
1584
1585     let mut r = 10..=12;
1586     assert_eq!(r.nth(2), Some(12));
1587     assert!(r.is_empty());
1588     assert_eq!(r.next(), None);
1589
1590     let mut r = 10..=12;
1591     assert_eq!(r.nth(5), None);
1592     assert!(r.is_empty());
1593     assert_eq!(r.next(), None);
1594
1595     let mut r = 100..=10;
1596     assert_eq!(r.next(), None);
1597     assert!(r.is_empty());
1598     assert_eq!(r.next(), None);
1599     assert_eq!(r.next(), None);
1600     assert_eq!(r, 100..=10);
1601
1602     let mut r = 100..=10;
1603     assert_eq!(r.next_back(), None);
1604     assert!(r.is_empty());
1605     assert_eq!(r.next_back(), None);
1606     assert_eq!(r.next_back(), None);
1607     assert_eq!(r, 100..=10);
1608 }
1609
1610 #[test]
1611 fn test_range_nth() {
1612     assert_eq!((10..15).nth(0), Some(10));
1613     assert_eq!((10..15).nth(1), Some(11));
1614     assert_eq!((10..15).nth(4), Some(14));
1615     assert_eq!((10..15).nth(5), None);
1616
1617     let mut r = 10..20;
1618     assert_eq!(r.nth(2), Some(12));
1619     assert_eq!(r, 13..20);
1620     assert_eq!(r.nth(2), Some(15));
1621     assert_eq!(r, 16..20);
1622     assert_eq!(r.nth(10), None);
1623     assert_eq!(r, 20..20);
1624 }
1625
1626 #[test]
1627 fn test_range_from_nth() {
1628     assert_eq!((10..).nth(0), Some(10));
1629     assert_eq!((10..).nth(1), Some(11));
1630     assert_eq!((10..).nth(4), Some(14));
1631
1632     let mut r = 10..;
1633     assert_eq!(r.nth(2), Some(12));
1634     assert_eq!(r, 13..);
1635     assert_eq!(r.nth(2), Some(15));
1636     assert_eq!(r, 16..);
1637     assert_eq!(r.nth(10), Some(26));
1638     assert_eq!(r, 27..);
1639
1640     assert_eq!((0..).size_hint(), (usize::MAX, None));
1641 }
1642
1643 fn is_trusted_len<I: TrustedLen>(_: I) {}
1644
1645 #[test]
1646 fn test_range_from_take() {
1647     let mut it = (0..).take(3);
1648     assert_eq!(it.next(), Some(0));
1649     assert_eq!(it.next(), Some(1));
1650     assert_eq!(it.next(), Some(2));
1651     assert_eq!(it.next(), None);
1652     is_trusted_len((0..).take(3));
1653     assert_eq!((0..).take(3).size_hint(), (3, Some(3)));
1654     assert_eq!((0..).take(0).size_hint(), (0, Some(0)));
1655     assert_eq!((0..).take(usize::MAX).size_hint(), (usize::MAX, Some(usize::MAX)));
1656 }
1657
1658 #[test]
1659 fn test_range_from_take_collect() {
1660     let v: Vec<_> = (0..).take(3).collect();
1661     assert_eq!(v, vec![0, 1, 2]);
1662 }
1663
1664 #[test]
1665 fn test_range_inclusive_nth() {
1666     assert_eq!((10..=15).nth(0), Some(10));
1667     assert_eq!((10..=15).nth(1), Some(11));
1668     assert_eq!((10..=15).nth(5), Some(15));
1669     assert_eq!((10..=15).nth(6), None);
1670
1671     let mut r = 10_u8..=20;
1672     assert_eq!(r.nth(2), Some(12));
1673     assert_eq!(r, 13..=20);
1674     assert_eq!(r.nth(2), Some(15));
1675     assert_eq!(r, 16..=20);
1676     assert_eq!(r.is_empty(), false);
1677     assert_eq!(ExactSizeIterator::is_empty(&r), false);
1678     assert_eq!(r.nth(10), None);
1679     assert_eq!(r.is_empty(), true);
1680     assert_eq!(ExactSizeIterator::is_empty(&r), true);
1681 }
1682
1683 #[test]
1684 fn test_range_step() {
1685     #![allow(deprecated)]
1686
1687     assert_eq!((0..20).step_by(5).collect::<Vec<isize>>(), [0, 5, 10, 15]);
1688     assert_eq!((1..21).rev().step_by(5).collect::<Vec<isize>>(), [20, 15, 10, 5]);
1689     assert_eq!((1..21).rev().step_by(6).collect::<Vec<isize>>(), [20, 14, 8, 2]);
1690     assert_eq!((200..255).step_by(50).collect::<Vec<u8>>(), [200, 250]);
1691     assert_eq!((200..-5).step_by(1).collect::<Vec<isize>>(), []);
1692     assert_eq!((200..200).step_by(1).collect::<Vec<isize>>(), []);
1693
1694     assert_eq!((0..20).step_by(1).size_hint(), (20, Some(20)));
1695     assert_eq!((0..20).step_by(21).size_hint(), (1, Some(1)));
1696     assert_eq!((0..20).step_by(5).size_hint(), (4, Some(4)));
1697     assert_eq!((1..21).rev().step_by(5).size_hint(), (4, Some(4)));
1698     assert_eq!((1..21).rev().step_by(6).size_hint(), (4, Some(4)));
1699     assert_eq!((20..-5).step_by(1).size_hint(), (0, Some(0)));
1700     assert_eq!((20..20).step_by(1).size_hint(), (0, Some(0)));
1701     assert_eq!((i8::MIN..i8::MAX).step_by(-(i8::MIN as i32) as usize).size_hint(), (2, Some(2)));
1702     assert_eq!((i16::MIN..i16::MAX).step_by(i16::MAX as usize).size_hint(), (3, Some(3)));
1703     assert_eq!((isize::MIN..isize::MAX).step_by(1).size_hint(), (usize::MAX, Some(usize::MAX)));
1704 }
1705
1706 #[test]
1707 fn test_step_by_skip() {
1708     assert_eq!((0..640).step_by(128).skip(1).collect::<Vec<_>>(), [128, 256, 384, 512]);
1709     assert_eq!((0..=50).step_by(10).nth(3), Some(30));
1710     assert_eq!((200..=255u8).step_by(10).nth(3), Some(230));
1711 }
1712
1713 #[test]
1714 fn test_range_inclusive_step() {
1715     assert_eq!((0..=50).step_by(10).collect::<Vec<_>>(), [0, 10, 20, 30, 40, 50]);
1716     assert_eq!((0..=5).step_by(1).collect::<Vec<_>>(), [0, 1, 2, 3, 4, 5]);
1717     assert_eq!((200..=255u8).step_by(10).collect::<Vec<_>>(), [200, 210, 220, 230, 240, 250]);
1718     assert_eq!((250..=255u8).step_by(1).collect::<Vec<_>>(), [250, 251, 252, 253, 254, 255]);
1719 }
1720
1721 #[test]
1722 fn test_range_last_max() {
1723     assert_eq!((0..20).last(), Some(19));
1724     assert_eq!((-20..0).last(), Some(-1));
1725     assert_eq!((5..5).last(), None);
1726
1727     assert_eq!((0..20).max(), Some(19));
1728     assert_eq!((-20..0).max(), Some(-1));
1729     assert_eq!((5..5).max(), None);
1730 }
1731
1732 #[test]
1733 fn test_range_inclusive_last_max() {
1734     assert_eq!((0..=20).last(), Some(20));
1735     assert_eq!((-20..=0).last(), Some(0));
1736     assert_eq!((5..=5).last(), Some(5));
1737     let mut r = 10..=10;
1738     r.next();
1739     assert_eq!(r.last(), None);
1740
1741     assert_eq!((0..=20).max(), Some(20));
1742     assert_eq!((-20..=0).max(), Some(0));
1743     assert_eq!((5..=5).max(), Some(5));
1744     let mut r = 10..=10;
1745     r.next();
1746     assert_eq!(r.max(), None);
1747 }
1748
1749 #[test]
1750 fn test_range_min() {
1751     assert_eq!((0..20).min(), Some(0));
1752     assert_eq!((-20..0).min(), Some(-20));
1753     assert_eq!((5..5).min(), None);
1754 }
1755
1756 #[test]
1757 fn test_range_inclusive_min() {
1758     assert_eq!((0..=20).min(), Some(0));
1759     assert_eq!((-20..=0).min(), Some(-20));
1760     assert_eq!((5..=5).min(), Some(5));
1761     let mut r = 10..=10;
1762     r.next();
1763     assert_eq!(r.min(), None);
1764 }
1765
1766 #[test]
1767 fn test_range_inclusive_folds() {
1768     assert_eq!((1..=10).sum::<i32>(), 55);
1769     assert_eq!((1..=10).rev().sum::<i32>(), 55);
1770
1771     let mut it = 44..=50;
1772     assert_eq!(it.try_fold(0, i8::checked_add), None);
1773     assert_eq!(it, 47..=50);
1774     assert_eq!(it.try_fold(0, i8::checked_add), None);
1775     assert_eq!(it, 50..=50);
1776     assert_eq!(it.try_fold(0, i8::checked_add), Some(50));
1777     assert!(it.is_empty());
1778     assert_eq!(it.try_fold(0, i8::checked_add), Some(0));
1779     assert!(it.is_empty());
1780
1781     let mut it = 40..=47;
1782     assert_eq!(it.try_rfold(0, i8::checked_add), None);
1783     assert_eq!(it, 40..=44);
1784     assert_eq!(it.try_rfold(0, i8::checked_add), None);
1785     assert_eq!(it, 40..=41);
1786     assert_eq!(it.try_rfold(0, i8::checked_add), Some(81));
1787     assert!(it.is_empty());
1788     assert_eq!(it.try_rfold(0, i8::checked_add), Some(0));
1789     assert!(it.is_empty());
1790
1791     let mut it = 10..=20;
1792     assert_eq!(it.try_fold(0, |a,b| Some(a+b)), Some(165));
1793     assert!(it.is_empty());
1794     assert_eq!(it.try_fold(0, |a,b| Some(a+b)), Some(0));
1795     assert!(it.is_empty());
1796
1797     let mut it = 10..=20;
1798     assert_eq!(it.try_rfold(0, |a,b| Some(a+b)), Some(165));
1799     assert!(it.is_empty());
1800     assert_eq!(it.try_rfold(0, |a,b| Some(a+b)), Some(0));
1801     assert!(it.is_empty());
1802 }
1803
1804 #[test]
1805 fn test_range_size_hint() {
1806     use core::usize::MAX as UMAX;
1807     assert_eq!((0..0usize).size_hint(), (0, Some(0)));
1808     assert_eq!((0..100usize).size_hint(), (100, Some(100)));
1809     assert_eq!((0..UMAX).size_hint(), (UMAX, Some(UMAX)));
1810
1811     let umax = u128::try_from(UMAX).unwrap();
1812     assert_eq!((0..0u128).size_hint(), (0, Some(0)));
1813     assert_eq!((0..100u128).size_hint(), (100, Some(100)));
1814     assert_eq!((0..umax).size_hint(), (UMAX, Some(UMAX)));
1815     assert_eq!((0..umax + 1).size_hint(), (UMAX, None));
1816
1817     use core::isize::{MAX as IMAX, MIN as IMIN};
1818     assert_eq!((0..0isize).size_hint(), (0, Some(0)));
1819     assert_eq!((-100..100isize).size_hint(), (200, Some(200)));
1820     assert_eq!((IMIN..IMAX).size_hint(), (UMAX, Some(UMAX)));
1821
1822     let imin = i128::try_from(IMIN).unwrap();
1823     let imax = i128::try_from(IMAX).unwrap();
1824     assert_eq!((0..0i128).size_hint(), (0, Some(0)));
1825     assert_eq!((-100..100i128).size_hint(), (200, Some(200)));
1826     assert_eq!((imin..imax).size_hint(), (UMAX, Some(UMAX)));
1827     assert_eq!((imin..imax + 1).size_hint(), (UMAX, None));
1828 }
1829
1830 #[test]
1831 fn test_range_inclusive_size_hint() {
1832     use core::usize::MAX as UMAX;
1833     assert_eq!((1..=0usize).size_hint(), (0, Some(0)));
1834     assert_eq!((0..=0usize).size_hint(), (1, Some(1)));
1835     assert_eq!((0..=100usize).size_hint(), (101, Some(101)));
1836     assert_eq!((0..=UMAX - 1).size_hint(), (UMAX, Some(UMAX)));
1837     assert_eq!((0..=UMAX).size_hint(), (UMAX, None));
1838
1839     let umax = u128::try_from(UMAX).unwrap();
1840     assert_eq!((1..=0u128).size_hint(), (0, Some(0)));
1841     assert_eq!((0..=0u128).size_hint(), (1, Some(1)));
1842     assert_eq!((0..=100u128).size_hint(), (101, Some(101)));
1843     assert_eq!((0..=umax - 1).size_hint(), (UMAX, Some(UMAX)));
1844     assert_eq!((0..=umax).size_hint(), (UMAX, None));
1845     assert_eq!((0..=umax + 1).size_hint(), (UMAX, None));
1846
1847     use core::isize::{MAX as IMAX, MIN as IMIN};
1848     assert_eq!((0..=-1isize).size_hint(), (0, Some(0)));
1849     assert_eq!((0..=0isize).size_hint(), (1, Some(1)));
1850     assert_eq!((-100..=100isize).size_hint(), (201, Some(201)));
1851     assert_eq!((IMIN..=IMAX - 1).size_hint(), (UMAX, Some(UMAX)));
1852     assert_eq!((IMIN..=IMAX).size_hint(), (UMAX, None));
1853
1854     let imin = i128::try_from(IMIN).unwrap();
1855     let imax = i128::try_from(IMAX).unwrap();
1856     assert_eq!((0..=-1i128).size_hint(), (0, Some(0)));
1857     assert_eq!((0..=0i128).size_hint(), (1, Some(1)));
1858     assert_eq!((-100..=100i128).size_hint(), (201, Some(201)));
1859     assert_eq!((imin..=imax - 1).size_hint(), (UMAX, Some(UMAX)));
1860     assert_eq!((imin..=imax).size_hint(), (UMAX, None));
1861     assert_eq!((imin..=imax + 1).size_hint(), (UMAX, None));
1862 }
1863
1864 #[test]
1865 fn test_repeat() {
1866     let mut it = repeat(42);
1867     assert_eq!(it.next(), Some(42));
1868     assert_eq!(it.next(), Some(42));
1869     assert_eq!(it.next(), Some(42));
1870     assert_eq!(repeat(42).size_hint(), (usize::MAX, None));
1871 }
1872
1873 #[test]
1874 fn test_repeat_take() {
1875     let mut it = repeat(42).take(3);
1876     assert_eq!(it.next(), Some(42));
1877     assert_eq!(it.next(), Some(42));
1878     assert_eq!(it.next(), Some(42));
1879     assert_eq!(it.next(), None);
1880     is_trusted_len(repeat(42).take(3));
1881     assert_eq!(repeat(42).take(3).size_hint(), (3, Some(3)));
1882     assert_eq!(repeat(42).take(0).size_hint(), (0, Some(0)));
1883     assert_eq!(repeat(42).take(usize::MAX).size_hint(), (usize::MAX, Some(usize::MAX)));
1884 }
1885
1886 #[test]
1887 fn test_repeat_take_collect() {
1888     let v: Vec<_> = repeat(42).take(3).collect();
1889     assert_eq!(v, vec![42, 42, 42]);
1890 }
1891
1892 #[test]
1893 fn test_repeat_with() {
1894     #[derive(PartialEq, Debug)]
1895     struct NotClone(usize);
1896     let mut it = repeat_with(|| NotClone(42));
1897     assert_eq!(it.next(), Some(NotClone(42)));
1898     assert_eq!(it.next(), Some(NotClone(42)));
1899     assert_eq!(it.next(), Some(NotClone(42)));
1900     assert_eq!(repeat_with(|| NotClone(42)).size_hint(), (usize::MAX, None));
1901 }
1902
1903 #[test]
1904 fn test_repeat_with_take() {
1905     let mut it = repeat_with(|| 42).take(3);
1906     assert_eq!(it.next(), Some(42));
1907     assert_eq!(it.next(), Some(42));
1908     assert_eq!(it.next(), Some(42));
1909     assert_eq!(it.next(), None);
1910     is_trusted_len(repeat_with(|| 42).take(3));
1911     assert_eq!(repeat_with(|| 42).take(3).size_hint(), (3, Some(3)));
1912     assert_eq!(repeat_with(|| 42).take(0).size_hint(), (0, Some(0)));
1913     assert_eq!(repeat_with(|| 42).take(usize::MAX).size_hint(),
1914                (usize::MAX, Some(usize::MAX)));
1915 }
1916
1917 #[test]
1918 fn test_repeat_with_take_collect() {
1919     let mut curr = 1;
1920     let v: Vec<_> = repeat_with(|| { let tmp = curr; curr *= 2; tmp })
1921                       .take(5).collect();
1922     assert_eq!(v, vec![1, 2, 4, 8, 16]);
1923 }
1924
1925 #[test]
1926 fn test_successors() {
1927     let mut powers_of_10 = successors(Some(1_u16), |n| n.checked_mul(10));
1928     assert_eq!(powers_of_10.by_ref().collect::<Vec<_>>(), &[1, 10, 100, 1_000, 10_000]);
1929     assert_eq!(powers_of_10.next(), None);
1930
1931     let mut empty = successors(None::<u32>, |_| unimplemented!());
1932     assert_eq!(empty.next(), None);
1933     assert_eq!(empty.next(), None);
1934 }
1935
1936 #[test]
1937 fn test_fuse() {
1938     let mut it = 0..3;
1939     assert_eq!(it.len(), 3);
1940     assert_eq!(it.next(), Some(0));
1941     assert_eq!(it.len(), 2);
1942     assert_eq!(it.next(), Some(1));
1943     assert_eq!(it.len(), 1);
1944     assert_eq!(it.next(), Some(2));
1945     assert_eq!(it.len(), 0);
1946     assert_eq!(it.next(), None);
1947     assert_eq!(it.len(), 0);
1948     assert_eq!(it.next(), None);
1949     assert_eq!(it.len(), 0);
1950     assert_eq!(it.next(), None);
1951     assert_eq!(it.len(), 0);
1952 }
1953
1954 #[test]
1955 fn test_fuse_nth() {
1956     let xs = [0, 1, 2];
1957     let mut it = xs.iter();
1958
1959     assert_eq!(it.len(), 3);
1960     assert_eq!(it.nth(2), Some(&2));
1961     assert_eq!(it.len(), 0);
1962     assert_eq!(it.nth(2), None);
1963     assert_eq!(it.len(), 0);
1964 }
1965
1966 #[test]
1967 fn test_fuse_last() {
1968     let xs = [0, 1, 2];
1969     let it = xs.iter();
1970
1971     assert_eq!(it.len(), 3);
1972     assert_eq!(it.last(), Some(&2));
1973 }
1974
1975 #[test]
1976 fn test_fuse_count() {
1977     let xs = [0, 1, 2];
1978     let it = xs.iter();
1979
1980     assert_eq!(it.len(), 3);
1981     assert_eq!(it.count(), 3);
1982     // Can't check len now because count consumes.
1983 }
1984
1985 #[test]
1986 fn test_fuse_fold() {
1987     let xs = [0, 1, 2];
1988     let it = xs.iter(); // `FusedIterator`
1989     let i = it.fuse().fold(0, |i, &x| {
1990         assert_eq!(x, xs[i]);
1991         i + 1
1992     });
1993     assert_eq!(i, xs.len());
1994
1995     let it = xs.iter(); // `FusedIterator`
1996     let i = it.fuse().rfold(xs.len(), |i, &x| {
1997         assert_eq!(x, xs[i - 1]);
1998         i - 1
1999     });
2000     assert_eq!(i, 0);
2001
2002     let it = xs.iter().scan((), |_, &x| Some(x)); // `!FusedIterator`
2003     let i = it.fuse().fold(0, |i, x| {
2004         assert_eq!(x, xs[i]);
2005         i + 1
2006     });
2007     assert_eq!(i, xs.len());
2008 }
2009
2010 #[test]
2011 fn test_once() {
2012     let mut it = once(42);
2013     assert_eq!(it.next(), Some(42));
2014     assert_eq!(it.next(), None);
2015 }
2016
2017 #[test]
2018 fn test_once_with() {
2019     let count = Cell::new(0);
2020     let mut it = once_with(|| {
2021         count.set(count.get() + 1);
2022         42
2023     });
2024
2025     assert_eq!(count.get(), 0);
2026     assert_eq!(it.next(), Some(42));
2027     assert_eq!(count.get(), 1);
2028     assert_eq!(it.next(), None);
2029     assert_eq!(count.get(), 1);
2030     assert_eq!(it.next(), None);
2031     assert_eq!(count.get(), 1);
2032 }
2033
2034 #[test]
2035 fn test_empty() {
2036     let mut it = empty::<i32>();
2037     assert_eq!(it.next(), None);
2038 }
2039
2040 #[test]
2041 fn test_chain_fold() {
2042     let xs = [1, 2, 3];
2043     let ys = [1, 2, 0];
2044
2045     let mut iter = xs.iter().chain(&ys);
2046     iter.next();
2047     let mut result = Vec::new();
2048     iter.fold((), |(), &elt| result.push(elt));
2049     assert_eq!(&[2, 3, 1, 2, 0], &result[..]);
2050 }
2051
2052 #[test]
2053 fn test_step_replace_unsigned() {
2054     let mut x = 4u32;
2055     let y = x.replace_zero();
2056     assert_eq!(x, 0);
2057     assert_eq!(y, 4);
2058
2059     x = 5;
2060     let y = x.replace_one();
2061     assert_eq!(x, 1);
2062     assert_eq!(y, 5);
2063 }
2064
2065 #[test]
2066 fn test_step_replace_signed() {
2067     let mut x = 4i32;
2068     let y = x.replace_zero();
2069     assert_eq!(x, 0);
2070     assert_eq!(y, 4);
2071
2072     x = 5;
2073     let y = x.replace_one();
2074     assert_eq!(x, 1);
2075     assert_eq!(y, 5);
2076 }
2077
2078 #[test]
2079 fn test_step_replace_no_between() {
2080     let mut x = 4u128;
2081     let y = x.replace_zero();
2082     assert_eq!(x, 0);
2083     assert_eq!(y, 4);
2084
2085     x = 5;
2086     let y = x.replace_one();
2087     assert_eq!(x, 1);
2088     assert_eq!(y, 5);
2089 }
2090
2091 #[test]
2092 fn test_rev_try_folds() {
2093     let f = &|acc, x| i32::checked_add(2*acc, x);
2094     assert_eq!((1..10).rev().try_fold(7, f), (1..10).try_rfold(7, f));
2095     assert_eq!((1..10).rev().try_rfold(7, f), (1..10).try_fold(7, f));
2096
2097     let a = [10, 20, 30, 40, 100, 60, 70, 80, 90];
2098     let mut iter = a.iter().rev();
2099     assert_eq!(iter.try_fold(0_i8, |acc, &x| acc.checked_add(x)), None);
2100     assert_eq!(iter.next(), Some(&70));
2101     let mut iter = a.iter().rev();
2102     assert_eq!(iter.try_rfold(0_i8, |acc, &x| acc.checked_add(x)), None);
2103     assert_eq!(iter.next_back(), Some(&60));
2104 }
2105
2106 #[test]
2107 fn test_cloned_try_folds() {
2108     let a = [1, 2, 3, 4, 5, 6, 7, 8, 9];
2109     let f = &|acc, x| i32::checked_add(2*acc, x);
2110     let f_ref = &|acc, &x| i32::checked_add(2*acc, x);
2111     assert_eq!(a.iter().cloned().try_fold(7, f), a.iter().try_fold(7, f_ref));
2112     assert_eq!(a.iter().cloned().try_rfold(7, f), a.iter().try_rfold(7, f_ref));
2113
2114     let a = [10, 20, 30, 40, 100, 60, 70, 80, 90];
2115     let mut iter = a.iter().cloned();
2116     assert_eq!(iter.try_fold(0_i8, |acc, x| acc.checked_add(x)), None);
2117     assert_eq!(iter.next(), Some(60));
2118     let mut iter = a.iter().cloned();
2119     assert_eq!(iter.try_rfold(0_i8, |acc, x| acc.checked_add(x)), None);
2120     assert_eq!(iter.next_back(), Some(70));
2121 }
2122
2123 #[test]
2124 fn test_chain_try_folds() {
2125     let c = || (0..10).chain(10..20);
2126
2127     let f = &|acc, x| i32::checked_add(2*acc, x);
2128     assert_eq!(c().try_fold(7, f), (0..20).try_fold(7, f));
2129     assert_eq!(c().try_rfold(7, f), (0..20).rev().try_fold(7, f));
2130
2131     let mut iter = c();
2132     assert_eq!(iter.position(|x| x == 5), Some(5));
2133     assert_eq!(iter.next(), Some(6), "stopped in front, state Both");
2134     assert_eq!(iter.position(|x| x == 13), Some(6));
2135     assert_eq!(iter.next(), Some(14), "stopped in back, state Back");
2136     assert_eq!(iter.try_fold(0, |acc, x| Some(acc+x)), Some((15..20).sum()));
2137
2138     let mut iter = c().rev(); // use rev to access try_rfold
2139     assert_eq!(iter.position(|x| x == 15), Some(4));
2140     assert_eq!(iter.next(), Some(14), "stopped in back, state Both");
2141     assert_eq!(iter.position(|x| x == 5), Some(8));
2142     assert_eq!(iter.next(), Some(4), "stopped in front, state Front");
2143     assert_eq!(iter.try_fold(0, |acc, x| Some(acc+x)), Some((0..4).sum()));
2144
2145     let mut iter = c();
2146     iter.by_ref().rev().nth(14); // skip the last 15, ending in state Front
2147     assert_eq!(iter.try_fold(7, f), (0..5).try_fold(7, f));
2148
2149     let mut iter = c();
2150     iter.nth(14); // skip the first 15, ending in state Back
2151     assert_eq!(iter.try_rfold(7, f), (15..20).try_rfold(7, f));
2152 }
2153
2154 #[test]
2155 fn test_map_try_folds() {
2156     let f = &|acc, x| i32::checked_add(2*acc, x);
2157     assert_eq!((0..10).map(|x| x+3).try_fold(7, f), (3..13).try_fold(7, f));
2158     assert_eq!((0..10).map(|x| x+3).try_rfold(7, f), (3..13).try_rfold(7, f));
2159
2160     let mut iter = (0..40).map(|x| x+10);
2161     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2162     assert_eq!(iter.next(), Some(20));
2163     assert_eq!(iter.try_rfold(0, i8::checked_add), None);
2164     assert_eq!(iter.next_back(), Some(46));
2165 }
2166
2167 #[test]
2168 fn test_filter_try_folds() {
2169     fn p(&x: &i32) -> bool { 0 <= x && x < 10 }
2170     let f = &|acc, x| i32::checked_add(2*acc, x);
2171     assert_eq!((-10..20).filter(p).try_fold(7, f), (0..10).try_fold(7, f));
2172     assert_eq!((-10..20).filter(p).try_rfold(7, f), (0..10).try_rfold(7, f));
2173
2174     let mut iter = (0..40).filter(|&x| x % 2 == 1);
2175     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2176     assert_eq!(iter.next(), Some(25));
2177     assert_eq!(iter.try_rfold(0, i8::checked_add), None);
2178     assert_eq!(iter.next_back(), Some(31));
2179 }
2180
2181 #[test]
2182 fn test_filter_map_try_folds() {
2183     let mp = &|x| if 0 <= x && x < 10 { Some(x*2) } else { None };
2184     let f = &|acc, x| i32::checked_add(2*acc, x);
2185     assert_eq!((-9..20).filter_map(mp).try_fold(7, f), (0..10).map(|x| 2*x).try_fold(7, f));
2186     assert_eq!((-9..20).filter_map(mp).try_rfold(7, f), (0..10).map(|x| 2*x).try_rfold(7, f));
2187
2188     let mut iter = (0..40).filter_map(|x| if x%2 == 1 { None } else { Some(x*2 + 10) });
2189     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2190     assert_eq!(iter.next(), Some(38));
2191     assert_eq!(iter.try_rfold(0, i8::checked_add), None);
2192     assert_eq!(iter.next_back(), Some(78));
2193 }
2194
2195 #[test]
2196 fn test_enumerate_try_folds() {
2197     let f = &|acc, (i, x)| usize::checked_add(2*acc, x/(i+1) + i);
2198     assert_eq!((9..18).enumerate().try_fold(7, f), (0..9).map(|i| (i, i+9)).try_fold(7, f));
2199     assert_eq!((9..18).enumerate().try_rfold(7, f), (0..9).map(|i| (i, i+9)).try_rfold(7, f));
2200
2201     let mut iter = (100..200).enumerate();
2202     let f = &|acc, (i, x)| u8::checked_add(acc, u8::checked_div(x, i as u8 + 1)?);
2203     assert_eq!(iter.try_fold(0, f), None);
2204     assert_eq!(iter.next(), Some((7, 107)));
2205     assert_eq!(iter.try_rfold(0, f), None);
2206     assert_eq!(iter.next_back(), Some((11, 111)));
2207 }
2208
2209 #[test]
2210 fn test_peek_try_fold() {
2211     let f = &|acc, x| i32::checked_add(2*acc, x);
2212     assert_eq!((1..20).peekable().try_fold(7, f), (1..20).try_fold(7, f));
2213     let mut iter = (1..20).peekable();
2214     assert_eq!(iter.peek(), Some(&1));
2215     assert_eq!(iter.try_fold(7, f), (1..20).try_fold(7, f));
2216
2217     let mut iter = [100, 20, 30, 40, 50, 60, 70].iter().cloned().peekable();
2218     assert_eq!(iter.peek(), Some(&100));
2219     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2220     assert_eq!(iter.peek(), Some(&40));
2221 }
2222
2223 #[test]
2224 fn test_skip_while_try_fold() {
2225     let f = &|acc, x| i32::checked_add(2*acc, x);
2226     fn p(&x: &i32) -> bool { (x % 10) <= 5 }
2227     assert_eq!((1..20).skip_while(p).try_fold(7, f), (6..20).try_fold(7, f));
2228     let mut iter = (1..20).skip_while(p);
2229     assert_eq!(iter.nth(5), Some(11));
2230     assert_eq!(iter.try_fold(7, f), (12..20).try_fold(7, f));
2231
2232     let mut iter = (0..50).skip_while(|&x| (x % 20) < 15);
2233     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2234     assert_eq!(iter.next(), Some(23));
2235 }
2236
2237 #[test]
2238 fn test_take_while_folds() {
2239     let f = &|acc, x| i32::checked_add(2*acc, x);
2240     assert_eq!((1..20).take_while(|&x| x != 10).try_fold(7, f), (1..10).try_fold(7, f));
2241     let mut iter = (1..20).take_while(|&x| x != 10);
2242     assert_eq!(iter.try_fold(0, |x, y| Some(x+y)), Some((1..10).sum()));
2243     assert_eq!(iter.next(), None, "flag should be set");
2244     let iter = (1..20).take_while(|&x| x != 10);
2245     assert_eq!(iter.fold(0, |x, y| x+y), (1..10).sum());
2246
2247     let mut iter = (10..50).take_while(|&x| x != 40);
2248     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2249     assert_eq!(iter.next(), Some(20));
2250 }
2251
2252 #[test]
2253 fn test_skip_try_folds() {
2254     let f = &|acc, x| i32::checked_add(2*acc, x);
2255     assert_eq!((1..20).skip(9).try_fold(7, f), (10..20).try_fold(7, f));
2256     assert_eq!((1..20).skip(9).try_rfold(7, f), (10..20).try_rfold(7, f));
2257
2258     let mut iter = (0..30).skip(10);
2259     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2260     assert_eq!(iter.next(), Some(20));
2261     assert_eq!(iter.try_rfold(0, i8::checked_add), None);
2262     assert_eq!(iter.next_back(), Some(24));
2263 }
2264
2265 #[test]
2266 fn test_take_try_folds() {
2267     let f = &|acc, x| i32::checked_add(2*acc, x);
2268     assert_eq!((10..30).take(10).try_fold(7, f), (10..20).try_fold(7, f));
2269     //assert_eq!((10..30).take(10).try_rfold(7, f), (10..20).try_rfold(7, f));
2270
2271     let mut iter = (10..30).take(20);
2272     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2273     assert_eq!(iter.next(), Some(20));
2274     //assert_eq!(iter.try_rfold(0, i8::checked_add), None);
2275     //assert_eq!(iter.next_back(), Some(24));
2276 }
2277
2278 #[test]
2279 fn test_flat_map_try_folds() {
2280     let f = &|acc, x| i32::checked_add(acc*2/3, x);
2281     let mr = &|x| (5*x)..(5*x + 5);
2282     assert_eq!((0..10).flat_map(mr).try_fold(7, f), (0..50).try_fold(7, f));
2283     assert_eq!((0..10).flat_map(mr).try_rfold(7, f), (0..50).try_rfold(7, f));
2284     let mut iter = (0..10).flat_map(mr);
2285     iter.next(); iter.next_back(); // have front and back iters in progress
2286     assert_eq!(iter.try_rfold(7, f), (1..49).try_rfold(7, f));
2287
2288     let mut iter = (0..10).flat_map(|x| (4*x)..(4*x + 4));
2289     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2290     assert_eq!(iter.next(), Some(17));
2291     assert_eq!(iter.try_rfold(0, i8::checked_add), None);
2292     assert_eq!(iter.next_back(), Some(35));
2293 }
2294
2295 #[test]
2296 fn test_flatten_try_folds() {
2297     let f = &|acc, x| i32::checked_add(acc*2/3, x);
2298     let mr = &|x| (5*x)..(5*x + 5);
2299     assert_eq!((0..10).map(mr).flatten().try_fold(7, f), (0..50).try_fold(7, f));
2300     assert_eq!((0..10).map(mr).flatten().try_rfold(7, f), (0..50).try_rfold(7, f));
2301     let mut iter = (0..10).map(mr).flatten();
2302     iter.next(); iter.next_back(); // have front and back iters in progress
2303     assert_eq!(iter.try_rfold(7, f), (1..49).try_rfold(7, f));
2304
2305     let mut iter = (0..10).map(|x| (4*x)..(4*x + 4)).flatten();
2306     assert_eq!(iter.try_fold(0, i8::checked_add), None);
2307     assert_eq!(iter.next(), Some(17));
2308     assert_eq!(iter.try_rfold(0, i8::checked_add), None);
2309     assert_eq!(iter.next_back(), Some(35));
2310 }
2311
2312 #[test]
2313 fn test_functor_laws() {
2314     // identity:
2315     fn identity<T>(x: T) -> T { x }
2316     assert_eq!((0..10).map(identity).sum::<usize>(), (0..10).sum());
2317
2318     // composition:
2319     fn f(x: usize) -> usize { x + 3 }
2320     fn g(x: usize) -> usize { x * 2 }
2321     fn h(x: usize) -> usize { g(f(x)) }
2322     assert_eq!((0..10).map(f).map(g).sum::<usize>(), (0..10).map(h).sum());
2323 }
2324
2325 #[test]
2326 fn test_monad_laws_left_identity() {
2327     fn f(x: usize) -> impl Iterator<Item = usize> {
2328         (0..10).map(move |y| x * y)
2329     }
2330     assert_eq!(once(42).flat_map(f.clone()).sum::<usize>(), f(42).sum());
2331 }
2332
2333 #[test]
2334 fn test_monad_laws_right_identity() {
2335     assert_eq!((0..10).flat_map(|x| once(x)).sum::<usize>(), (0..10).sum());
2336 }
2337
2338 #[test]
2339 fn test_monad_laws_associativity() {
2340     fn f(x: usize) -> impl Iterator<Item = usize> { 0..x }
2341     fn g(x: usize) -> impl Iterator<Item = usize> { (0..x).rev() }
2342     assert_eq!((0..10).flat_map(f).flat_map(g).sum::<usize>(),
2343                 (0..10).flat_map(|x| f(x).flat_map(g)).sum::<usize>());
2344 }
2345
2346 #[test]
2347 fn test_is_sorted() {
2348     assert!([1, 2, 2, 9].iter().is_sorted());
2349     assert!(![1, 3, 2].iter().is_sorted());
2350     assert!([0].iter().is_sorted());
2351     assert!(std::iter::empty::<i32>().is_sorted());
2352     assert!(![0.0, 1.0, std::f32::NAN].iter().is_sorted());
2353     assert!([-2, -1, 0, 3].iter().is_sorted());
2354     assert!(![-2i32, -1, 0, 3].iter().is_sorted_by_key(|n| n.abs()));
2355     assert!(!["c", "bb", "aaa"].iter().is_sorted());
2356     assert!(["c", "bb", "aaa"].iter().is_sorted_by_key(|s| s.len()));
2357 }