设置 TestRig

ANTLR 在其运行时库中包含一个测试工具,该工具可用于显示详细信息,详细说明如何执行解析以匹配语法文件中已定义规则的输入。

要使用 ANTLR jar 文件中包含的此工具,你应该设置系统类路径以允许访问 ANTLR 工具和运行时库:

export CLASSPATH=".:/usr/local/lib/antlr-4.5.3-complete.jar:$CLASSPATH"

注意:确保 Dot 位于任何路径之前,以确保 java 虚拟机不会在当前工作目录中看到类。

Alises 可以在 Linux / MAC / Unix 上使用,以简化使用的命令:

alias antlr4='java -jar /usr/local/lib/antlr-4.5.3-complete.jar' 
//or any directory where your jar is located

注意在窗口上设置别名和类路径设置可能会更复杂,请参阅此处以获取更全面的详细信息。

访问 TestRig

设置别名后,可以按以下方式设置 TestRig,建议再次使用别名减少执行操作所需的时间:

alias grun='java org.antlr.v4.runtime.misc.TestRig'

如果你不希望在 Windows 上设置别名,可以通过在与 ANTLR jar 目录相同的位置运行以下命令来访问 TestRig:

java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.runtime.misc.TestRig
//or
java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.gui.TestRig

要在语法上运行 TestRig,你可以为你的语法传递参数,如下所示:

grun yourGrammar yourRule -tree //using the setup alias
java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.gui.TestRig yourGrammar YourRule -tree //on windows with no alias
java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.gui.TestRig yourGrammar Hello r -tree
//Windows with the grammar Hello.g4 starting from the rule 'r'.