hifijson 0.5.0

High-fidelity JSON lexer and parser
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
85
86
87
88

/// Low-level input operations.
pub trait Read {
    /// Return `true` if the given byte sequence is a prefix of the input.
    ///
    /// This function may advance the input even if it returns `false`.
    fn strip_prefix(&mut self, s: &[u8]) -> bool {
        for c1 in s {
            match self.take_next() {
                Some(c2) if *c1 == c2 => continue,
                Some(_) | None => return false,
            }
        }
        true
    }

    /// Run a function on current input until a certain condition is fulfilled.
    fn foreach_until(&mut self, mut f: impl FnMut(u8), mut stop: impl FnMut(u8) -> bool) {
        self.skip_until(|c| {
            stop(c) || {
                f(c);
                false
            }
        })
    }

    /// Ignore input until `stop` yields true.
    fn skip_until(&mut self, mut stop: impl FnMut(u8) -> bool) {
        while let Some(c) = self.peek_next() {
            if stop(c) {
                return;
            } else {
                self.take_next();
            }
        }
    }

    /// Peek at the next byte.
    fn peek_next(&mut self) -> Option<u8>;

    /// Take the next byte.
    fn take_next(&mut self) -> Option<u8>;
}

impl<'a> Read for crate::SliceLexer<'a> {
    fn strip_prefix(&mut self, s: &[u8]) -> bool {
        if let Some(rest) = self.slice.strip_prefix(s) {
            self.slice = rest;
            true
        } else {
            false
        }
    }

    fn skip_until(&mut self, mut stop: impl FnMut(u8) -> bool) {
        while let Some((_, tl)) = self.slice.split_first().filter(|(hd, _)| !stop(**hd)) {
            self.slice = tl
        }
    }

    fn take_next(&mut self) -> Option<u8> {
        let (head, rest) = self.slice.split_first()?;
        self.slice = rest;
        Some(*head)
    }

    fn peek_next(&mut self) -> Option<u8> {
        self.slice.first().copied()
    }
}

impl<E, I: Iterator<Item = Result<u8, E>>> Read for crate::IterLexer<E, I> {
    fn take_next(&mut self) -> Option<u8> {
        self.last.take().or_else(|| match self.bytes.next()? {
            Ok(b) => Some(b),
            Err(e) => {
                self.error = Some(e);
                None
            }
        })
    }

    fn peek_next(&mut self) -> Option<u8> {
        self.last.or_else(|| {
            self.last = self.take_next();
            self.last
        })
    }
}