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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

use crate::{
    stdin, Mat, ReadFrom, ReadFromError, ReadInto, ReadOneFrom, ReadOneFromError, ReadOneInto,
};
pub use read_m_n as read_mat;
pub use read_n as read_vec;
pub use try_read_m_n as try_read_mat;
pub use try_read_n as try_read_vec;

// type StdinReader = InputStream<BufReader<Stdin>>;

macro_rules! expose_stdin {
    ($try_fn:ident $fn:ident $trait_into:ident [$ty_arg:ident] [$trait:ident] [$($trait_arg:tt)*] ($($arg:ident: $arg_ty:ty), *) -> $ret:ty | $err:ty) => {
        #[doc = concat!("Call [`", stringify!($trait_into), "::", stringify!($try_fn), "`] on [stdin].")]
        ///
        /// # Panics
        ///
        #[doc = concat!("If [`", stringify!($trait_into), "::", stringify!($try_fn), "`] panics.")]
        ///
        /// # Errors
        ///
        /// If this function is called in multiple threads, the behavior is undefined, possibly causing a deadlock.
        ///
        #[doc = concat!("If [`", stringify!($trait_into), "::", stringify!($try_fn), "`] returns an error.")]
        #[inline]
        pub fn $try_fn<$ty_arg>($($arg: $arg_ty),*) -> Result<$ret, $err>
        where
            $ty_arg: $trait,
        {
            stdin().$try_fn($($arg),*)
        }

        #[doc = concat!("Unwrap the result of [`", stringify!($try_fn), "`].")]
        #[track_caller]
        #[inline]
        pub fn $fn<$ty_arg>($($arg: $arg_ty),*) -> $ret
        where
            $ty_arg: $trait,
        {
            $crate::unwrap!($try_fn::<$ty_arg>($($arg),*))
        }
    };
}

expose_stdin!(
    try_read read ReadInto
    [T] [ReadFrom] [T] () -> T | ReadFromError<T>
);
expose_stdin!(
    try_read_n read_n ReadInto
    [T] [ReadFrom] [T] (n: usize) -> Vec<T> | ReadFromError<T>
);
expose_stdin!(
    try_read_m_n read_m_n ReadInto
    [T] [ReadFrom] [T] (m: usize, n: usize) -> Mat<T> | ReadFromError<T>
);

expose_stdin!(
    try_read_one read_one ReadOneInto
    [T] [ReadOneFrom] [T] () -> T | ReadOneFromError<T>
);
expose_stdin!(
    try_read_in_line_trimmed read_in_line_trimmed ReadOneInto
    [T] [ReadOneFrom] [T] () -> T | ReadOneFromError<T>
);
expose_stdin!(
    try_read_in_line_some_trimmed read_in_line_some_trimmed ReadOneInto
    [T] [ReadOneFrom] [T] () -> T | ReadOneFromError<T>
);
expose_stdin!(
    try_read_all read_all ReadOneInto
    [T] [ReadOneFrom] [T] () -> Vec<T> | ReadOneFromError<T>
);
expose_stdin!(
    try_read_any_in_line read_any_in_line ReadOneInto
    [T] [ReadOneFrom] [T] () -> Vec<T> | ReadOneFromError<T>
);
expose_stdin!(
    try_read_some_in_line read_some_in_line ReadOneInto
    [T] [ReadOneFrom] [T] () -> Vec<T> | ReadOneFromError<T>
);
expose_stdin!(
    try_read_in_char read_in_char ReadOneInto
    [T] [ReadOneFrom] [T] () -> T | ReadOneFromError<T>
);