blob: 7973271c62d474e19882290adffbf30a5b310f97 (
plain) (
blame)
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
|
/* Copyright (c) 2012-2017 The ANTLR Project. All rights reserved.
* Use of this file is governed by the BSD 3-clause license that
* can be found in the LICENSE.txt file in the project root.
*/
#pragma once
#include "atn/LexerAction.h"
#include "atn/LexerActionType.h"
namespace antlr4 {
namespace atn {
/// <summary>
/// Executes a custom lexer action by calling <seealso cref="Recognizer#action"/> with the
/// rule and action indexes assigned to the custom action. The implementation of
/// a custom action is added to the generated code for the lexer in an override
/// of <seealso cref="Recognizer#action"/> when the grammar is compiled.
///
/// <para>This class may represent embedded actions created with the <code>{...}</code>
/// syntax in ANTLR 4, as well as actions created for lexer commands where the
/// command argument could not be evaluated when the grammar was compiled.</para>
///
/// @author Sam Harwell
/// @since 4.2
/// </summary>
class ANTLR4CPP_PUBLIC LexerCustomAction final : public LexerAction {
public:
static bool is(const LexerAction &lexerAction) { return lexerAction.getActionType() == LexerActionType::CUSTOM; }
static bool is(const LexerAction *lexerAction) { return lexerAction != nullptr && is(*lexerAction); }
/// <summary>
/// Constructs a custom lexer action with the specified rule and action
/// indexes.
/// </summary>
/// <param name="ruleIndex"> The rule index to use for calls to
/// <seealso cref="Recognizer#action"/>. </param>
/// <param name="actionIndex"> The action index to use for calls to
/// <seealso cref="Recognizer#action"/>. </param>
LexerCustomAction(size_t ruleIndex, size_t actionIndex);
/// <summary>
/// Gets the rule index to use for calls to <seealso cref="Recognizer#action"/>.
/// </summary>
/// <returns> The rule index for the custom action. </returns>
size_t getRuleIndex() const { return _ruleIndex; }
/// <summary>
/// Gets the action index to use for calls to <seealso cref="Recognizer#action"/>.
/// </summary>
/// <returns> The action index for the custom action. </returns>
size_t getActionIndex() const { return _actionIndex; }
/// <summary>
/// {@inheritDoc}
///
/// <para>Custom actions are implemented by calling <seealso cref="Lexer#action"/> with the
/// appropriate rule and action indexes.</para>
/// </summary>
void execute(Lexer *lexer) const override;
bool equals(const LexerAction &other) const override;
std::string toString() const override;
protected:
size_t hashCodeImpl() const override;
private:
const size_t _ruleIndex;
const size_t _actionIndex;
};
} // namespace atn
} // namespace antlr4
|
