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

//! Separator and default separator.
use std::{
    fmt::{self, Formatter, Write as _},
    io::{self, Write},
};

/// Position.
///
/// The index of the last item that has been written.
pub type Position = usize;

/// Separator.
pub trait Separator {
    /// Write the separator to [fmt::Write].
    fn write_fmt(&self, f: &mut Formatter<'_>) -> fmt::Result;
    /// Write the separator to [io::Write].
    fn write_io(&self, s: &mut (impl Write + ?Sized)) -> io::Result<()>;
}

impl Separator for char {
    #[inline]
    fn write_fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        f.write_char(*self)
    }

    #[inline]
    fn write_io(&self, s: &mut (impl Write + ?Sized)) -> io::Result<()> {
        s.write_all(self.encode_utf8(&mut [0; 4]).as_bytes())
    }
}

impl Separator for str {
    #[inline]
    fn write_fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        f.write_str(self)
    }

    #[inline]
    fn write_io(&self, s: &mut (impl Write + ?Sized)) -> io::Result<()> {
        s.write_all(self.as_bytes())
    }
}

impl Separator for String {
    #[inline]
    fn write_fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        f.write_str(self)
    }

    #[inline]
    fn write_io(&self, s: &mut (impl Write + ?Sized)) -> io::Result<()> {
        s.write_all(self.as_bytes())
    }
}

impl<T: Separator + ?Sized> Separator for &T {
    #[inline]
    fn write_fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        <T as Separator>::write_fmt(*self, f)
    }

    #[inline]
    fn write_io(&self, s: &mut (impl Write + ?Sized)) -> io::Result<()> {
        <T as Separator>::write_io(*self, s)
    }
}