وحدات المصدر والاستيراد والتصدير

المضيف وصيغة الاستيراد

هذا عقد وحدات المصدر الأصلية في لبات 0.7.0. ثبّت الأدوات الأصلية أولا. ملفات المتصفح الافتراضية بيانات تشغيل ولا توفر محمّل وحدات مصدر، حتى إذا انتهت أسماؤها بـ.aspl أو .لبات. للمكتبات المورّدة مثل core::http وcore::raylib وcore::c دعم أصلي خاص، وهي منفصلة عن ملفات المستخدم ومكتبات C المشتركة.

مقطع توضيحي

import helpers.aspl as lib;
استورد services/معالجات.لبات بسم خدمة.

استخدم import / استورد ومسارا نسبيا ينتهي بـ.aspl أو .لبات، مع نطاق أسماء اختياري باستخدام as / بسم. المسارات أوصاف غير محاطة بعلامات اقتباس. اهرب المسافة باستخدام \ . يُرفض مسار الاستيراد المطلق. يبدأ الحل من مجلد الملف المستورِد، بما فيه الاستيرادات المتداخلة، وليس مجلد عمل العملية. دون اسم بديل يجب أن يكون اسم الملف بلا امتداد معرّف نطاق صالحا. استخدم اسما بديلا لملف مثل my-file.aspl.

يقبل لبات 0.7.0 \ي{...} مع \u{...} داخل مسارات الاستيراد، بأبجديات الأرقام وحدود القيم العددية نفسها في محارف هروب النصوص. ترفض مسارات الاستيراد U+0000. تبقى تهجئات المسافات وعلامات ترقيم ASCII المهربة كما هي؛ لا تقبل المسارات محارف الهروب النصية القصيرة مثل \n و\س. تحتفظ ملفات الإصدار المنشور 0.6.0 بصيغة هروب المسارات الأصلية.

نطاقات الأسماء والتصدير

استخدم lib::answer() لاستدعاء تعريف مصدّر من استيراد مباشر. لا ينفذ الاستيراد شفرة ولا يدمج التعريفات في المستورِد ولا يتيح نطاقات الاستيرادات غير المباشرة. يجوز لوحدات مختلفة استخدام الاسم الخاص نفسه. تشير الاستيرادات المتكررة للملف الفعلي نفسه إلى هويات الدوال والسجلات نفسها، حتى عبر أسماء بديلة مختلفة. يعرّف ملفان مختلفان سجلين مختلفين اسميا ولو تطابق اسماهما.

الدوال والسجلات والتعريفات الأجنبية خاصة افتراضيا. ضع share / شارك قبل التعريف المصدّر. تحتفظ أسماء المستخدم المصدّرة بكتابتها ولا تكتسب أسماء عربية وإنجليزية بديلة. يظل الاستدعاء الأجنبي المصدّر بحاجة إلى علامة unsafe الصريحة. لا يجوز للتواقيع المصدّرة وحقول السجلات كشف أنواع خاصة، حتى داخل أنواع الاستدعاء أو القوائم أو النتائج المتداخلة. صدّر السجل المطلوب أيضا أو غيّر التوقيع العام.

مقطع توضيحي

شارك دالة جواب() -> ص64 { أرجع 42. }
شارك سجل رد { قيمة: ص64 }

يُرفض share import بسبب shared-import، فلا يوجد إعادة تصدير. استورد مباشرة كل نطاق تستخدم اسمه. راجع فشل التعريف الخاص وبرنامج الوحدات المصحح.

المدخل وقيود شبكة الاستيراد

يعرّف ملف المصدر الجذري وحده start_main / ابدأ_الرئيسية بلا معاملات وبحالة عملية من نوع i64. يجب ألا تعرّف الملفات المستوردة مدخلا، ويرفضها imported-entry. لا يجوز تصدير مدخل الجذر، ويرفض ذلك shared-entry. لا يمكن استدعاء أسماء المدخل أو تخزينها كقيم قابلة للاستدعاء.

تفشل الدورات بسبب import-cycle، وتصادمات النطاقات بسبب namespace-collision، والملفات الغائبة بسبب missing-file. الحد الأصلي 1024 وحدة مصدر، وأطول سلسلة استيراد 256 وصلة. يُفحص كل تعريف مستورد، بما فيه المساعد غير المستخدم، فلا يخفي استيراد الملف أخطاء أنواعه.

الفحص والتشغيل والبناء

احتفظ بالمدخل وكل ملفات المصدر المعلنة وفق ترتيب المسارات النسبي الموثق. لا يحتاج هذا المثال إلى ملف بيانات:

aspl check الرئيسية.لبات
aspl run الرئيسية.لبات
aspl build -o module-program الرئيسية.لبات
./module-program

يطبع مثال الوحدات 42 ثم LF ويعيد 0. يتضمن البرنامج الأصلي المبني البرنامج المفحوص والآلة الافتراضية، ويعمل بعد إزالة ملفات مصدره. قد يظل محتاجا إلى مكتبات مشتركة أو ملفات بيانات يستخدمها أثناء التشغيل.

اقرأ الدليل العملي وإتاحة القيم القابلة للاستدعاء ومراحل أوامر Linux ومجموعة البرامج الكاملة.