設定 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'.