مرجع القواعد
مرجع قواعد ANTLR الكامل لـ رمل، مُنظم حسب الفئة. المصدر: source/Raml.g4.
نظرة عامة
تحتوي هذه الصفحة على قواعد ANTLR الكاملة بشكلها الخام. يعرض كل قسم قواعد المحلل والمحلل المعجمي الكاملة لميزة لغة معينة.
كيفية قراءة صياغة ANTLR:
| الترميز | المعنى |
|---|---|
rule : ... ; | تعريف قاعدة محلل |
TOKEN : ... ; | تعريف رمز محلل معجمي |
| | بديل (أو) |
? | اختياري (0 أو 1) |
* | صفر أو أكثر |
+ | واحد أو أكثر |
{ ... }? | مسند دلالي (شرط وقت التشغيل) |
-> skip | تخطي الرمز في المحلل المعجمي |
للحصول على نظرة عامة عالية المستوى لبنية القواعد، انظر نظرة عامة على القواعد.
البرنامج والتعليمات
program
: statement* EOF
;
statement
: sectionLabel
| jumpStmt
| typeDecl
| functionDecl
| methodDecl
| methodCallStmt
| printStmt
| assignment
| varDecl
| functionCallStmt
| ifStmt
| switchStmt
| whileStmt
| tryFailStmt
| breakStmt
| continueStmt
| ternaryStmt
| paramDecl
| rangeFieldCheck
| expr
| SEMI
;
وسوم الأقسام والقفز
sectionLabel
: ':' labelName ':' block? # sectionDecl
;
jumpStmt
: JUMP ':' labelName ':' # jumpSection
;
labelName
: ID INTEGER?
;
الوسوم تكتب كـ :name: ويمكن أن تتضمن رقماً اختيارياً (مثل :phase1:). jump ينقل التحكم إلى وسم.
إعلانات الكائنات
typeDecl
: ID COLON structBlock # structDecl
;
structBlock
: INDENT structItemOrSemi+ DEDENT
;
structItemOrSemi
: structItem
| SEMI
;
structItem
: fieldDecl
| functionsBlock
;
الكائنات تُعرّف بـ name: متبوعة بكتلة مُزاحة من الحقول وقسم functions:.
إعلانات الحقول
fieldDecl
: fieldSpec fieldSpec* NL? # fieldDeclList
;
fieldSpec
: typeSpec nameList # fieldTypeGroup
| ID typeSpec # fieldNameTyped
| ID COLON typeSpec # fieldNameColon
| ID COLON indentedNestedStruct # fieldNestedIndented
| ID COLON inlineNestedStruct # fieldNestedInline
;
nameList
: ID ID*
;
typeSpec
: bsType
| ID // named type reference (bs, struct names, etc.)
| typeSpec '#'
;
الحقول تدعم أنماط إعلان متعددة:
- مجموعة:
flags code - مُنوعة النوع:
flags bs - بنقطتين:
flags: bs - كائن متداخل (مزاح):
meta:\n flags - كائن متداخل (مضمن):
meta: flags code
الكائنات المتداخلة
indentedNestedStruct
: INDENT nestedFieldOrSemi+ DEDENT
;
nestedFieldOrSemi
: nestedField
| SEMI
;
nestedField
: fieldDecl
;
inlineNestedStruct
: fieldDecl fieldDecl* NL?
;
أنواع البتات
bsType
: BS
;
الدوال والطرائق
functionDecl
: ID COLON functionBlock # functionDefinition
;
functionBlock
: INDENT paramDecl statement* DEDENT
;
methodDecl
: typeName=ID COLON methodName COLON block # methodDefinition
;
methodName
: ID
;
paramDecl
: IN COLON paramSpecList?
;
paramSpecList
: paramSpec paramSpec*
;
paramSpec
: bsType ID
| ID
;
الدوال تُعرّف ضمن كتلة functions: للكائن:
functionItem
: methodName # functionDeclOnly
| methodName COLON block # functionDefBlock
| methodName COLON inlineStatement # functionDefInline
;
functionItemOrSemi
: functionItem
| SEMI
;
functionsBlock
: FUNCTIONS COLON INDENT functionItemOrSemi+ DEDENT
;
التعليمات المضمنة (أجسام دوال أحادية السطر):
inlineStatement
: assignment
| methodCallStmt
| functionCallStmt
| printStmt
| expr
;
المتغيرات والإسنادات
varDecl
: typeSpec nameList ASSIGN expr # varDeclTypedLeading
| typeSpec nameList # varDeclTypedNoInit
| ID COLON typeSpec ASSIGN expr # varDeclTyped
| ID COLON typeSpec # varDeclTypedNoInitColon
| ID COLON expr # varDeclInferred
;
assignment
: accessChain ASSIGN expr # assignNormal
| accessChain ADDR_ASSIGN expr # assignADDR
| accessChain compoundOp expr # assignCompound
| COLON nameList COLON ASSIGN expr # assignMultiField
;
compoundOp
: '+=' | '-=' | '*=' | '/=' | '%='
| '&=' | '|=' | '^=' | '<<=' | '>>='
| '+#=' // bit increment
;
الوصول الديناميكي للحقول
primaryAccess
: ID # primaryAccessId
| ID COLON INTEGER COLON # dynamicFieldAccess
| ID COLON simpleExprItem COLON { self._input.LA(1) != self.ID and self._input.LA(1) != self.COLON }? # dynamicFieldAccessExpr
| ADDR accessChain # primaryAccessAddr
;
الوصول الديناميكي للحقول يسمح بالوصول إلى حقل كائن أو متغير عام يُحدد اسمه أثناء التنفيذ:
c:1:— فهرس حرفي، يحل إلى الحقلc1c:idx:— فهرس تعبيري، يحلidxإلى اسم حقل مثلc1،c2، إلخ.- يُستخدم في سلاسل الوصول:
c:idx: += 1
المسند على dynamicFieldAccessExpr يمنع الغموض مع الوصول النمطي c:next:.
التحقق من نطاق الحقول
rangeFieldCheck
: ID COLON expr DOTDOT expr COLON cmpOp expr COLON block
;
cmpOp
: '<' | '>' | '<=' | '>=' | '==' | '!='
;
DOTDOT
: '..'
;
يتحقق التحقق من نطاق الحقول من نطاق من الحقول المرقمة ويُولِّد شروطاً مسلسلة بـ ||:
c:1..9: == 0:— يتحقق مما إذا كان أي منc1إلىc9يساوي 0- يدعم جميع معاملات المقارنة عبر
cmpOp
تدفق التحكم
If / Orif / Else
ifStmt
: IF expr COLON block (ORIF expr COLON block)* (ELSE COLON block)? # ifWithBlock
;
Switch / Switchloop
switchStmt
: SWITCH expr COLON switchBlock # switchWithBlock
| SWITCHLOOP expr COLON switchBlock # switchLoopWithBlock
;
switchBlock
: INDENT switchClause+ DEDENT
;
switchClause
: caseClause
| defaultClause
;
caseClause
: CASE? expr COLON block
;
defaultClause
: DEFAULT COLON block
;
breakStmt
: BREAK
;
continueStmt
: CONTINUE
;
While
whileStmt
: WHILE expr COLON block
;
ثلاثي
ternaryStmt
: expr '?' inlineStatement ':' inlineStatement
;
Try / Catch / End
tryFailStmt
: TRY COLON block (FAIL | CATCH) COLON block (END COLON block)?
;