2 /* This file is part of NIT ( http://www.nitlanguage.org ).
4 * Copyright 2008-2009 Jean Privat <jean@pryen.org>
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
19 /* This grammar defines the NIT language. */
20 Package org.nitlanguage.gen;
22 /*****************************************************************************/
24 /*****************************************************************************/
27 lowercase = ['a' .. 'z'];
28 uppercase = ['A' .. 'Z'];
31 hexdigit = ['0'..'9'] | ['a'..'f'] | ['A'..'F'] | '_';
32 bindigit = '0' | '1' | '_';
33 octdigit = ['0' .. '7'] | '_';
34 number = digit (digit | '_')*;
35 hex_number = ('0x' | '0X') hexdigit+;
36 bin_number = ('0b' | '0B') bindigit+;
37 oct_number = ('0o' | '0O') octdigit+;
38 prec = '8' | '16' | '32';
40 letter = lowercase | uppercase | digit | '_';
45 any = [all - [cr + lf]];
46 eol_helper = cr lf | cr | lf; // This takes care of different platforms
48 // characers inside strings and super-strings (atomaton powaa)
50 = [any - [['"' + '{'] + '\']]
60 sstr_body = sstr_char*;
62 long_str_char = str_char | cr | lf;
64 // because no substraction in sablecc3, complex long strings are difficult to express
67 ls12 = ls1? (ls2 ls1)* ls2?;
73 long_str_body = long_str_part*;
74 lsend1 = ls2? (ls1 ls2)* '"""' '"'*;
75 lsend2 = ls1? (ls2 ls1)* '{{{' '{'*;
77 long_sstr_char = sstr_char | cr | lf;
81 | ''' ''' long_sstr_char
84 long_sstr_body = long_sstr_part*;
92 extern_code_body = extern_code_char*;
94 /*****************************************************************************/
96 /*****************************************************************************/
100 /*****************************************************************************/
102 /*****************************************************************************/
104 blank = (' ' | tab)+;
107 comment = '#' any* eol_helper?;
109 kwpackage = 'package';
113 kwabstract = 'abstract';
114 kwinterface = 'interface';
115 kwenum = 'universal'|'enum';
126 kwprotected = 'protected';
127 kwprivate = 'private';
128 kwintrude = 'intrude';
139 kwimplies = 'implies';
141 kwcontinue = 'continue';
154 kwnullable = 'nullable';
158 kwdebug = '__debug__';
205 classid = uppercase letter*;
206 id = lowercase letter*;
207 attrid = '_' lowercase letter*;
209 integer = (number | hex_number | bin_number | oct_number) (('u' prec) | ('i' prec) |);
210 float = digit* '.' digit+ | (digit+ | digit* '.' digit+) ('E'|'e') ('+'|'-'|) digit+;
211 string = '"' str_body '"' | '"' '"' '"' long_str_body lsend1 | ''' ''' ''' long_sstr_body ''' ''' ''';
212 start_string = '"' str_body '{' | '"' '"' '"' long_str_body lsend2;
213 mid_string = '}' str_body '{' | '}' '}' '}' long_str_body lsend2;
214 end_string = '}' str_body '"' | '}' '}' '}' long_str_body lsend1;
215 char = (''' [[any - '''] - '\'] ''') | (''' '\' any ''');
216 bad_string = ('"'|'}') str_body | '"' '"' '"' long_str_body | ''' ''' ''' long_sstr_body;
217 bad_char = ''' '\'? any;
219 extern_code_segment = '`' '{' extern_code_body '`' '}';
221 /*****************************************************************************/
223 /*****************************************************************************/
227 /*****************************************************************************/
229 /*****************************************************************************/
231 /* MODULES *******************************************************************/
233 = moduledecl? [imports]:import* [extern_bodies]:extern_code_body* [classdefs]:topdef* implicit_main_class {-> New module(moduledecl, [imports.import], [extern_bodies.extern_code_block], [classdefs.classdef,implicit_main_class.classdef])};
236 = [doc]:nd redef visibility kwmodule no module_name annotation_withend [n2]:n1 {-> New moduledecl(doc.doc, redef.kwredef, visibility, kwmodule, module_name, annotation_withend.annotations)};
239 = {std} [doc]:nd redef visibility kwimport no module_name annotation_withend [n2]:n1 {-> New import.std(visibility, kwimport, module_name, annotation_withend.annotations)}
240 | {no} [doc]:nd redef visibility kwimport no kwend [n2]:n1 {-> New import.no(visibility, kwimport, kwend)}
244 = {classdef} classdef {-> classdef}
245 | propdef_toplevel n1 {-> New classdef.top([propdef_toplevel.propdef])}
248 implicit_main_class {-> classdef?}
249 = implicit_main_meth {-> New classdef.main([implicit_main_meth.propdef])}
250 | {null} n? {-> Null}
252 implicit_main_meth {-> propdef}
253 = [doc]:nd stmts {-> New propdef.main_meth(Null, stmts.expr)}
254 | {n} [doc]:nd stmtsn {-> New propdef.main_meth(Null, stmtsn.expr)}
257 /* CLASSES *******************************************************************/
259 = [doc]:nd redef visibility classkind no qclassid extern_code_block? propdefs kwend {-> New classdef.std(doc.doc, redef.kwredef, visibility, classkind, qclassid.classid, Null, [], Null, extern_code_block, [propdefs.propdef], kwend)}
260 | {for} [doc]:nd redef visibility classkind no qclassid obra [n2]:no formaldefs cbra extern_code_block? propdefs kwend {-> New classdef.std(doc.doc, redef.kwredef, visibility, classkind, qclassid.classid, obra, [formaldefs.formaldef], cbra, extern_code_block, [propdefs.propdef], kwend)}
264 = kwredef? {-> kwredef};
267 | {abstract} kwabstract kwclass
268 | {interface} kwinterface
270 | {extern} kwextern kwclass
273 formaldefs {-> formaldef*}
274 = formaldef formaldefs_tail* {-> [formaldef, formaldefs_tail.formaldef]}
277 formaldefs_tail {-> formaldef}
278 = comma no formaldef {-> formaldef};
280 = classid annotations? typing_o no {-> New formaldef(classid, typing_o.type, annotations)};
282 superclass {-> propdef}
283 = {super} [doc]:nd redef visibility kwsuper [n2]:no type annotation_withend {-> New propdef.super(doc.doc, redef.kwredef, visibility, kwsuper, type, annotation_withend.annotations)}
286 propdefs {-> propdef*}
287 = propdefn+ no {-> [propdefn.propdef]}
288 | {super} superclass {-> [superclass.propdef]}
291 propdefn {-> propdef}
292 = propdef n1 {-> propdef.propdef}
294 propdef~toplevel {-> propdef}
295 = {meth} [doc]:nd redef visibility kwmeth qmethid signature annotation_noend? kwdo stmtso kwend_o {-> New propdef.meth(doc.doc, redef.kwredef, visibility, kwmeth, Null, Null, qmethid.methid, signature, annotation_noend.annotations, Null, Null, kwdo, stmtso.expr, kwend_o.kwend)}
296 | {nobody} [doc]:nd redef visibility kwmeth qmethid signature annotation_withend_nonull {-> New propdef.meth(doc.doc, redef.kwredef, visibility, kwmeth, Null, Null, qmethid.methid, signature.signature, annotation_withend_nonull.annotations, Null, Null, Null, Null, Null)}
297 !toplevel| {intern_new} [doc]:nd redef visibility kwnew qmethid? signature annotation_withend_nonull {-> New propdef.meth(doc.doc, redef.kwredef, visibility, Null, Null, kwnew, qmethid.methid, signature, annotation_withend_nonull.annotations, Null, Null, Null, Null, Null)}
298 !toplevel| {new} [doc]:nd redef visibility kwnew qmethid? signature annotation_noend? kwdo stmtso kwend_o {-> New propdef.meth(doc.doc, redef.kwredef, visibility, Null, Null, kwnew, qmethid.methid, signature, annotation_noend.annotations, Null, Null, kwdo, stmtso.expr, kwend_o.kwend)}
299 | {extern_implicit} [doc]:nd redef visibility kwmeth qmethid signature annotation_noend? extern_calls extern_code_block {-> New propdef.meth(doc.doc, redef.kwredef, visibility, kwmeth, Null, Null, qmethid.methid, signature.signature, annotation_noend.annotations, extern_calls, extern_code_block, Null, Null, Null)}
300 !toplevel| {var3} [doc]:nd redef visibility kwvar id typing_o annotation_withend {-> New propdef.attr(doc.doc, redef.kwredef, visibility, kwvar, id, typing_o.type, Null, Null, annotation_withend.annotations, Null, Null, Null)}
301 !toplevel| {var4} [doc]:nd redef visibility kwvar id typing_o assign [n2]:no expr annotation_withend {-> New propdef.attr(doc.doc, redef.kwredef, visibility, kwvar, id, typing_o.type, assign, expr.expr, annotation_withend.annotations, Null, Null, Null)}
302 !toplevel| {var5} [doc]:nd redef visibility kwvar id typing_o annotation_noend? kwdo stmtso kwend? {-> New propdef.attr(doc.doc, redef.kwredef, visibility, kwvar, id, typing_o.type, Null, Null, annotation_noend.annotations, kwdo, stmtso.expr, kwend)}
303 !toplevel| {init} [doc]:nd redef visibility kwinit qmethid? signature annotation_noend? kwdo stmtso kwend_o {-> New propdef.meth(doc.doc, redef.kwredef, visibility, Null, kwinit, Null, qmethid.methid, signature, annotation_noend.annotations, Null, Null, kwdo, stmtso.expr, kwend_o.kwend)}
304 !toplevel| {type} [doc]:nd redef visibility kwtype classid typing annotation_withend {-> New propdef.type(doc.doc, redef.kwredef, visibility, kwtype, classid, typing.type, annotation_withend.annotations)}
305 !toplevel| {extern_init_implicit} [doc]:nd redef visibility kwnew qmethid? signature annotation_noend? extern_calls extern_code_block {-> New propdef.meth(doc.doc, redef.kwredef, visibility, Null, Null, kwnew, qmethid.methid, signature, annotation_noend.annotations, extern_calls, extern_code_block, Null, Null, Null)}
306 !toplevel| {annot} line_annotation_forclass {-> line_annotation_forclass.propdef}
307 !toplevel| {super} superclass {-> superclass.propdef}
309 annotation_withend~nonull {-> annotations?}
310 = {oneliner} kwis annotation_list {-> New annotations(kwis, Null, Null, [annotation_list.annotation], Null, Null)}
311 | {more} kwis n1 line_annotation+ kwend {-> New annotations(kwis, Null, Null, [line_annotation.annotation], Null, kwend) }
312 !nonull | {null} {-> Null}
314 annotation_noend {-> annotations}
315 = {oneliner} kwis annotation_list {-> New annotations(kwis, Null, Null, [annotation_list.annotation], Null, Null)}
316 | {more} kwis n1 line_annotation+ {-> New annotations(kwis, Null, Null, [line_annotation.annotation], Null, Null) }
320 = {public} {-> New visibility.public(Null)}
321 | {public2} kwpublic no {-> New visibility.public(kwpublic)}
322 | {private} kwprivate no {-> New visibility.private(kwprivate)}
323 | {protected} kwprotected no {-> New visibility.protected(kwprotected)}
324 | {intrude} kwintrude no {-> New visibility.intrude(kwintrude)}
327 methid~noid {-> methid}
328 = {plus} plus {-> New methid.plus(plus)}
329 | {minus} minus {-> New methid.minus(minus)}
330 | {star} star {-> New methid.star(star)}
331 | {starstar} starstar {-> New methid.starstar(starstar)}
332 | {slash} slash {-> New methid.slash(slash)}
333 | {percent} percent {-> New methid.percent(percent)}
334 | {pipe} pipe {-> New methid.pipe(pipe)}
335 | {caret} caret {-> New methid.caret(caret)}
336 | {amp} amp {-> New methid.amp(amp)}
337 | {tilde} tilde {-> New methid.tilde(tilde)}
338 | {eq} eq {-> New methid.eq(eq)}
339 | {ne} ne {-> New methid.ne(ne)}
340 | {le} le {-> New methid.le(le)}
341 | {ge} ge {-> New methid.ge(ge)}
342 | {lt} lt {-> New methid.lt(lt)}
343 | {gt} gt {-> New methid.gt(gt)}
344 | {ll} ll {-> New methid.ll(ll)}
345 | {gg} gg {-> New methid.gg(gg)}
346 | {bra} obra cbra {-> New methid.bra(obra, cbra)}
347 | {starship} starship {-> New methid.starship(starship)}
348 | {assign} id assign {-> New methid.assign(id, assign)}
349 | {braassign} obra cbra assign {-> New methid.braassign(obra, cbra, assign)}
350 !noid | {id} id {-> New methid.id(id)}
353 signature {-> signature}
354 = opar no params cpar typing [no2]:no {-> New signature(opar, [params.param], cpar, typing.type)}
355 | {noret} opar no params cpar [no2]:no {-> New signature(opar, [params.param], cpar, Null)}
356 | {nopar} typing no {-> New signature(Null, [], Null, typing.type)}
357 | {noparnoret} no {-> New signature(Null, [], Null, Null)}
361 = param params_tail* [n2]:no {-> [param, params_tail.param] }
364 params_tail {-> param}
365 = comma no param {-> param};
367 = {untyped} id annotations_o {-> New param(id, Null, Null, annotations_o.annotations)}
368 | id annotations? typing dotdotdot? {-> New param(id, typing.type, dotdotdot, annotations)}
371 extern_calls {-> extern_calls?}
372 = kwimport no extern_call extern_call_tail* {-> New extern_calls( kwimport, [extern_call, extern_call_tail.extern_call] )}
375 extern_call_tail {-> extern_call}
376 = comma no extern_call {-> extern_call};
377 extern_call {-> extern_call}
378 = {prop} extern_call_prop {-> extern_call_prop.extern_call}
379 | {cast} extern_call_cast {-> extern_call_cast.extern_call}
380 | {super} kwsuper {-> New extern_call.super( kwsuper )}
382 extern_call_prop {-> extern_call}
383 = {local} qmethid {-> New extern_call.local_prop( qmethid.methid )}
384 | {full} type dot qmethid {-> New extern_call.full_prop( type, dot, qmethid.methid )}
385 | {init} type {-> New extern_call.init_prop( type )}
387 extern_call_cast {-> extern_call}
388 = {as_cast} [from_type]:type dot kwas [n2]:no opar [n3]:no [to_type]:type [n4]:no cpar {-> New extern_call.cast_as(from_type, dot, kwas, to_type)}
389 | {as_cast2}[from_type]:type dot kwas [n2]:no [to_type]:type {-> New extern_call.cast_as(from_type, dot, kwas, to_type)}
390 | {as_nullable} type dot kwas [n2]:no opar [n3]:no kwnullable [n4]:no cpar {-> New extern_call.as_nullable( type, kwas, kwnullable)}
391 | {as_nullable2}type dot kwas [n2]:no kwnullable {-> New extern_call.as_nullable( type, kwas, kwnullable)}
392 | {as_not_nullable} type dot kwas [n2]:no opar [n3]:no kwnot [n4]:no kwnullable [n5]:no cpar {-> New extern_call.as_not_nullable( type, kwas, kwnot, kwnullable)}
393 | {as_not_nullable2}type dot kwas [n2]:no kwnot [n3]:no kwnullable {-> New extern_call.as_not_nullable( type, kwas, kwnot, kwnullable)}
396 string_o {->string?} = string? {-> string};
398 in_language = kwin no string [n1]:no {-> New in_language(kwin, string)};
399 extern_code_block = in_language? extern_code_segment;
400 extern_code_block_o {-> extern_code_block?}
401 = extern_code_block {-> extern_code_block}
404 extern_code_body {-> extern_code_block} = no extern_code_block {-> extern_code_block};
406 /* TYPES *********************************************************************/
407 type~nobra~nopar {-> type}
408 = {simple} kwnullable? classid annotations_o~nopar {-> New type(kwnullable, classid, Null, [], Null, annotations_o~nopar.annotations)}
409 !nobra | {generic} kwnullable? classid obra no types [n2]:no cbra annotations_o~nopar {-> New type(kwnullable, classid, obra, [types.type], cbra, annotations_o~nopar.annotations)}
412 = type types_tail* {-> [type, types_tail.type]};
414 = comma no type {-> type};
416 = column no type {-> type};
418 = column no type {-> type}
422 /* STATMENTS *****************************************************************/
423 stmtso~withelse~withend {-> expr?}
424 = {block} n stmtsnend {-> stmtsnend.expr}
425 | {emptyblock} n kwend {-> New expr.block([], kwend)}
426 | {emptyoneline} kwend {-> New expr.block([], kwend)}
427 !withend| {oneline} stmt~withelse {-> stmt~withelse.expr}
430 = stmt stmts_tail* {-> New expr.block([stmt.expr, stmts_tail.expr], Null)};
432 = stmt stmts_tail* n {-> New expr.block([stmt.expr, stmts_tail.expr], Null)};
434 = stmt stmts_tail* n kwend {-> New expr.block([stmt.expr, stmts_tail.expr], kwend)};
436 = n stmt {-> stmt.expr};
437 stmt~withelse~noexpr~nopar {-> expr}
438 = {vardecl} vardecl {-> vardecl.expr}
439 | {assign} assignment~nopar {-> assignment~nopar.expr}
440 | {return} kwreturn expr? {-> New expr.return(kwreturn, expr)}
441 | {break} kwbreak label? {-> New expr.break(kwbreak, label)}
442 | {abort} kwabort {-> New expr.abort(kwabort)}
443 | {continue} kwcontinue label? {-> New expr.continue(kwcontinue, label)}
444 | {do} do~withelse {-> do~withelse.expr}
445 !noexpr | {if} if~withelse {-> if~withelse.expr}
446 | {while} while~withelse {-> while~withelse.expr}
447 | {loop} loop~withelse {-> loop~withelse.expr}
448 | {for} for~withelse {-> for~withelse.expr}
449 | {with} with~withelse {-> with~withelse.expr}
450 | {assert} assert~withelse {-> assert~withelse.expr}
451 !noexpr | {call} recv qid args_nopar {-> New expr.call(recv.expr, qid, args_nopar.exprs)}
452 !noexpr | {super} qualified_o kwsuper args_nopar {-> New expr.super(qualified_o.qualified, kwsuper, args_nopar.exprs)}
453 !noexpr | {init} recv qualified? kwinit args_nopar {-> New expr.init(recv.expr, kwinit, args_nopar.exprs)}
454 | {debug_type_is} kwdebug kwtype type column expr {-> New expr.debug_type(kwdebug, kwtype, expr.expr, type) }
460 = kwvar id annotations? typing_o {-> New expr.vardecl(kwvar, id, typing_o.type, Null, Null, annotations)}
461 | {assign} kwvar id annotations? typing_o assign no expr {-> New expr.vardecl(kwvar, id, typing_o.type, assign, expr.expr, annotations)}
464 assignment~nopar {-> expr}
465 = {attr} recv~nopar qualified_o attrid assign expr {-> New expr.attr_assign(recv~nopar.expr, attrid, assign, expr)}
466 | {call} recv~nopar qid args assign expr {-> New expr.call_assign(recv~nopar.expr, qid, args.exprs, assign, expr)}
467 | {bra} expr_atom~nopar braargs assign expr {-> New expr.bra_assign(expr_atom~nopar.expr, braargs.exprs, assign, expr)}
468 | {attr_re} recv~nopar qualified_o attrid assign_op expr {-> New expr.attr_reassign(recv~nopar.expr, attrid, assign_op, expr)}
469 | {call_re} recv~nopar qid args assign_op expr {-> New expr.call_reassign(recv~nopar.expr, qid, args.exprs, assign_op, expr)}
470 | {bra_re} expr_atom~nopar braargs assign_op expr {-> New expr.bra_reassign(expr_atom~nopar.expr, braargs.exprs, assign_op, expr)}
477 | {percent} percenteq
478 | {starstar} starstareq
486 do~withelse {-> expr}
487 = kwdo stmtso_withend label {-> New expr.do(kwdo, stmtso_withend.expr, label)}
488 | {nolabel} kwdo stmtso~withelse {-> New expr.do(kwdo, stmtso~withelse.expr, Null)}
491 if~withelse {-> expr}
492 = {onelineelse} kwif no expr [n2]:no kwthen stmt_withelse kwelse stmtso~withelse {-> New expr.if(kwif, expr, kwthen, stmt_withelse.expr, kwelse, stmtso~withelse.expr)}
493 !withelse | {oneline} kwif no expr [n2]:no kwthen stmt {-> New expr.if(kwif, expr, kwthen, stmt.expr, Null, Null)}
494 !withelse | {block} kwif no expr [n2]:no kwthen [n3]:n stmtsn kwelse stmtso {-> New expr.if(kwif, expr, kwthen, stmtsn.expr, kwelse, stmtso.expr)}
495 !withelse | {emptyblock} kwif no expr [n2]:no kwthen [n3]:n? kwelse stmtso {-> New expr.if(kwif, expr, kwthen, Null, kwelse, stmtso.expr)}
496 !withelse | {blocknoelse} kwif no expr [n2]:no kwthen [n3]:n stmtsn endblock {-> New expr.if(kwif, expr, kwthen, stmtsn.expr, Null, endblock.expr)}
497 !withelse | {emptyblocknoelse} kwif no expr [n2]:no kwthen [n3]:n? endblock {-> New expr.if(kwif, expr, kwthen, Null, Null, endblock.expr)}
500 = {empty} kwend {-> New expr.block([], kwend)}
503 loop~withelse {-> expr}
504 = kwloop stmtso_withend label {-> New expr.loop(kwloop, stmtso_withend.expr, label)}
505 | {nolabel} kwloop stmtso~withelse {-> New expr.loop(kwloop, stmtso~withelse.expr, Null)}
508 while~withelse {-> expr}
509 = kwwhile no expr [n2]:no kwdo stmtso_withend label {-> New expr.while(kwwhile, expr, kwdo, stmtso_withend.expr, label)}
510 | {nolabel} kwwhile no expr [n2]:no kwdo stmtso~withelse {-> New expr.while(kwwhile, expr, kwdo, stmtso~withelse.expr, Null)}
513 for~withelse {-> expr}
514 = kwfor no for_groups [n4]:no kwdo stmtso_withend label {-> New expr.for(kwfor, [for_groups.for_group], kwdo, stmtso_withend.expr, label)}
515 | {nolabel} kwfor no for_groups [n4]:no kwdo stmtso~withelse {-> New expr.for(kwfor, [for_groups.for_group], kwdo, stmtso~withelse.expr, Null)}
518 for_groups {-> for_group*}
519 = {one} for_group {-> [for_group]}
520 | {many} for_groups no comma [n2]:no for_group {-> [for_groups.for_group, for_group] }
523 = [ids]:idlist [n2]:no kwin [n3]:no expr {-> New for_group([ids.id], kwin, expr)}
526 with~withelse {-> expr}
527 = kwwith no withexpr [n4]:no kwdo stmtso_withend label {-> New expr.with(kwwith, withexpr.expr, kwdo, stmtso_withend.expr, label)}
528 | {nolabel} kwwith no withexpr [n4]:no kwdo stmtso~withelse {-> New expr.with(kwwith, withexpr.expr, kwdo, stmtso~withelse.expr, Null)}
532 = {assign} id annotations? typing_o assign no expr {-> New expr.vardecl(Null, id, typing_o.type, assign, expr.expr, annotations)}
536 assert~withelse {-> expr}
537 = {else} kwassert assertid? expr kwelse stmtso~withelse {-> New expr.assert(kwassert, assertid.id, expr, kwelse, stmtso~withelse.expr)}
538 !withelse| {noelse} kwassert assertid? expr {-> New expr.assert(kwassert, assertid.id, expr, Null, Null)}
543 /* EXPRESSIONS ***************************************************************/
544 expr~nopar~nobra {-> expr}
545 = expr_and~nopar~nobra {-> expr_and~nopar~nobra.expr}
546 | {ifexpr} kwif [n1]:no expr [n2]:no kwthen [n3]:no [then]:expr [n4]:no kwelse [n5]:no [else]:expr~nopar~nobra {-> New expr.ifexpr(kwif, expr, kwthen, then, kwelse, else.expr)}
549 expr_and~nopar~nobra {-> expr}
550 = expr_not~nopar~nobra {-> expr_not~nopar~nobra.expr}
551 | {:or} expr_and~nopar~nobra kwor :no expr_not~nopar~nobra
552 | {:and} expr_and~nopar~nobra kwand :no expr_not~nopar~nobra
553 | {:or_else} expr_and~nopar~nobra kwor kwelse :no expr_not~nopar~nobra
554 | {:implies} expr_and~nopar~nobra kwimplies :no expr_not~nopar~nobra
557 expr_not~nopar~nobra {-> expr}
558 = expr_eq~nopar~nobra {-> expr_eq~nopar~nobra.expr}
559 | {not} kwnot no expr_not~nopar~nobra {-> New expr.not(kwnot, expr_not~nopar~nobra.expr)}
562 expr_eq~nopar~nobra {-> expr}
563 = expr_bitor~nopar~nobra {-> expr_bitor~nopar~nobra.expr}
564 | {:eq} expr_bitor~nopar~nobra eq :no [expr2]:expr_bitor~nopar~nobra
565 | {:ne} expr_bitor~nopar~nobra ne :no [expr2]:expr_bitor~nopar~nobra
566 | {:lt} expr_bitor~nopar~nobra lt :no [expr2]:expr_bitor~nopar~nobra
567 | {:le} expr_bitor~nopar~nobra le :no [expr2]:expr_bitor~nopar~nobra
568 | {:gt} expr_bitor~nopar~nobra gt :no [expr2]:expr_bitor~nopar~nobra
569 | {:ge} expr_bitor~nopar~nobra ge :no [expr2]:expr_bitor~nopar~nobra
570 | {:starship} expr_bitor~nopar~nobra starship :no [expr2]:expr_bitor~nopar~nobra
571 | {:isa} expr_bitor~nopar~nobra kwisa :no type~nobra
574 expr_bitor~nopar~nobra {-> expr}
575 = [expr]:expr_bitxor~nopar~nobra {-> expr.expr}
576 | {:pipe} expr_bitor~nopar~nobra pipe :no [expr2]:expr_bitxor~nopar~nobra
579 expr_bitxor~nopar~nobra {-> expr}
580 = [expr]:expr_bitand~nopar~nobra {-> expr.expr}
581 | {:caret} expr_bitxor~nopar~nobra caret :no [expr2]:expr_bitand~nopar~nobra
584 expr_bitand~nopar~nobra {-> expr}
585 = [expr]:expr_shift~nopar~nobra {-> expr.expr}
586 | {:amp} expr_bitand~nopar~nobra amp :no [expr2]:expr_shift~nopar~nobra
589 expr_shift~nopar~nobra {-> expr}
590 = [expr]:expr_add~nopar~nobra {-> expr.expr}
591 | {:ll} expr_shift~nopar~nobra ll :no [expr2]:expr_add~nopar~nobra
592 | {:gg} expr_shift~nopar~nobra gg :no [expr2]:expr_add~nopar~nobra
595 expr_add~nopar~nobra {-> expr}
596 = expr_mul~nopar~nobra {-> expr_mul~nopar~nobra.expr}
597 | {:plus} expr_add~nopar~nobra plus :no [expr2]:expr_mul~nopar~nobra
598 | {:minus} expr_add~nopar~nobra minus :no [expr2]:expr_mul~nopar~nobra
601 expr_mul~nopar~nobra {-> expr}
602 = expr_pow~nopar~nobra {-> expr_pow~nopar~nobra.expr}
603 | {:star} expr_mul~nopar~nobra star :no [expr2]:expr_pow~nopar~nobra
604 | {:slash} expr_mul~nopar~nobra slash :no [expr2]:expr_pow~nopar~nobra
605 | {:percent} expr_mul~nopar~nobra percent :no [expr2]:expr_pow~nopar~nobra
608 expr_pow~nopar~nobra {-> expr}
609 = expr_minus~nopar~nobra {-> expr_minus~nopar~nobra.expr}
610 | {:starstar} expr_minus~nopar~nobra starstar :no [expr2]:expr_pow~nopar~nobra
613 expr_minus~nopar~nobra {-> expr}
614 = expr_new~nopar~nobra {-> expr_new~nopar~nobra.expr}
615 | {:uminus} minus expr_minus~nobra
616 | {:uplus} plus expr_minus~nobra
617 | {:utilde} tilde expr_minus~nobra
618 | {:once} kwonce :no expr_minus~nobra
621 expr_new~nopar~nobra {-> expr}
622 = expr_atom~nopar~nobra {-> expr_atom~nopar~nobra.expr}
623 | {new} kwnew no type~nobra_nopar args {-> New expr.new(kwnew, type~nobra_nopar.type, Null, args.exprs)}
624 | {isset_attr} kwisset recv~nopar~nobra qualified_o attrid {-> New expr.isset_attr(kwisset, recv~nopar~nobra.expr, attrid)}
627 expr_atom~nopar~nobra {-> expr}
628 = expr_single~nopar~nobra {-> expr_single~nopar~nobra.expr}
629 | {attr} recv~nopar~nobra qualified_o attrid {-> New expr.attr(recv~nopar~nobra.expr, attrid)}
630 | {call} recv~nopar~nobra qid args {-> New expr.call(recv~nopar~nobra.expr, qid, args.exprs)}
631 | {super} qualified_o kwsuper args {-> New expr.super(qualified_o.qualified, kwsuper, args.exprs)}
632 | {init} recv~nopar~nobra kwinit args {-> New expr.init(recv~nopar~nobra.expr, kwinit, args.exprs)}
633 !nobra | {bra} expr_atom~nopar braargs {-> New expr.bra(expr_atom~nopar.expr, braargs.exprs)}
634 | {new} kwnew no type~nobra_nopar dot [n2]:no qid args {-> New expr.new(kwnew, type~nobra_nopar.type, qid, args.exprs)}
635 | {as_cast} expr_atom~nopar~nobra dot no kwas [n2]:no opar [n3]:no type [n4]:no cpar {-> New expr.as_cast(expr_atom~nopar~nobra.expr, kwas, opar, type, cpar)}
636 | {as_notnull} expr_atom~nopar~nobra dot no kwas [n2]:no opar [n3]:no kwnot [n4]:no kwnull [n5]:no cpar {-> New expr.as_notnull(expr_atom~nopar~nobra.expr, kwas, opar, kwnot, kwnull, cpar)}
637 | {as_notnull2}expr_atom~nopar~nobra dot no kwas [n2]:no kwnot [n4]:no kwnull {-> New expr.as_notnull(expr_atom~nopar~nobra.expr, kwas, Null, kwnot, kwnull, Null)}
640 arg~nopar~nobra {-> expr}
641 = [expr]:expr~nopar~nobra {-> expr.expr}
642 | {vararg} [expr]:expr~nopar~nobra dotdotdot {-> New expr.vararg(expr.expr, dotdotdot)}
643 | {namedarg} id assign [expr]:expr~nopar~nobra {-> New expr.namedarg(id, assign, expr.expr) }
646 expr_single~nopar~nobra {-> expr}
647 = {self} kwself annotations_o {-> New expr.self(kwself, annotations_o.annotations)}
648 | {true} kwtrue annotations_o {-> New expr.true(kwtrue, annotations_o.annotations)}
649 | {false} kwfalse annotations_o {-> New expr.false(kwfalse, annotations_o.annotations)}
650 | {null} kwnull annotations_o {-> New expr.null(kwnull, annotations_o.annotations)}
651 | {integer} integer annotations_o {-> New expr.integer(integer, annotations_o.annotations)}
652 | {float} float annotations_o {-> New expr.float(float, annotations_o.annotations)}
653 | {char} char annotations_o {-> New expr.char(char, annotations_o.annotations)}
654 | {string} string annotations_o {-> New expr.string(string, annotations_o.annotations)}
655 | {superstring} superstring {-> superstring.expr}
656 !nopar | {par} expr_par {-> expr_par.expr}
657 // !nopar to unambiguise 'foo[5].bar' between '(foo[5]).bar' and 'foo([5].bar),
658 !nobra!nopar | {range} obra no expr [n2]:no dotdot [n3]:no [expr2]:expr_nobra [n4]:no cbra annotations_o {-> New expr.crange(obra, expr, dotdot, expr2.expr, cbra, annotations_o.annotations)}
659 !nobra!nopar | {orange} obra no expr [n2]:no dotdot [n3]:no [expr2]:expr_nobra [n4]:no [cbra]:obra annotations_o {-> New expr.orange(obra, expr, dotdot, expr2.expr, cbra, annotations_o.annotations)}
660 !nobra!nopar | {array} obra no array_items typing_o cbra annotations_o {-> New expr.array(obra, [array_items.expr], typing_o.type, cbra, annotations_o.annotations)}
664 = {par} opar no any_expr [n2]:no cpar annotations_o {-> New expr.par(opar, any_expr.expr, cpar, annotations_o.annotations)}
665 | {tuple} opar no many_expr [n2]:no cpar annotations_o {-> New expr.par(opar, many_expr.expr, cpar, annotations_o.annotations)}
669 = any_expr many_expr_tail+ {-> New expr.many([any_expr.expr, many_expr_tail.expr])}
672 many_expr_tail {->expr}
673 = comma no any_expr {-> any_expr.expr}
676 array_items {-> expr*}
677 = array_item array_items_tail* {-> [array_item.expr, array_items_tail.expr]}
679 array_items_tail {-> expr}
680 = comma no array_item {-> array_item.expr}
684 | {for} kwfor no for_groups [n4]:no kwdo [block]:array_item {-> New expr.for(kwfor, [for_groups.for_group], kwdo, block.expr, Null)}
685 | {if} kwif [n1]:no expr [n2]:no kwthen [n3]:no [then]:array_item {-> New expr.if(kwif, expr, kwthen, then.expr, Null, Null)}
688 superstring {-> expr}
689 = superstring_start superstring_middle* superstring_end annotations_o {-> New expr.superstring([superstring_start.expr, superstring_middle.expr, superstring_end.expr], annotations_o.annotations)};
690 superstring_start {-> expr*}
691 = start_string_p no expr [n2]:no {-> [start_string_p.expr, expr]}
692 | {noexpr} start_string_p no {-> [start_string_p.expr]}
694 start_string_p {-> expr}
695 = start_string {-> New expr.start_string(start_string)};
696 superstring_middle {-> expr*}
697 = mid_string_p no expr [n2]:no {-> [mid_string_p.expr, expr]}
698 | {noexpr} mid_string_p no {-> [mid_string_p.expr]}
700 mid_string_p {-> expr}
701 = mid_string {-> New expr.mid_string(mid_string)};
702 superstring_end {-> expr}
703 = end_string {-> New expr.end_string(end_string)};
705 /* ANNOTATIONS *******************************************************************/
707 annotations~nopar {-> annotations}
708 = {one} at one_annotation~nopar {-> New annotations(Null, at, Null, [one_annotation~nopar.annotation], Null, Null)}
709 | {many} at opar no annotation_list [n2]:no cpar {-> New annotations(Null, at, opar, [annotation_list.annotation], cpar, Null)}
711 annotations_o~nopar {-> annotations?}
712 = annotations~nopar {-> annotations~nopar.annotations}
716 one_annotation~nopar {-> annotation}
717 = {alone} redef visibility atid annotations_o~nopar {-> New annotation(Null, redef.kwredef, visibility, atid, Null, [], Null, annotations_o~nopar.annotations)}
718 // !nopar to unambiguise 'new T@foo(bar)' between 'new T@(foo(bar))' and 'new (T@foo)(bar)'
719 !nopar | {args} redef visibility atid opar no at_args [n2]:no cpar annotations_o~nopar {-> New annotation(Null, redef.kwredef, visibility, atid, opar, [at_args.expr], cpar, annotations_o~nopar.annotations)}
722 annotation_list {-> annotation*}
723 = {many} one_annotation_list annotations_tail* {-> [one_annotation_list.annotation, annotations_tail.annotation] }
726 one_annotation_list~nopar {-> annotation}
727 = {alone} redef visibility atid annotations_o~nopar {-> New annotation(Null, redef.kwredef, visibility, atid, Null, [], Null, annotations_o~nopar.annotations)}
728 // !nopar to unambiguise 'new T@foo(bar)' between 'new T@(foo(bar))' and 'new (T@foo)(bar)'
729 !nopar | {args} redef visibility atid opar no at_args [n2]:no cpar annotations_o~nopar {-> New annotation(Null, redef.kwredef, visibility, atid, opar, [at_args.expr], cpar, annotations_o~nopar.annotations)}
730 !nopar | {nopar} redef visibility atid at_arg_single {-> New annotation(Null, redef.kwredef, visibility, atid, Null, [at_arg_single.expr], Null, Null)}
732 at_arg_single {-> expr}
733 // FIXME: why expr_single but not expr_atom is not clear :(
734 = {expr} [expr]:expr_single_nopar {-> expr.expr}
737 annotations_tail {-> annotation}
738 = comma no one_annotation_list {-> one_annotation_list.annotation}
741 line_annotation {-> annotation}
742 = [doc]:nd redef visibility atid annotations? n1 {-> New annotation(doc.doc, redef.kwredef, visibility, atid.atid, Null, [], Null, annotations)}
743 | {args} [doc]:nd redef visibility atid opar no at_args cpar annotations? n1 {-> New annotation(doc.doc, redef.kwredef, visibility, atid.atid, opar, [at_args.expr], cpar, annotations)}
744 | {nopar} [doc]:nd redef visibility atid at_args_nopar n1 {-> New annotation(doc.doc, redef.kwredef, visibility, atid.atid, Null, [at_args_nopar.expr], Null, Null)}
746 line_annotation_forclass {-> propdef}
747 = [doc]:nd atid_forclass annotations? {-> New propdef.annot(doc.doc, Null, Null, atid_forclass.atid, Null, [], Null, annotations)}
748 | {args} [doc]:nd atid_forclass opar no at_args cpar annotations? {-> New propdef.annot(doc.doc, Null, Null, atid_forclass.atid, opar, [at_args.expr], cpar, annotations)}
749 | {nopar} [doc]:nd atid_forclass at_args_nopar {-> New propdef.annot(doc.doc, Null, Null, atid_forclass.atid, Null, [at_args_nopar.expr], Null, Null)}
752 at_args~nopar {-> expr* }
753 = {many} any_expr~nopar at_args_tail* {-> [any_expr~nopar.expr, at_args_tail.expr]}
756 at_args_tail {-> expr}
757 = comma no any_expr {-> any_expr.expr}
760 any_expr~nopar {-> expr}
761 = {type} type {-> New expr.type(type)}
762 | {expr} expr~nopar {-> expr~nopar.expr}
763 | {stmt} stmt_noexpr~nopar {-> stmt_noexpr~nopar.expr}
764 | {methid} recv~nopar qmethid_noid {-> New expr.methid(recv~nopar.expr, qmethid_noid.methid)}
765 !nopar | {at} annotations {-> New expr.at(annotations.annotations)}
768 atid~forclass {-> atid}
769 = {id} id {-> New atid.id(id)}
770 !forclass | {kwextern} kwextern {-> New atid.kwextern(kwextern)}
771 // | {kwimport} kwimport {-> New atid.kwimport(kwimport)}
772 | {kwabstract} kwabstract {-> New atid.kwabstract(kwabstract)}
775 /* MISC **********************************************************************/
777 recv~nopar~nobra {-> expr}
778 = expr_atom~nopar~nobra dot no {-> expr_atom~nopar~nobra.expr}
779 | {implicit} {-> New expr.implicit_self()}
783 = args_n {-> args_n.exprs}
784 | {empty} {-> New exprs.list([])}
787 = opar no expr_list cpar {-> New exprs.par(opar, [expr_list.expr], cpar) }
788 | {emptypar} opar no cpar {-> New exprs.par(opar, [], cpar) }
790 args_nopar {-> exprs}
791 = opar no expr_list cpar {-> New exprs.par(opar, [expr_list.expr], cpar) }
792 | {onearg} expr_nopar {-> New exprs.list([expr_nopar.expr])}
793 | {emptypar} opar no cpar {-> New exprs.par(opar, [], cpar) }
794 | {empty} {-> New exprs.list([])}
797 = obra no expr_list cbra {-> New exprs.bra(obra, [expr_list.expr], cbra)};
799 = arg [n2]:no expr_tail* {-> [arg.expr, expr_tail.expr]};
801 = comma no arg [n2]:no {-> arg.expr};
803 = opar no idlist_nopar [n2]:no cpar {-> [idlist_nopar.id]}
804 | {nopar} idlist_nopar {-> [idlist_nopar.id]}
806 idlist_nopar {-> id*}
807 = {single} id {-> [id]}
808 | {more} idlist_nopar comma [n2]:no id {-> [idlist_nopar.id, id]}
811 module_name {-> module_name}
812 = {mod} modquad* id {-> New module_name(Null, [modquad.id], id)}
813 | {root} quad no modquad* id {-> New module_name(quad, [modquad.id], id)}
817 = {cla} modquad* classquad {-> New qualified([modquad.id], classquad.classid)}
818 | {mod} modquad+ {-> New qualified([modquad.id], Null)}
820 qualified_o {-> qualified?}
821 = qualified {-> qualified}
827 qclassid {-> classid}
828 = qualified? classid {-> classid}
830 qmethid~noid {-> methid}
831 = qualified? methid~noid {-> methid~noid.methid}
834 = id quad no {-> id};
835 classquad {-> classid}
836 = classid quad no {-> classid};
842 /* A single hard break */
843 n1 = {a} comment | {b} eol | {c} semi;
845 /* A mandatory hard break, returns the last comment */
847 = {a} n2* comment+ {-> New doc([comment])}
849 !nosemi | {c} n2* comment* semi n? {-> n.doc }
852 /* An optional hard break, returns the last comment.
853 * Used mainly to introduce optional documentation */
859 /* An optional soft break.
860 * Used when a unambiguous line break or comment could be inserted/ */
870 /*****************************************************************************/
872 /*****************************************************************************/
874 module = moduledecl? [imports]:import* [extern_code_blocks]:extern_code_block* [classdefs]:classdef*;
877 = doc? kwredef? visibility kwmodule [name]:module_name annotations?;
879 import = {std} visibility kwimport [name]:module_name annotations?
880 | {no} visibility kwimport kwend
885 | {private} kwprivate
886 | {protected} kwprotected
887 | {intrude} kwintrude
890 classdef= {std} doc? kwredef? visibility classkind [id]:classid? obra? [formaldefs]:formaldef* cbra? extern_code_block? [propdefs]:propdef* kwend
891 | {top} [propdefs]:propdef*
892 | {main} [propdefs]:propdef*
896 | {abstract} kwabstract kwclass
897 | {interface} kwinterface
899 | {extern} kwextern kwclass?
901 formaldef = [id]:classid type? annotations?;
904 propdef = {attr} doc? kwredef? visibility kwvar [id2]:id type? assign? expr? annotations? kwdo? [block]:expr? kwend?
905 | {main_meth} kwredef? [block]:expr?
906 | {type} doc? kwredef? visibility kwtype [id]:classid type annotations?
907 | {meth} doc? kwredef? visibility kwmeth? kwinit? kwnew? methid? signature annotations? extern_calls? extern_code_block? kwdo? [block]:expr? kwend?
908 | {super} doc? kwredef? visibility kwsuper type annotations?
909 | {annot} doc? kwredef? visibility? atid opar? [args]:expr* cpar? annotations?
917 | {starstar} [op]:starstar
919 | {percent} [op]:percent
928 | {starship} [op]:starship
935 | {braassign} obra cbra assign
942 signature = opar? [params]:param* cpar? type?;
944 param = id type? dotdotdot? annotations?
947 type = kwnullable? [id]:classid obra? [types]:type* cbra? annotations?;
951 expr = {block} expr* kwend?
952 | {vardecl} kwvar? id type? assign? expr? annotations?
953 | {return} kwreturn? expr?
954 | {break} kwbreak label?
956 | {continue} kwcontinue? label?
957 | {do} kwdo [block]:expr? label?
958 | {if} kwif expr kwthen [then]:expr? kwelse? [else]:expr?
959 | {ifexpr} kwif expr kwthen [then]:expr kwelse [else]:expr
960 | {while} kwwhile expr kwdo [block]:expr? label?
961 | {loop} kwloop [block]:expr? label?
962 | {for} kwfor [groups]:for_group* kwdo [block]:expr? label?
963 | {with} kwwith expr kwdo [block]:expr? label?
964 | {assert} kwassert id? expr kwelse? [else]:expr?
967 | {binop} expr [expr2]:expr
968 | {or} expr [op]:kwor [expr2]:expr
969 | {and} expr [op]:kwand [expr2]:expr
970 | {or_else} expr [op]:kwor kwelse [expr2]:expr
971 | {implies} expr [op]:kwimplies [expr2]:expr
973 | {eq} expr [op]:eq [expr2]:expr
974 | {ne} expr [op]:ne [expr2]:expr
975 | {lt} expr [op]:lt [expr2]:expr
976 | {le} expr [op]:le [expr2]:expr
977 | {ll} expr [op]:ll [expr2]:expr
978 | {gt} expr [op]:gt [expr2]:expr
979 | {ge} expr [op]:ge [expr2]:expr
980 | {gg} expr [op]:gg [expr2]:expr
981 | {isa} expr kwisa type
982 | {plus} expr [op]:plus [expr2]:expr
983 | {minus} expr [op]:minus [expr2]:expr
984 | {starship} expr [op]:starship [expr2]:expr
985 | {star} expr [op]:star [expr2]:expr
986 | {starstar} expr [op]:starstar [expr2]:expr
987 | {slash} expr [op]:slash [expr2]:expr
988 | {percent} expr [op]:percent [expr2]:expr
989 | {pipe} expr [op]:pipe [expr2]:expr
990 | {caret} expr [op]:caret [expr2]:expr
991 | {amp} expr [op]:amp [expr2]:expr
992 | {uminus} [op]:minus expr
993 | {uplus} [op]:plus expr
994 | {utilde} [op]:tilde expr
995 | {new} kwnew type qid? [args]:exprs
996 | {attr} expr [id]:attrid
997 | {attr_assign} expr [id]:attrid assign [value]:expr
998 | {attr_reassign} expr [id]:attrid assign_op [value]:expr
999 | {call} expr qid [args]:exprs
1000 | {call_assign} expr qid [args]:exprs assign [value]:expr
1001 | {call_reassign} expr qid [args]:exprs assign_op [value]:expr
1002 | {super} qualified? kwsuper [args]:exprs
1003 | {init} expr kwinit [args]:exprs
1004 | {bra} expr [args]:exprs
1005 | {bra_assign} expr [args]:exprs assign [value]:expr
1006 | {bra_reassign} expr [args]:exprs assign_op [value]:expr
1008 | {var_assign} id assign [value]:expr
1009 | {var_reassign} id assign_op [value]:expr
1010 | {range} expr [expr2]:expr annotations?
1011 | {crange} obra expr dotdot [expr2]:expr cbra annotations?
1012 | {orange} obra expr dotdot [expr2]:expr [cbra]:obra annotations?
1013 | {array} obra [exprs]:expr* type? cbra annotations?
1014 | {self} kwself annotations?
1016 | {true} kwtrue annotations?
1017 | {false} kwfalse annotations?
1018 | {null} kwnull annotations?
1019 | {integer} integer annotations?
1020 | {float} float annotations?
1021 | {char} char annotations?
1022 | {string} string annotations?
1023 | {start_string} [string]:start_string
1024 | {mid_string} [string]:mid_string
1025 | {end_string} [string]:end_string
1026 | {superstring} [exprs]:expr* annotations?
1027 | {par} opar expr cpar annotations?
1028 | {as_cast} expr kwas opar? type cpar?
1029 | {as_notnull} expr kwas opar? kwnot kwnull cpar?
1030 | {isset_attr} kwisset expr [id]:attrid
1031 | {debug_type} kwdebug kwtype expr type
1032 | {vararg} expr dotdotdot
1033 | {namedarg} id assign expr
1035 | {methid} expr [id]:methid
1037 | {many} [exprs]:expr*
1040 = {list} [exprs]:expr*
1041 | {par} opar [exprs]:expr* cpar
1042 | {bra} obra [exprs]:expr* cbra
1045 = {plus} [op]:pluseq
1046 | {minus}[op]:minuseq
1047 | {star} [op]:stareq
1048 | {slash} [op]:slasheq
1049 | {percent} [op]:percenteq
1050 | {starstar} [op]:starstareq
1051 | {pipe} [op]:pipeeq
1052 | {caret} [op]:careteq
1058 = [ids]:id* kwin expr
1061 module_name = quad? [path]:id* id;
1062 extern_calls = kwimport [extern_calls]:extern_call*
1066 | {local_prop} methid
1067 | {full_prop} type dot? methid
1069 | {cast_as} [from_type]:type dot? kwas [to_type]:type
1070 | {as_nullable} type kwas kwnullable
1071 | {as_not_nullable} type kwas kwnot kwnullable
1073 in_language = kwin string;
1074 extern_code_block = in_language? extern_code_segment;
1076 qualified = id* classid? ;
1080 annotations = kwis? at? opar? [items]:annotation* cpar? kwend?;
1082 annotation = doc? kwredef? visibility? atid opar? [args]:expr* cpar? annotations?;
1084 atid = {id} id | {kwextern} [id]:kwextern | {kwabstract} [id]:kwabstract | {kwimport} [id]:kwimport;
1086 /*****************************************************************************/