pest/iterators/queueable_token.rs
1// pest. The Elegant Parser
2// Copyright (c) 2018 Dragoș Tiselice
3//
4// Licensed under the Apache License, Version 2.0
5// <LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0> or the MIT
6// license <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
7// option. All files in the project carrying such notice may not be copied,
8// modified, or distributed except according to those terms.
9
10// This structure serves to improve performance over Token objects in two ways:
11//
12// * it is smaller than a Token, leading to both less memory use when stored in the queue but also
13// increased speed when pushing to the queue
14// * it finds its pair in O(1) time instead of O(N), since pair positions are known at parse time
15// and can easily be stored instead of recomputed
16#[derive(Debug)]
17pub enum QueueableToken<'i, R> {
18 Start {
19 /// Queue (as a vec) contains both `Start` token and `End` for the same rule.
20 /// This field is an index of corresponding `End` token in vec.
21 end_token_index: usize,
22 /// Position from which rule was tried to parse (or successfully parsed).
23 input_pos: usize,
24 },
25 End {
26 /// Queue (as a vec) contains both `Start` token and `End` for the same rule.
27 /// This filed is an index of corresponding `Start` token in vec.
28 start_token_index: usize,
29 rule: R,
30 tag: Option<&'i str>,
31 /// Position at which successfully parsed rule finished (ended).
32 input_pos: usize,
33 },
34}