مكتبة system — النظام والبيئة

مكتبة النظام توفر دوال للتفاعل مع نظام التشغيل والبيئة المحيطة. تشمل قراءة وتعيين متغيرات البيئة، إدارة المجلدات، معرفة معلومات المنصة، تنفيذ أوامر النظام، ودوال الوقت.

# دوال النظام متوفرة مباشرة بدون استيراد
اطبع_سطر("المنصة: " + المنصة())
اطبع_سطر("المجلد الحالي: " + المجلد_الحالي())
اطبع_سطر("الوقت: " + لنص(الطابع_الزمني()))

ملخص الدوال

متغيرات البيئة

الدالة	الوصف
احصل_بيئة(اسم)	قراءة متغير بيئة
عيّن_بيئة(اسم، قيمة)	تعيين متغير بيئة
متغير_بيئة(اسم)	قراءة متغير بيئة (بديل)

المجلدات

الدالة	الوصف
المجلد_الحالي()	المجلد الحالي
غيّر_مجلد(مسار)	تغيير المجلد

معلومات المنصة

الدالة	الوصف
المنصة()	اسم المنصة
نظام()	اسم نظام التشغيل

الوقت

الدالة	الوصف
الطابع_الزمني()	الوقت الحالي (Unix timestamp)
وقت_الساعة()	وقت الساعة بدقة عالية
الآن()	الوقت الحالي
الآن_مللي()	الوقت بالمللي ثانية

تنفيذ الأوامر

الدالة	الوصف
نفّذ(أمر)	تنفيذ أمر نظام
تنفيذ(أمر)	تنفيذ أمر (بديل)

---

متغيرات البيئة

احصل_بيئة(اسم) — قراءة متغير بيئة

تقرأ قيمة متغير بيئة من نظام التشغيل. تُرجع القيمة كنص، أو لاشيء إذا لم يكن المتغير موجوداً.

# قراءة مسار الـ PATH
متغير المسار = احصل_بيئة("PATH")
إذا (المسار != لاشيء)
    اطبع_سطر("PATH: " + المسار)
وإلا
    اطبع_سطر("المتغير غير موجود")
نهاية

# قراءة اسم المستخدم
متغير المستخدم = احصل_بيئة("USERNAME")
اطبع_سطر("المستخدم: " + المستخدم)

عيّن_بيئة(اسم، قيمة) — تعيين متغير بيئة

تُعيّن قيمة متغير بيئة للعملية الحالية وعملياتها الفرعية.

# تعيين متغير بيئة للتطبيق
عيّن_بيئة("APP_MODE"، "production")
عيّن_بيئة("APP_LANG"، "ar")

اطبع_سطر("الوضع: " + احصل_بيئة("APP_MODE"))

---

إدارة المجلدات

المجلد_الحالي() — المجلد الحالي

تُرجع المسار الكامل للمجلد الذي يعمل منه البرنامج حالياً.

متغير المجلد = المجلد_الحالي()
اطبع_سطر("المجلد الحالي: " + المجلد)

غيّر_مجلد(مسار) — تغيير المجلد

تُغيّر المجلد الحالي للعملية إلى المسار المحدد.

اطبع_سطر("قبل: " + المجلد_الحالي())
غيّر_مجلد("/home/user/مشاريع")
اطبع_سطر("بعد: " + المجلد_الحالي())

---

معلومات المنصة

المنصة() — اسم المنصة

تُرجع اسم المنصة التي يعمل عليها البرنامج. القيم الممكنة: "windows", "linux", "macos".

متغير م = المنصة()
اطبع_سطر("المنصة: " + م)

إذا (م == "windows")
    اطبع_سطر("أنت على نظام ويندوز")
وإلا
    اطبع_سطر("أنت على نظام " + م)
نهاية

نظام() — اسم نظام التشغيل

تُرجع معلومات أكثر تفصيلاً عن نظام التشغيل.

اطبع_سطر("نظام التشغيل: " + نظام())

---

دوال الوقت

الطابع_الزمني() — Unix Timestamp

تُرجع الطابع الزمني الحالي (عدد الثواني منذ 1 يناير 1970). مفيد لقياس المدة الزمنية وتسجيل الأحداث.

