This repository has been archived by the owner on Feb 26, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
TokenReader.java
65 lines (57 loc) · 2.25 KB
/
TokenReader.java
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
/*
* Copyright (C) 2024 Andre601
*
* Original Copyright and License (C) 2020 Florian Stober
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package ch.andre601.expressionparser.tokens.readers;
import ch.andre601.expressionparser.ParseWarnCollector;
import ch.andre601.expressionparser.tokens.Token;
import java.text.ParsePosition;
/**
* The token reader is used to find specific patterns within a provided text to then turn into a Token, "tokenizing" the
* text over time.
*/
public abstract class TokenReader{
private final int priority;
public TokenReader(int priority){
this.priority = priority;
}
/**
* Priority of the TokenReader instance.
*
* @return Priority of the TokenReader instance.
*/
public int getPriority(){
return priority;
}
/**
* Abstract method that is called by the ExpressionparserEngine to turn the provided String into a token.
* <br>The provided {@link ParsePosition ParsePosition instance} indicates the current position within the String
* and should be updated accordingly when parsing the String to a Token.
*
* <p>Assuming the DefaultExpressionParserEngine is used, returning {@code null} will result in skipping this TokenReader.
*
* @param text
* The text to parse.
* @param position
* The current position within the text.
* @param collector
* Instance of the {@link ParseWarnCollector} used for the parsing.
*
* @return Possibly-null {@link Token Token instance}.
*/
public abstract Token read(String text, ParsePosition position, ParseWarnCollector collector);
}