نظرة عامة على القواعد
يستخدم رمل قواعد ANTLR 4 مع محلل لغوي مخصص حساس للإزاحة. تصف هذه الصفحة البنية العامة لقواعد اللغة.
نظرة عامة
كل برنامج رمل هو سلسلة من التعليمات:
program → statement* EOF
تبدأ البرامج عادةً التنفيذ عند الوسم :start:، رغم أنه يمكن استهداف أي وسم بواسطة jump.
أنواع التعليمات في لمحة
| الفئة | التعليمات | الوصف |
|---|---|---|
| البنية | وسم القسم، القفز | الوسوم (:name:) ونقل التحكم |
| الإعلانات | النوع (كائن)، الدالة، الطريقة، المتغير | تعريف الأنواع، الدوال، الطرائق، المتغيرات |
| تدفق التحكم | if/orif/else, while, switch/switchloop, try/catch/end | الشرطيات، الحلقات، التفرع، معالجة الأخطاء |
| الحلقات | break, continue | التحكم في الحلقات |
| التعبيرات | الإسناد، الثلاثي، استدعاء طريقة، استدعاء دالة، طباعة | الحساب والإخراج |
| عمليات الحقول | إسناد متعدد الحقول، التحقق من نطاق الحقول | التعامل مع حقول الكائنات |
الكلمات المفتاحية
| الفئة | الكلمات المفتاحية |
|---|---|
| تدفق التحكم | if, orif, else, while, break, continue |
| التفرع | switch, switchloop, case, default |
| معالجة الأخطاء | try, catch, end |
| القفز | jump |
| الأنواع | bs |
| الدوال | functions, in |
| الإدخال/الإخراج | print |
جميع الكلمات المفتاحية محجوزة ولا يمكن استخدامها كمُعرّفات. يمكن توطين جميع الكلمات المفتاحية عبر ملفات keywords.raml.lang.
الكتل والإزاحة
تُعرَّف الكتل بالإزاحة:
block → INDENT statement+ DEDENT
- نقطتان
:يتبعهما سطر جديد وإزاحة أكبر تبدأ كتلة. - إزاحة أقل تنهي الكتلة الحالية.
- الفواصل المنقوطة
;اختيارية ومفيدة بشكل أساسي للتعليمات أحادية السطر.
تفاصيل تقنية
يغطي هذا القسم تفاصيل تنفيذ القواعد — المحلل المعجمي، بنية المحلل، معالجة الرموز، والأساس المنطقي للتصميم.
مستويات التعبيرات
يملك رمل ثلاثة مستويات متداخلة من التعبيرات، كل منها يسمح بمجموعة مختلفة م ن المعاملات. يمنع هذا التصميم المتدرج غموض التحليل في معاملات استدعاءات الطرائق.
المستوى 1: expr (تعبيرات كاملة)
قاعدة التعبير العليا. تتضمن جميع المعاملات:
- الحسابية، البتية، الإزاحة
- المقارنات (
==,!=,<,>,<=,>=,=#=) - المنطقية (
&&,||) - استدعاءات الطرائق (
->recv:method) والدوال وسلاسل الوصول - الزيادة/النقصان البادئة، عنوان، NOT بتية
- التجميع بعلامتي قولون (
::expr::)
تُستخدم في: الإسنادات، الشروط، حلقات while، شروط الثلاثي، التعبيرات المستقلة.
المستوى 2: exprItem (عناصر التعبير)
مثل expr لكن مُهيكل كعناصر ضم ن تعبيرات أكبر. يتضمن المقارنات والمعاملات المنطقية.
تُستخدم في: تعليمات الطباعة، قوائم تعبيرات الأنبوب.
المستوى 3: simpleExprItem (تعبيرات مقيدة)
مجموعة فرعية مقيدة تستبعد معاملات المقارنة والمنطق:
- مسموح: القيم، المتغيرات، سلاسل الوصول، الحسابية، البتية، الإزاحة، التجميع بعلامتي قولون، معاملات البادئة/اللاحقة
- مستبعد:
==,!=,<,>,<=,>=,=#=,&&,||
تُستخدم في: معاملات استدعاءات الطرائق والدوال، معاملات make.
لماذا هذا القيد؟ بدونه، ستُمتص المعاملات في قوائم المعاملات. مثلاً b:get move != 0 قد تُحلل كـ board_get(&b, move != 0) بدلاً من (board_get(&b, move)) != 0. انظر ملاحظات التصميم للسبب الكامل.