iof 0.5.0

Read from and write data to console or file in simple formats.
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

use super::{fmt::Default, read_from::ReadFromError};
use crate::{unwrap, BufReadExt, Mat, ReadFrom};

/// The opposite of [ReadFrom].
pub trait ReadInto<T>: BufReadExt {
    /// Errors that come from [ReadOneFrom].
    ///
    /// This is usually [ReadError].
    ///
    /// [ReadOneFrom]: crate::ReadOneFrom
    /// [ReadError]: crate::ReadError
    type Error: std::error::Error;

    /// Read from `self` and parse into `Self`.
    fn try_read(&mut self) -> Result<T, Self::Error>;

    /// Read `n` elements from `self`, parse into `Self` and aggregate them into a single [Vec].
    fn try_read_n(&mut self, n: usize) -> Result<Vec<T>, Self::Error>;

    /// Read `m * n` elements from `self`, parse into `Self` and aggregate them into a single [Mat].
    fn try_read_m_n(&mut self, m: usize, n: usize) -> Result<Mat<T>, Self::Error>;

    /// Unwrap the result of [ReadInto::try_read].
    #[inline]
    #[track_caller]
    fn read(&mut self) -> T {
        unwrap!(self.try_read())
    }

    /// Unwrap the result of [ReadInto::try_read_n].
    #[inline]
    #[track_caller]
    fn read_n(&mut self, n: usize) -> Vec<T> {
        unwrap!(self.try_read_n(n))
    }

    /// Unwrap the result of [ReadInto::try_read_m_n].
    #[inline]
    #[track_caller]
    fn read_m_n(&mut self, m: usize, n: usize) -> Mat<T> {
        unwrap!(self.try_read_m_n(m, n))
    }
}

impl<T: BufReadExt, U> ReadInto<U> for T
where
    U: ReadFrom,
{
    type Error = ReadFromError<U>;

    #[inline]
    fn try_read(&mut self) -> Result<U, Self::Error> {
        U::try_read_from(self, Default::new())
    }

    #[inline]
    fn try_read_n(&mut self, n: usize) -> Result<Vec<U>, Self::Error> {
        U::try_read_n_from(self, n, Default::new())
    }

    #[inline]
    fn try_read_m_n(&mut self, m: usize, n: usize) -> Result<Mat<U>, Self::Error> {
        U::try_read_m_n_from(self, m, n, Default::new())
    }
}