# قياس وقت تنفيذ عملية
متغير البداية = الطابع_الزمني()

# عملية ما...
متغير مجموع = 0
لكل ر في نطاق(1، 100000)
    مجموع = مجموع + ر
نهاية

متغير النهاية = الطابع_الزمني()
اطبع_سطر("المدة: " + لنص(النهاية - البداية) + " ثانية")

وقت_الساعة() — وقت دقيق

تُرجع الوقت بدقة عالية (بالثواني مع كسور عشرية). مناسب لقياس أداء الكود بدقة.

متغير ق1 = وقت_الساعة()

# كود يُراد قياس سرعته
متغير نتيجة = 0
لكل ر في نطاق(1، 10000)
    نتيجة = نتيجة + (ر * ر)
نهاية

متغير ق2 = وقت_الساعة()
اطبع_سطر("الوقت: " + لنص(ق2 - ق1) + " ثانية")

الآن() / الآن_مللي() — الوقت الحالي

الآن() تُرجع الوقت الحالي بالثواني، و الآن_مللي() تُرجعه بالمللي ثانية لدقة أعلى.

اطبع_سطر("الوقت بالثواني: " + لنص(الآن()))
اطبع_سطر("الوقت بالمللي ثانية: " + لنص(الآن_مللي()))

---

تنفيذ الأوامر

نفّذ(أمر) — تنفيذ أمر نظام

تُنفّذ أمر نظام وتُرجع ناتجه كنص. مفيد لتشغيل أوامر shell أو برامج خارجية.

# عرض محتويات المجلد الحالي
متغير الناتج = نفّذ("dir")
اطبع_سطر(الناتج)

---

دوال الوقت والتاريخ المتقدمة

دوال مكونات التاريخ

تتوفر دوال لاستخراج مكونات التاريخ والوقت:

# مكونات التاريخ
اطبع_سطر("السنة: " + لنص(سنة()))
اطبع_سطر("الشهر: " + لنص(شهر()))
اطبع_سطر("اليوم: " + لنص(يوم()))
اطبع_سطر("يوم الأسبوع: " + لنص(يوم_الأسبوع()))
اطبع_سطر("الساعة: " + لنص(ساعة()))
اطبع_سطر("الدقيقة: " + لنص(دقيقة()))
اطبع_سطر("الثانية: " + لنص(ثانية()))

صيغة_تاريخ(صيغة) — تنسيق التاريخ

تُرجع التاريخ والوقت الحالي بالصيغة المحددة.

متغير التاريخ = صيغة_تاريخ("%Y-%m-%d %H:%M:%S")
اطبع_سطر("التاريخ الميلادي: " + التاريخ)

---

مثال شامل

# تقرير حالة النظام
اطبع_سطر("╔══════════════════════════════╗")
اطبع_سطر("║    تقرير حالة النظام         ║")
اطبع_سطر("╚══════════════════════════════╝")
اطبع_سطر("")

# معلومات المنصة
اطبع_سطر("🖥️  المنصة: " + المنصة())
اطبع_سطر("📂 المجلد الحالي: " + المجلد_الحالي())
اطبع_سطر("👤 المستخدم: " + احصل_بيئة("USERNAME"))
اطبع_سطر("")

# معلومات الوقت
اطبع_سطر("⏱️  الطابع الزمني: " + لنص(الطابع_الزمني()))
اطبع_سطر("📅 التاريخ: " + صيغة_تاريخ("%Y-%m-%d"))
اطبع_سطر("🕐 الوقت: " + صيغة_تاريخ("%H:%M:%S"))
اطبع_سطر("")

# قياس أداء
متغير بداية = وقت_الساعة()
متغير مجموع = 0
لكل ع في نطاق(1، 100000)
    مجموع = مجموع + ع
نهاية
متغير نهاية = وقت_الساعة()

اطبع_سطر("📊 اختبار الأداء:")
اطبع_سطر("   مجموع 1-100000 = " + لنص(مجموع))
اطبع_سطر("   الوقت: " + لنص(نهاية - بداية) + " ثانية")