🔑 الكلمات المفتاحية في لغة نفطه (Naftah Keywords)

هذا الملف يوثّق جميع الكلمات المفتاحية (Keywords) المدعومة في لغة نفطه، بما في ذلك مرادفاتها المختلفة، كما تم تعريفها في ملف الـ lexer. تُستخدم هذه الكلمات لتحديد البُنى الأساسية في اللغة، مثل الحلقات، الشروط، التعاريف، وغيرها.

The file documents all the keywords supported by the Naftah language, including their synonyms, as defined in the lexer.

📥 الاستيراد (Imports)

الكلمة	المرادفات	الوظيفة
`استيراد`	`جلب`, `إجلب`	إدراج وحدة أو ملف خارجي لاستخدام محتوياته داخل البرنامج
`تحت_إسم`	`مثل`	إعطاء اسم بديل للوحدة أو العنصر المستورد لتسهيل استخدامه

📦 القيم والثوابت (Constants & Literals)

الكلمة	المرادفات	الوظيفة
`صحيح`	`صحيح`, `صائب`, `حقيقي`	قيمة منطقية تعبّر عن حالة الصواب (Boolean true)
`خطأ`	`خطأ`, `خاطئ`, `زائف`	قيمة منطقية تعبّر عن حالة الخطأ (Boolean false)
`ليس_رقم`	`ليس_رقم`, `قيمة_غير_رقمية`, `رقم_غير_صالح`, `غير_عددي`, `ليس_عددي`	قيمة خاصة تشير إلى نتيجة حسابية غير صالحة أو غير عددية (NaN)

🧱 التعاريف (Declarations)

الكلمة	المرادفات	الوظيفة
`ثابت`	-	تعريف قيمة ثابتة لا يمكن تغييرها بعد إنشائها
`متغير`	-	تعريف قيمة يمكن تعديلها أثناء تنفيذ البرنامج
`دالة`	-	تعريف وحدة تنفيذية تحتوي على تعليمات قابلة لإعادة الاستخدام
`عدم`	`فراغ`, `بطلان`, `خلاء`	تحديد أن الدالة لا تُرجع أي قيمة
`فارغ`	`باطل`, `لاشيء`	تمثيل غياب القيمة أو عدم وجود كائن
`أي_نوع`	`أي_نمط`	نوع عام يقبل أي قيمة دون تقييد بنوع محدد

⚖️ التحكم الشرطي والمنطقي (Conditional & Logical)

الكلمة	المرادفات	الوظيفة
`إذا`	`إذا_كان`, `اذا`, `اذا_كان`	تنفيذ كتلة برمجية عند تحقق شرط معين
`غير_ذلك_إذا`	`غير_ذلك_إذا_كان`, `غير_ذلك_اذا_كان`, `غير_ذلك_اذا`	اختبار شرط إضافي عند فشل الشرط السابق
`غير_ذلك`	-	تنفيذ كتلة بديلة عند عدم تحقق أي شرط
`إذن`	`اذن`	تحديد بداية التنفيذ بعد تحقق الشرط
`و`	`ايضا`, `أيضا`	عامل منطقي يُرجع true إذا تحققت جميع الشروط
`أو`	`او`, `وإلا`, `والا`, `ولا`	عامل منطقي يُرجع true إذا تحقق أحد الشروط
`ليس`	-	نفي القيمة المنطقية وتحويل true إلى false والعكس

🔁 التحكم في الحلقات (Loop Control)

الكلمة	المرادفات	الوظيفة
`كرر`	-	تنفيذ مجموعة تعليمات بشكل متكرر
`كرر_حلقة`	-	حلقة تكرار بعدد محدد أو نطاق معين
`إفعل`	`افعل`	بدء حلقة تُنفّذ مرة واحدة على الأقل
`بينما`	-	تكرار التنفيذ طالما تحقق شرط معين
`حتى`	-	تحديد شرط التوقف عن التكرار
`كسر`	`اكسر`, `إكسر`	إيقاف الحلقة فورًا والخروج منها
`تابع`	-	تخطي التكرار الحالي والانتقال للتالي
`إلى`	-	تحديد الحد الأعلى لقيم التكرار
`تنازليا`	-	تنفيذ التكرار باتجاه تنازلي
`خطوة`	-	تحديد مقدار الزيادة أو النقصان في كل دورة

