antlr v4 使用指南连载3——g4文件概览

时间：2024-09-22 14:37:32

g4文件概览#

在深入介绍之前，有必要先给大家了解一下g4文件的结构，以便对如何编写语法规则文件有个全局的认识，我想这是大有禆益的。因为这样我们就可以很清晰地知道需要的东西写在哪里，或者哪些东西是无法加到antlr中的。

grammar Name;

options {...}

import ...;

tokens {...}

@actionName {...}

<<rule1>>

...

<<rule2>>

这是一个完整的antlr语法规则文件，下面一一做出简要声明：

grammar Name 这是词法跟语法都在同一个文件声明的写法，称之为combined。若要分开，可以使用lexer grammar Name和parser grammar Name。
options 可以是如下四个选项。

superClass：用于生成xxxLexer.java、xxxParser.java的父类

language：目标语句，如java

tokenVocab：toekn词库

TokenLabelType：默认的是antlr的Token类型，这里可以使用自定义的token类，如MyToken。需要配合TokenFactory使用
import 可以导入各个独立的lexer、parser文件，只能用于combined写法。
actionName 可以是如下内容

@header：定义类文件头。比如嵌入java的package、import声明

@member：定义类文件内容。比如类成员、方法

如果要指定在lexer或者parser中，可以使用 @lexer::membere、@parser::member。

rule 语法规则。

lexer示例##

lexer grammar HelloLexer;

HI : 'H' 'i'

ID : [a-z]+;

WS : [\t\n\r\s]+ -> skip;

parser示例##

parser grammar HelloParser;

options {

	language=Java;

	tokenVocab=HelloLexer;

}

@header {

	package com.laudandjolynn.antlr;

	import java.util.Set;

	import java.util.HashSet;

}

@member {

	private int count;

	public int getCount() {

		return count;

	}

}

start : HI ID;

未完待续>>>

相关文章

antlr v4 使用指南连载3——g4文件概览

