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

الدوال المدمجة والإدخال/الإخراج

يوفر رمل مجموعة صغيرة من الكلمات المفتاحية والدوال المدمجة للإدخال/الإخراج، عمليات السلاسل، والرياضيات.


نظرة عامة​

يغطي هذا القسم الدوال المدمجة بنظرة سريعة — ما يكفي لاستخدامها في البرامج.

مرجع سريع​

المدمجالفئةنوع الإرجاعالوصف
keyboardإدخال/إخراجbs_tقراءة سطر من stdin
printإدخال/إخراج—عرض قيم على stdout
saveإدخال/إخراج—كتابة تدفق بتات إلى ملف
loadإدخال/إخراجbs_tقراءة تدفق بتات من ملف
lenسلسلةuint32_tطول تدفق البتات بالبتات
absرياضياتuint32_tالقيمة المطلقة
minرياضياتuint32_tأصغر قيمتين
maxرياضياتuint32_tأكبر قيمتين
powرياضياتuint32_tدالة الأس
makeذاكرةكائنتخصيص كائن
freeذاكرة—تحرير ذاكرة الكومة

أنماط شائعة​

:start:
name = keyboard
print "hello" name
data = "hello world"
save "output.bin" data
loaded = load "output.bin"
l = len loaded
m = max 3 7
p = pow 2 8

مرجع تفصيلي​

كلمات الإدخال/الإخراج المفتاحية​

keyboard​

يقرأ سطراً من الإدخال القياسي ويُرجعه كـ bs_t (تدفق بتات):

:start:
input = keyboard
print "لقد كتبت" input

القيمة المُرجعة هي تدفق بتات يحتوي على بيانات السلسلة المدخلة.

print​

يُخرج قيماً إلى الخرج القياسي. العناصر مفصولة بمسافات ويُضاف سطر جديد:

print "hello" 42 "world"
// الإخراج: hello 42 world

يمكن لـ print أيضاً إخراج محتوى الكائنات باستدعاء طريقة الطباعة الضمنية للكائن:

counter:
value
functions:
prints:
print "counter" value

:start:
c = make counter 5
print c // يستدعي counter_prints(&c)

save​

يكتب تدفق بتات إلى ملف:

data = "hello world"
save "output.bin" data

يتم استخراج سلسلة المسار من الحقل .data لتدفق البتات.

load​

يقرأ تدفق بتات من ملف ويُرجعه:

data = load "input.bin"
print "تم التحميل" data

يُرجع bs_t. يتم استخراج المسار من الحقل .data لتدفق البتات.

الدوال المدمجة​

len expr​

يُرجع طول تدفق البتات بالبتات:

bs s = "hello"
l = len s // l = 40 (5 بايتات * 8 بتات)

abs x​

يُرجع القيمة المطلقة:

a = abs (0 - 42) // a = 42

min a b / max a b / pow base exp​

m = min 3 7 // m = 3
m = max 3 7 // m = 7
p = pow 2 8 // p = 256

التحويل التلقائي للنوع​

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

:start:
move = keyboard // move هو bs_t
b:set move player // move يُحول إلى uint32_t

يتم هذا التحويل عبر raml_bs_to_uint32() في كود C المُولَّد.

المُستبعدون من التحويل (يتوقعون معاملات bs_t مباشرة):

المدمجالسبب
loadيتوقع مسار سلسلة عبر .data
lenيعمل على خاصية .len لتدفق البتات
printيُخرج محتوى تدفق البتات مباشرة

تفاصيل تقنية متقدمة​

يغطي هذا القسم تنفيذ وقت التشغيل، تفاصيل تحويل الأنواع الداخلية، والحالات الحدية.

تنفيذ وقت التشغيل​

تُعيّن الدوال المدمجة إلى دوال وقت تشغيل C. التوقيعات الرئيسية:

typedef struct {
uint8_t* data; // مؤشر للبايتات الخام
size_t len; // الطول بالبايتات
} bs_t;

bs_t raml_keyboard(void);
void raml_print_bs(bs_t s);
void raml_print_int(uint64_t n);
void raml_save(bs_t path, bs_t data);
bs_t raml_load(bs_t path);
bs_t raml_make_bs(const char* s);
bs_t raml_bs_concat(bs_t a, bs_t b);
uint32_t raml_bs_to_uint32(bs_t bs);
size_t raml_bs_length(bs_t bs);
uint64_t raml_abs(int64_t x);
uint64_t raml_min(uint64_t a, uint64_t b);
uint64_t raml_max(uint64_t a, uint64_t b);
uint64_t raml_pow(uint64_t base, uint64_t exp);
void* raml_alloc(size_t size);
void raml_free(void* ptr);

توليد كود print​

تُترجم تعليمة print إلى سلسلة من استدعاءات طباعة منوعة. كل وسيط يُولّد استدعاء مناسباً لنوعه:

print "loop" i

يُولّد:

raml_print_bs(_string_0); // "loop" كـ bs_t
raml_print_int(i); // متغير صحيح

الطباعة عبر الكائنات: عند استخدام print obj على كائن، يستدعي مولد الكود طريقة prints الخاصة بالكائن (يجب أن تكون موجودة). التوقيع: void obj_prints(struct obj_t* self).

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

عند تمرير bs_t إلى دالة تتوقع نوعاً عددياً، يلفّه مولد الكود بـ raml_bs_to_uint32():

// Raml: b:set move player
// C: board_set(&b, raml_bs_to_uint32(move), player);

تحوّله الدالة من سلسلة رقمية:

uint32_t raml_bs_to_uint32(bs_t bs) {
if (!bs.data || bs.len == 0) return 0;
char* buf = malloc(bs.len + 1);
memcpy(buf, bs.data, bs.len);
buf[bs.len] = '\0';
uint32_t result = (uint32_t)atol(buf);
free(buf);
return result;
}

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

الكلمات المفتاحية للدوال المدمجة قابلة للتوطين عبر ملفات keywords.raml.lang:

الإنجليزيةالعربية
printاطبع
keyboardلوحة_المفاتيح
saveاحفظ
loadحمل
lenطول
makeاصنع
freeاحذف

التوطين هو استبدال على مستوى المحلل المعجمي — المحلل لا يرى الأسماء المُترجَمة أبداً.

الحالات الحدية​

  • keyboard عند EOF: يُرجع تدفق بتات فارغاً (data=NULL, len=0). يجب على البرامج التحقق من len قبل استخدام النتيجة.
  • save ببيانات فارغة: يكتب ملفاً بحجم صفر بايت.
  • load من ملف غير موجود: يُسبب خطأ وقت التنفيذ (fopen يُرجع NULL).
  • len على bs غير مُهيّأ: يُرجع 0 (حقل .len مُهيّأ بصفر).
  • abs من أصغر int64: abs(-9223372036854775808) يلف (لا يوجد مقابل موجب لأصغر int64 سالب) — متسق مع سلوك C.
  • تحويل تلقائي على سلاسل غير رقمية: raml_bs_to_uint32("hello") يُرجع 0 (atol يُرجع 0 على إدخال غير رقمي).