🧪 التعبيرات والبناء (Expressions & Flow)

الكلمة	المرادفات	الوظيفة
`من`	`ضمن`, `من_بين`, `داخل`	المرور على عناصر مجموعة أو نطاق
`اختر`	-	تنفيذ أحد الفروع بناءً على قيمة محددة
`من بين`	`حسب`, `لـ`, `وفقا_لـ`	تحديد فرع مطابق داخل جملة الاختيار
`ارجع`	`أرجع`, `اعد`, `أعد`	إنهاء الدالة وإرجاع قيمة إلى المستدعي
`أنهي`	`انهي`, `نهاية`	إنهاء كتلة برمجية أو نطاق تنفيذي
`مثيل_من`	-	التحقق مما إذا كانت القيمة تنتمي إلى نوع معين
`نوع`	-	إرجاع نوع القيمة أثناء وقت التنفيذ
`حجم`	-	حساب حجم أو عدد عناصر قيمة أو بنية بيانات

➕➖ العمليات (Operators)

حسابية

الرمز	المرادفات	الوظيفة
`+`	`زائد`	جمع القيم أو دمجها
`-`	`ناقص`	طرح قيمة من أخرى
`*`	`ضارب`	ضرب القيم
`/`	`قسمة`	قسمة القيم
`%`	`باقي`	حساب باقي القسمة
`**`	`رفع`	رفع قيمة لقوة أخرى

إسناد ومقارنة

الرمز	المرادفات	الوظيفة
`=`	`تعيين`	إسناد قيمة لمتغير
`==`	`يساوي`	مقارنة قيمتين للتحقق من التساوي
`=!`	`لا_يساوي`	التحقق من عدم التساوي
`<`	`أصغر_من`	مقارنة لمعرفة الأصغر
`>`	`أكبر_من`	مقارنة لمعرفة الأكبر
`=>`	`أصغر_أو_يساوي`	أصغر من أو يساوي
`>=`	`أكبر_أو_يساوي`	أكبر من أو يساوي

منطقية بتية (Bitwise)

الرمز	المرادفات	الوظيفة
`~`	`بت_ليس`	نفي البتات
`&`	`بت_و`, `بت_ايضا`, `بت_أيضا`	عملية AND بتية
`\\|`	`بت_أو`, `بت_او`, `بت_وإلا`, `بت_والا`, `بت_ولا`	عملية OR بتية
`^`	`بت_أو_حصري`, `بت_او_حصري`, `بت_وإلا_حصري`, `بت_والا_حصري`, `بت_ولا_حصري`	عملية XOR بتية

إزاحة (Shift)

الرمز	المرادفات	الوظيفة
`<<`	`إزاحة_يسار`	إزاحة البتات إلى اليسار
`>>`	`إزاحة_يمين`	إزاحة البتات إلى اليمين مع الحفاظ على الإشارة
`>>>`	`إزاحة_يمين_غير_موقعة`	إزاحة البتات إلى اليمين دون إشارة

عنصر-بعنصر (Element-wise)

الرمز	المرادفات	الوظيفة
`.+.`	-	تطبيق الجمع على العناصر المقابلة
`.-.`	-	تطبيق الطرح على العناصر المقابلة
`.*.`	-	تطبيق الضرب على العناصر المقابلة
`./.`	-	تطبيق القسمة على العناصر المقابلة
`.%.'`	-	تطبيق باقي القسمة على العناصر المقابلة

⚡ التزامن (Concurrency)

الكلمة	المرادفات	الوظيفة
`غير_متزامن`	-	تعريف دالة تُنفّذ بشكل غير متزامن
`تشغيل`	-	تشغيل مهمة غير متزامنة فورًا
`انتظار`	-	إيقاف التنفيذ مؤقتًا حتى انتهاء المهمة
`نطاق`	-	إنشاء سياق تنفيذي محلي
`قناة`	-	إرسال واستقبال البيانات بين المهام
`ممثل`	-	كيان مستقل يعالج الرسائل ويحتفظ بحالة

