24、ANTLR选项与命令行工具使用指南

ANTLR选项与命令行工具使用指南

1. ANTLR选项概述

ANTLR允许在语法和规则元素级别指定多种选项，这些选项会改变ANTLR从语法生成代码的方式。其通用语法如下：

options { name1=value1; ... nameN=valueN; } // ANTLR not target language syntax

其中，值可以是标识符、限定标识符（例如，a.b.c）、字符串、花括号括起来的多行字符串 {...} 以及整数。

1.1 语法选项

所有语法都可以使用以下选项。在组合语法中，除 language 外的所有选项仅适用于生成的解析器。选项可以在语法文件中使用 options 语法设置，也可以在命令行调用ANTLR时使用 -D 选项设置，且 -D 选项会覆盖语法文件中的选项。

1.1.1 superClass

设置生成的解析器或词法分析器的超类。对于组合语法，它设置解析器的超类。

$ cat Hi.g4
grammar Hi;
a : 'hi' ;
$ antlr4 -DsuperClass=XX Hi.g4
$ grep 'public class' HiParser.java
public class HiParser extends XX {
$ grep '