إنتقل إلى المحتوى الرئيسي

ملاحظات التصميم

صُمم رمل حول التحكم الصريح والدقيق في البيانات على مستوى البت، مع الحد الأدنى من طبقات التجريد. توثق هذه الصفحة الأساس المنطقي وراء قرارات التصميم الرئيسية.


المبادئ الأساسية​

أنواع مبنية على البتات​

جميع الأنواع القياسية تستخدم نوع bs (تدفق بتات)، الذي يوفر تخزيناً بعرض متغير مع تحويل تلقائي للأعداد الصحيحة. هذا يبسط نظام الأنواع مع الحفاظ على المرونة لبرمجة الأنظمة.

صياغة مبنية على الإزاحة​

تُعرَّف الكتل بالإزاحة بدلاً من الأقواس المعقوفة. هذا يزيل الضوضاء البصرية ويفرض تنسيقاً متسقاً.

إدارة يدوية للذاكرة​

لا يوجد جامع قمامة. make و @ و # و free تمنح تحكماً مباشراً في التخصيص والتحرير.

صياغة مفصولة بمسافات​

يتجنب رمل الأقواس والفواصل والأقواس المعقوفة لاستدعاءات الدوال. المعاملات دائماً مفصولة بمسافات:

len s // ليس len(s)
min a b // ليس min(a, b)
c = make counter 0 // ليس make(counter, 0)

هذا التصميم يزيل غموض التحليل ويبقي القواعد بسيطة.


تصميم مستويات التعبيرات​

يستخدم رمل ثلاثة مستويات من التعبيرات لحل غموض تحليلي أساسي.

المشكلة​

بدون قيود، يمكن لمعاملات استدعاءات الطرائق أن تمتص المعاملات التالية:

b:get move != 0

يمكن تحليلها كـ:

  1. (board_get(&b, move)) != 0 — مقارنة قيمة الإرجاع (المقصود)
  2. board_get(&b, (move != 0)) — تمرير المقارنة كمعامل (غير مقصود)

الحل: ثلاثة مستويات​

المستوىالقاعدةمقارنات؟تُستخدم في
كاملexprنعمالإسنادات، الشروط، while، تعبيرات مستقلة
عناصرexprItemنعمتعليمات الطباعة، تعبيرات الأنبوب
مقيدsimpleExprItemلامعاملات استدعاءات الطرائق/الدوال

الحل البديل​

احسب المقارنة أولاً، أو استخدم تجميع :::

is_occupied = b:get move != 0
if is_occupied:
print "مشغول"
if ::b:get move != 0:::
print "مشغول"

تعريف رسمي​

تشكل المستويات الثلاثة تسلسلاً هرمياً صارماً حيث يوفر doubleColonExpr (::expr::) مخرج هروب للمقارنات داخل التعبيرات المقيدة.


Switch مقابل Switchloop​

switch هو تفرع لمرة واحدة: بمجرد تطابق حالة وتنفيذها، يغادر التحكم كتلة switch.

switchloop يلف switch داخل حلقة do { } while(0)، مما يتيح لـ continue إعادة تقييم شرط switch.

فرق توليد الكود:

البناءمخرج C
switchswitch (expr) { case N: ... break; }
switchloopdo { switch (expr) { case N: ... continue; } } while(0)

التحويل التلقائي لتدفقات البتات​

نوع bs ديناميكي ويحتوي بيانات متغيرة الطول. عند تمريره كمعامل لطرائق أو دوال تتوقع أنواعاً عددية ثابتة، يتم تحويله تلقائياً إلى uint32_t عبر raml_bs_to_uint32().

منطق التحويل:

bs_t → هل هذا مدمج يتوقع bs؟ (load, len, print)
→ نعم: مرر bs_t مباشرة
→ لا: لف بـ raml_bs_to_uint32(bs)

المُستبعدون: load, len, print.


توطين الكلمات المفتاحية​

يدعم رمل الكلمات المفتاحية غير الإنجليزية عبر ملفات keywords.raml.lang.

تفاصيل تقنية: كيف يعمل التوطين​

  1. اكتشاف الملف: يبحث المفسّر عن keywords.raml.lang في دليل الملف المصدر، ثم يتنقل للأعلى في الأدلة الأصلية حتى يجده.
  2. تحليل ملف التعيين: كل سطر 'english_keyword' | 'localized_keyword' يُعرّف تعييناً ثنائي الاتجاه.
  3. تحويل المصدر: قبل تشغيل المحلل المعجمي ANTLR، تُستبدل جميع تكرارات الكلمات المفتاحية المُترجمة في المصدر بمكافئاتها الإنجليزية.
  4. المحلل يرى الإنجليزية: القواعد والمحلل دون تغيير — فقط إدخال المحلل المعجمي هو المُعدّل.

هذا التصميم يعني:

  • لا حاجة لتغييرات في القواعد للغات جديدة
  • يمكن كتابة نفس ملف .rml بأي لغة مدعومة
  • المصادر متعددة اللغات ممكنة (وإن لم تكن مستحسنة)
  • رسائل الخطأ والتمثيلات الداخلية تستخدم الكلمات المفتاحية الإنجليزية دائماً

لماذا المعاملات المفصولة بمسافات؟​

  1. قواعد أبسط: لا حاجة لتمييز f(a, b) من f (a, b).
  2. لا غموض مع التجميع: يمكن حجز الأقواس للتجميع الصريح مستقبلاً.
  3. متسق مع بقية الصياغة: الإسناد متعدد الحقول :f1 f2 f3: وقوائم التحرير free n1 n2 n3 كلها تستخدم النمط نفسه.
  4. الإزاحة كتجميع: قوائم المعاملات متعددة الأسطر تستخدم الإزاحة (عبر صياغة الأنبوب |)، وليس الأقواس.

تخطيط ذاكرة الكائنات​

الكائنات (الهياكل) في رمل تُعيّن مباشرة إلى structs في C:

counter:
value
functions:
inc:
in: step
value += step

تصبح:

typedef struct { uint32_t value; } counter_t;
void counter_inc(counter_t* self, uint32_t step) {
self->value += step;
}

قرارات التصميم الرئيسية:

  • مؤشر self ضمني — دائماً المعامل الأول في دوال C المُولَّدة.
  • الطرائق التي لا تُغيّر الحالة تستقبل const counter_t* self.
  • الوصول للحقول دائماً عبر الهيكل.
  • ترتيب الهيكل يتبع قواعد ABI في C لأقصى توافق.

وراثة التصميم من C​

المفهومرملC
عنوان@x&x
فك إشارة*p*p
حساب مؤشراتp += np += n
وصول هيكل (مباشر)obj:fieldobj.field
وصول هيكل (مؤشر)ptr:fieldptr->field
تخصيص كومةmake T args automalloc + init
تحريرfree pfree(p)