Проводя комментарий с помощью antlr

Question

Я использую ANTLR для анализа языка пользовательских данных. Я использую C как язык, и я выводил абстрактное синтаксическое дерево. До сих пор так хорошо, но теперь мне нужно добавить документацию и мне нужно, чтобы блоки формы:

DOC 
Free text here 
ENDDOC 

Я попытался добавить правило:

docstm : 'DOC' ContentDoc=(.*) 'ENDDOC' -> ^(T_DOCCLASS $ContentDoc); 

где T_DOCCLASS представляет собой воображаемую лексема определена в раздел tokens {...}. К сожалению, хотя анализ синтаксического анализа блока DOC ... ENDDOC не прерывается, дерево имеет только T_DOCCLASS без какого-либо дочернего узла.

Другая дополнительная информация: Я использую ANTLR 3.2 и следующие прелюдия:

options { 
output = AST; 
language = C; 
ASTLabelType = pANTLR3_BASE_TREE; 
} 

и у меня есть еще одно правило для пропуска withespaces:

WS : (' ' 
    | '\t' 
    | '\r' 
    | '\n' 
    ) {$channel=HIDDEN;} 
; 

Заранее спасибо за любые предложения вы можете дать мне.

Answer 1

Вместо .* (! Нуля или более лексем, в правилах синтаксического анализа), это безопаснее сделать (~ENDDOC)* (кроме ENDDOC ноль или более лексем):

docstm  : DOC innerDocstm ENDDOC -> ^(T_DOCCLASS innerDocstm); 
innerDocstm : (~ENDDOC)*; 
DOC   : 'DOC'; 
ENDDOC  : 'ENDDOC'; 
ID   : ('a'..'z' | 'A'..'Z')+; 
WS   : (' ' | '\t' | '\r' | '\n') {$channel=HIDDEN;}; 

в результате чего:

Как вы можете видеть, в пределах T_DOCCLASS АСТ нет пробелов. Если вы хотите сохранить пробелы, нужно поместить правило в лексером:

DOCSTM : 'DOC' .* 'ENDDOC'; 

(вы должны использовать .* сейчас)