ANTLR在其运行时库中包含一个测试工具,该工具可用于显示详细说明如何执行解析以将输入与语法文件中定义的规则进行匹配的信息。
要使用ANTLR jar文件中包含的此工具,应将系统类路径设置为允许访问ANTLR工具和运行时库:
export CLASSPATH=".:/usr/local/lib/antlr-4.5.3-complete.jar:$CLASSPATH"
注意:确保Dot在任何路径之前,以确保Java虚拟机不会在当前工作目录中看到类。
别名可以在Linux / MAC / Unix上使用,以简化所使用的命令:
alias antlr4='java -jar /usr/local/lib/antlr-4.5.3-complete.jar' //或jar所在的任何目录
注意在Windows上为别名和类路径设置的设置可能会更复杂,请参见此处以获取更全面的详细信息。
设置别名后,可以通过以下方式设置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 //使用设置别名 java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.gui.TestRig yourGrammar YourRule -tree //在没有别名的Windows上 java -cp .;antlr.4.5.3-complete.jar org.antlr.v4.gui.TestRig yourGrammar Hello r -tree //语法为Hello.g4的Windows,从规则“ r”开始。