jsonc-parser 0.17.0

JSONC 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

/// Positional information about a start and end point in the text.
#[derive(Debug, PartialEq, Clone)]
pub struct Range {
    /// Start position of the node in the text.
    pub start: usize,
    /// End position of the node in the text.
    pub end: usize,
    /// Line of the start position of the node in the text.
    pub start_line: usize,
    /// Line of the end position of the node in the text.
    pub end_line: usize,
}

impl Range {
    /// Gets the end position minus the start of the range.
    pub fn width(&self) -> usize {
        self.end - self.start
    }
}

/// Represents an object that has a range in the text.
pub trait Ranged {
    /// Gets the range.
    fn range(&self) -> &Range;

    /// Gets the index of the first character in the text.
    fn start(&self) -> usize {
        self.range().start
    }
    /// Gets the line number of the start position in the text.
    fn start_line(&self) -> usize {
        self.range().start_line
    }
    /// Gets the index after the last character in the text.
    fn end(&self) -> usize {
        self.range().end
    }
    /// Gets the line number of the end position in the text.
    fn end_line(&self) -> usize {
        self.range().end_line
    }
    /// Gets the text from the provided string.
    fn text<'a>(&self, text: &'a str) -> &'a str {
        &text[self.start()..self.end()]
    }
    /// Gets the start position.
    fn start_position(&self) -> Position {
        let range = self.range();
        Position::new(range.start, range.start_line)
    }
    /// Gets the end position.
    fn end_position(&self) -> Position {
        let range = self.range();
        Position::new(range.end, range.end_line)
    }
    /// Gets the end position minus the start of the range.
    fn width(&self) -> usize {
        self.range().width()
    }
}

/// Ranged value that specifies a specific position in the file.
pub struct Position {
    pub range: Range,
}

impl Position {
    /// Creates a new position at the specified position and line.
    pub fn new(pos: usize, line: usize) -> Position {
        Position {
            range: Range {
                start: pos,
                end: pos,
                start_line: line,
                end_line: line,
            },
        }
    }
}

impl Ranged for Position {
    fn range(&self) -> &Range {
        &self.range
    }
}