📚 بُنى المعطيات (Collections) في لغة نفطه

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

This file explains how to define and use basic data structures in Naftah language: lists, tuples, sets, and associative arrays. It also shows how to perform element-wise arithmetic and logical operations with practical examples. —

🗂️ جدول أنواع بُنى المعطيات

📋 تعريفات وأمثلة على بُنى المعطيات

1. قوائم (Lists)

ثابت درجات تعيين [٨٥، ٩٠، ٧٨، ٩٢]
ثابت أعداد_أولية تعيين [٢، ٣، ٥، ٧، ١١]
ثابت متداخلة تعيين [١٠، [٩، [٨، [٧، [٦، [٥، [٤، [٣، [٢، ١]]]]]]]]]

2. تركيبات (Tuples)

ثابت موقع تعيين (٣٢، ٤٥)
ثابت تاريخ_ميلاد تعيين (١٩٩٠، ٥، ٢٥)
ثابت زوج_متداخل تعيين (١٠، (٩، (٨، (٧، (٦، (٥، (٤، (٣، (٢، ١))))))))))

3. مجموعات (Sets)

ثابت عناصر_فريدة تعيين {١، ٢، ٣، ٤}
ثابت رموز تعيين {"أ"، "ب"، "ج"}

4. مصفوفات ترابطية (Associative Arrays)

ثابت الطالب تعيين {"اسم": "أحمد", "عمر": ٢٠, "معدل": ٨٨}
ثابت الإعدادات تعيين {"الوضع": "ليلي", "اللغة": "عربية"}
ثابت قائمة_طلاب تعيين [{"اسم": "ليلى", "عمر": ١٨}, {"اسم": "كريم", "عمر": ١٩}]
ثابت سجل تعيين {
    "الاسم": "سارة",
    "العناوين": ["المنزل", "العمل"],
    "الأرقام": (١٠٠١، ٢٠٠٢)
}

⚙️ العمليات الحسابية والمنطقية على بُنى المعطيات

العمليات بين قائمتين (عنصر بعنصر)

العمليات بصيغة النقطية (dot-notation)

[٨٥، ٩٠، ٧٨، ٩٢] .*. [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] .+. [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] .-. [٨٥، ٩٠، ٧٨، ٩٢]
حاول(
[٨٥، ٩٠، ٧٨، ٩٢] ./. [٨٥، ٩٠، ٧٨، ٩٢]
){
فشل(خ)-> إطبع(خ)
}
[٨٥، ٩٠، ٧٨، ٩٢] .%. [٨٥، ٩٠، ٧٨، ٩٢]

العمليات البتية بين قائمتين (للأعداد الصحيحة فقط)

[٨٥، ٩٠، ٧٨، ٩٢] بت_و [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] بت_أو [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] بت_أو_حصري [٨٥، ٩٠، ٧٨، ٩٢]

المقارنات بين قائمتين (عنصر بعنصر)

[٨٥، ٩٠، ٧٨، ٩٢] أصغر_من [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] أكبر_من [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] أصغر_أو_يساوي [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] أكبر_أو_يساوي [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] يساوي [٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢] لا_يساوي [٨٥، ٩٠، ٧٨، ٩٢]

العمليات بين رقم وقائمة (تُطبّق على كل عنصر في القائمة)

2 * [٨٥، ٩٠، ٧٨، ٩٢]
2 + [٨٥، ٩٠، ٧٨، ٩٢]
2 - [٨٥، ٩٠، ٧٨، ٩٢]
2 / [٨٥، ٩٠، ٧٨، ٩٢]
2 % [٨٥، ٩٠، ٧٨، ٩٢]

العمليات ++ و – (قبلية وبعدية) على القوائم

[٨٥، ٩٠، ٧٨، ٩٢]++
++[٨٥، ٩٠، ٧٨، ٩٢]
[٨٥، ٩٠، ٧٨، ٩٢]--
--[٨٥، ٩٠، ٧٨، ٩٢]

عملية النفي البتي

بت_ليس [٨٥، ٩٠، ٧٨، ٩٢]

🧾 الوصول إلى عناصر الوسائط (Arguments)

عند تنفيذ سكربت في نفطه، يتم تمرير الوسائط (arguments) كسلسلة من القيم من الخارج، ويُتاح الوصول إليها داخل السكربت عبر صف (tuple) اسمها وسائط و تحتوي على القيم المرسلة.

✅ الصيغة:

وسائط[n]        ← للوصول إلى العنصر رقم n من قائمة الوسائط

• وسائط ← قائمة جميع صفوف الوسائط.
• وسائط[n] ← الوسيط رقم n.

🧰 الاستخدام النموذجي في سكربت نفطه

--- التحقق مما إذا كانت هناك وسائط مدخلة
إذا عدد_الوسائط أكبر_من 0 إذن {

    --- طباعة عدد صفوف الوسائط
    إطبع(عدد_الوسائط)

    --- طباعة أول وسيط مدخل
    إطبع(وسائط[0])
}

--- بدء حلقة تكرار عبر جميع الوسائط
إذا عدد_الوسائط أكبر_من 0 إذن {
	كرر_حلقة أ تعيين 0 إلى عدد_الوسائط ناقص 1 إفعل {
		--- طباعة الوسيط الحالي
		ثابت ت تعيين وسائط[أ]
		إطبع("{{أ}}: {{ت}}")
	}
أنهي
}
غير_ذلك {
    إطبع("الوسائط فارغة")
}

🧠 ملاحظات مهمة

• يمكن تطبيق معظم العمليات السابقة على التركيبات، المجموعات، والمصفوفات الترابطية بنفس الطريقة.
• العمليات على البُنى المتداخلة تتم عنصرًا بعنصر مع الحفاظ على نوع كل عنصر.
• العمليات البتية تقتصر على الأعداد الصحيحة فقط.