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