🧩 المعالجة والاستثناءات (Error Handling)

الكلمة	المرادفات	الوظيفة
`حاول`	-	بدء كتلة مراقبة الأخطاء
`نجاح`	-	تنفيذ التعليمات عند نجاح العملية
`فشل`	-	تنفيذ التعليمات عند حدوث خطأ

🧠 الاختيارية (Optional)

الكلمة	المرادفات	الوظيفة
`بعض`	-	تمثيل وجود قيمة صالحة
`معدوم`	-	تمثيل غياب القيمة

🧩 السلوك والتنفيذ (Implementations)

الكلمة	المرادفات	الوظيفة
`سلوك`	-	تعريف كتلة سلوك (Implementation) مرتبطة بكائن مُعرّف مسبقًا
`هذا`	`ذات`	مرجع إلى الكائن الحالي داخل كتلة السلوك (مشابه لـ `self` في Rust و `this` في Java)

⏳ الزمن (Temporal)

الكلمة	المرادفات	الوظيفة
`زمن`	`نقطة_زمنية`	تمثيل لحظة زمنية محددة (Temporal Point)
`مقدار_زمني`	`قيمة_زمنية`	تمثيل مدة زمنية أو مقدار معين من الزمن (Temporal Amount)
`الآن`	-	اللحظة الحالية
`ساعة`	`ساعات`	وحدة زمنية للساعات
`دقيقة`	`دقائق`	وحدة زمنية للدقائق
`ثانية`	`ثواني`, `ثوان`	وحدة زمنية للثواني
`نانوثانية`	`نانوثواني`, `نانوثوان`	وحدة زمنية دقيقة جدًا
`يوم`	`أيام`	وحدة زمنية للأيام
`شهر`	`أشهر`	وحدة زمنية للأشهر
`سنة`	`سنوات`	وحدة زمنية للسنوات
`تاريخ`	-	تحديد تاريخ معين
`وقت`	-	تحديد وقت معين
`تاريخ و وقت`	-	تحديد التاريخ والوقت معًا
`مدة`	-	بادئة لتعريف مدة زمنية
`فترة`	-	بادئة لتعريف فترة زمنية
`بين`	`ما بين`	تحديد نطاق زمني بين نقطتين زمنيتين (Temporal Range)
`بتوقيت`	-	بادئة لتحديد المنطقة الزمنية
`بالتقويم`	-	بادئة لتحديد نوع التقويم (ميلادي / هجري)
`ص`	`صباحاً`, `صباحا`	مؤشر صباحي (AM)
`م`	`مساءً`, `مساءا`	مؤشر مسائي (PM)

🧠 ملاحظات

يمكن استخدام أي من المرادفات المدرجة لكل كلمة مفتاحية داخل كود نفطه.
هذا يدعم مرونة لغوية واستيعاب المستخدمين من خلفيات لغوية مختلفة.
بعض الكلمات مثل ارجع يمكن أن تظهر في أكثر من سياق (دالة، شرط، قوالب نصية).

## 📁 ملفات مرتبطة * [Home - الرئيسية](./../../../README.md) * [🧱 الأنواع الأولية و الثوابت و المتغيرات - Primitive Types And Variables](./02_primitives_and_variables.md) * [📚 بُنى المعطيات - Collections](./03_collections.md) * [🧮 التعبيرات - Expressions](./04_expressions.md) * [🔢 الأعداد بأنظمة العد - Radix Numbers](./05_radix_numbers.md) * [📦 تعريف الكائنات - Objects](./06_objects.md) * [🌀 التحكم في تدفق البرنامج - Control Flow](./07_control_flow.md) * [⚙️ الدوال في لغة نفطه - Functions](./08_functions.md) * [⚙️ التوافق مع Java (Java Interop) في لغة نفطه - Java Interop](./09_java_interop.md) * [⚡ التعامل مع التزامن في نفطه – Concurrency](./10_concurrency.md) * [⏱️ الزمن والنقاط الزمنية في نفطه – Temporal](./11_temporal.md) ---