jsonc-parser 0.17.1

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 byte index of the node in the text.
  pub start: usize,
  /// End byte index 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 byte index minus the start byte index 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 byte 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 byte 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 byte position.
  fn start_position(&self) -> Position {
    let range = self.range();
    Position::new(range.start, range.start_line)
  }
  /// Gets the end byte position.
  fn end_position(&self) -> Position {
    let range = self.range();
    Position::new(range.end, range.end_line)
  }
  /// Gets the end byte index minus the start byte index 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
  }
}