itermore 0.8.0

🤸‍♀️ More iterator adaptors
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

/// An extension trait that provides the [`collect_array`] method for iterators.
///
/// [`collect_array`]: IterCollectArray::collect_array
pub trait IterCollectArray: Iterator {
    /// Consumes the entire iterator collecting it into an array.
    ///
    /// # Panics
    ///
    /// If the iterator contains too little or too many elements to fit in the
    /// array. If you want to handle these cases, use [`next_chunk`] which
    /// supports returning the remainder and doesn't panic if there are too many
    /// elements.
    ///
    /// [`next_chunk`]: crate::IterNextChunk::next_chunk
    ///
    /// # Examples
    ///
    /// Basic usage:
    ///
    /// ```
    /// use itermore::IterCollectArray;
    ///
    /// let mut iter = "a,b,c".split(",");
    ///
    /// let arr: [_; 3] = iter.collect_array();
    /// assert_eq!(arr, ["a", "b", "c"]);
    /// ```
    #[inline]
    #[track_caller]
    fn collect_array<const N: usize>(mut self) -> [Self::Item; N]
    where
        Self: Sized,
    {
        match arrays::from_iter(self.by_ref()) {
            Ok(arr) => {
                if self.next().is_some() {
                    panic!("expected exactly {N} elements, but collected more");
                }
                arr
            }
            Err(arr) => {
                let got = arr.as_slice().len();
                panic!("expected exactly {N} elements, but collected {got}");
            }
        }
    }
}

impl<I: ?Sized> IterCollectArray for I where I: Iterator {}