برمجة Lua: الصيغ الأساسية للطلاب في الإمارات العربية المتحدة | ORBITECH

ORBITECH AI Academy

الجداول (Tables)

الجداول هي بنية البيانات الأساسية في Lua، تشبه القوائم في بايثون أو المصفوفات في جافا سكريبت. تُستخدم لتخزين البيانات المنظمة مثل الأسعار أو المواقع أو النتائج.

بناء الجدول (Constructor) definition

local t = {key1 = value1, key2 = value2, ...}

Formes alternatives

$l o c a l < < v a r : t > > = < < v a r : v a l u e 1 > >, < < v a r : v a l u e 2 > >, . . .$ — جدول ذو مفاتيح رقمية متسلسلة بدءًا من 1

Symbole	Signification	Unité
`t`	اسم الجدول يجب أن يكون اسمًا صالحًا في Lua (بدء بحرف أو شرطة سفلية)
`key1`	المفتاح الأول يمكن أن يكون نصيًا أو رقميًا
`value1`	القيمة الأولى أي نوع بيانات صالح في Lua

Exemple : في أبو ظبي، قم بإنشاء جدول لحفظ أسعار المنتجات في سوق الذهب: local gold_prices = {twenty_four_k = 245.5, eighteen_k = 187.3, fourteen_k = 132.8} → gol $d_{p} r i c e s$ .twent $y_{f} o u r$ _k = 245.5 درهم للغرام

الوصول إلى عناصر الجدول (الترميز النقطي) definition

t.key

Formes alternatives

$< < v a r : t > > [< < v a r : k e y > >]$ — الترميز باستخدام الأقواس المربعة، مفيد للمفاتيح التي تحتوي على مسافات أو أرقام

Symbole	Signification	Unité
`t`	اسم الجدول يجب أن يكون الجدول قد تم تعريفه مسبقًا
`key`	المفتاح يجب أن يكون المفتاح موجودًا في الجدول

Exemple : استخراج سعر الذهب عيار 24: local price = gold_prices.twenty_four_k → 245.5 درهم للغرام

إضافة عنصر جديد إلى الجدول definition

t[new_key] = new_value

Symbole	Signification	Unité
`t`	اسم الجدول الجدول الذي تريد تعديله
$n e w_{k} e y$	المفتاح الجديد يمكن أن يكون نصيًا أو رقميًا
$n e w_{v} a l u e$	القيمة الجديدة أي نوع بيانات صالح

Exemple : إضافة سعر الذهب عيار 10: gold_prices.ten_k = 98.7 → gol $d_{p} r i c e s$ .te $n_{k}$ = 98.7 درهم للغرام

التر遍历 الجدول باستخدام pairs() definition

for key, value in pairs(t) do ... end

Symbole	Signification	Unité
`key`	المفتاح الحالي يتم تحديثه تلقائيًا في كل تكرار
`value`	القيمة الحالية القيمة المرتبطة بالمفتاح
`t`	الجدول المراد تكراره يجب أن يكون جدولاً صالحاً

Exemple : طباعة جميع أسعار الذهب: for type, price in pairs(gold_prices) do print(type .. ': ' .. price .. ' درهم/غرام') end

الدوال (Functions)

الدوال هي اللبنات الأساسية في Lua. تسمح بتجميع الكود وإعادة استخدامه. يمكن تعريفها بعدة طرق.

تعريف دالة باسم definition

function name(args) ... end

Symbole	Signification	Unité
`name`	اسم الدالة يجب أن يكون اسمًا صالحًا في Lua
`args`	المعاملات قائمة المعاملات مفصولة بفواصل (اختياري)

Exemple : دالة لحساب سعر الذهب بناءً على الوزن: function calculate_gold_price(weight) return weight * gold_prices.twenty_four_k end

تعريف دالة مجهولة (Anonymous) definition

f = function(args) ... end

Symbole	Signification	Unité
`f`	اسم المتغير الذي يحمل الدالة يمكن تمريره كوسيط لدوال أخرى
`args`	المعاملات قائمة المعاملات مفصولة بفواصل (اختياري)

Exemple : دالة لحساب السعر مع الخصم: local apply_discount = function(price, discount) return price * (1 - discount/100) end

استدعاء دالة definition

name(args)

Symbole	Signification	Unité
`name`	اسم الدالة يجب أن تكون الدالة قد تم تعريفها مسبقًا
`args`	المعاملات قائمة القيم مفصولة بفواصل

Exemple : استخدام الدالة لحساب سعر 10 غرامات ذهب: local total = calculate_gold_price(10) → 2455 درهم

هياكل التحكم (Control Structures)

تتحكم هياكل التحكم في تسلسل تنفيذ الكود في Lua. تشمل الشروط والحلقات.

الشرط if-elseif-else definition

if condition1 then ... elseif condition2 then ... else ... end

Symbole	Signification	Unité
`condition1`	الشروط الأولى يجب أن تكون تعبيرًا منطقيًا (boolean)
`condition2`	الشروط الثانية اختياري

Exemple : التحقق من سعر الذهب قبل الشراء: if gold_prices.twenty_four_k < 250 then print('اشترِ!') else print('انتظر') end

الحلقة التكرارية for (محددة النطاق) definition

for i = start, end, step do ... end

Symbole	Signification	Unité
`i`	متغير العد يتم تحديثه تلقائيًا
`start`	القيمة الابتدائية يجب أن تكون عددًا
`end`	القيمة النهائية يجب أن تكون عددًا
`step`	الخطوة اختياري، القيمة الافتراضية 1

Exemple : طباعة جدول الضرب للعدد 5: for i = 1, 10 do print(i .. ' × 5 = ' .. i*5) end

الحلقة التكرارية while definition

while condition do ... end

Symbole	Signification	Unité
`condition`	الشروط يجب أن تكون تعبيرًا منطقيًا (boolean)

Exemple : الانتظار حتى ينخفض سعر الذهب: while gold_prices.twenty_four_k > 240 do os.execute('sleep 60') end

السلاسل النصية (Strings)

توفر Lua مجموعة غنية من الدوال للتعامل مع السلاسل النصية، وهي أساسية لمعالجة البيانات النصية.

طول السلسلة definition

len = string.len(s)

Formes alternatives

<<var:len>> = #<<var:s>> ParseError: Expected 'EOF', got '#' at position 15: <<var:len>> = #̲<<var:s>> — الطريقة المختصرة للحصول على طول السلسلة

Symbole	Signification	Unité
`len`	الطول عدد الأحرف في السلسلة
`s`	السلسلة النصية يجب أن تكون سلسلة نصية صالحة

Exemple : حساب طول اسم المنتج: local product_name = 'هاتف ذكي' → #product_name = 8 أحرف

استخراج جزء من السلسلة definition

sub = string.sub(s, i, j)

Symbole	Signification	Unité
`sub`	الجزء المستخرج سلسلة نصية جزئية
`s`	السلسلة الأصلية يجب أن تكون سلسلة نصية صالحة
`i`	البداية الرقم الأول (1-based)
`j`	النهاية الرقم الأخير (اختياري، إذا لم يذكر، إلى النهاية)

Exemple : استخراج الكود البريدي من عنوان في دبي: local address = 'دبي، شارع الشيخ زايد، 12345' → string.sub(address, -5) = '12345'

البحث في السلسلة باستخدام النمط definition

match = string.match(s, pattern)

Symbole	Signification	Unité
`match`	الجزء المطابق الجزء الذي تطابق النمط
`s`	السلسلة الأصلية يجب أن تكون سلسلة نصية صالحة
`pattern`	النمط نمط البحث (مثل '%d+' للبحث عن أرقام)

Exemple : استخراج السعر من نص: local text = 'السعر: 250 درهم' → string.match(text, '%d+') = '250'

الملفات (File I/O)

تسمح Lua بقراءة وكتابة الملفات، وهو أمر أساسي لحفظ البيانات أو معالجة الملفات الخارجية.

فتح ملف definition

file = io.open(filename, mode)

Symbole	Signification	Unité
`file`	الكائن الملف يتم استخدامه لقراءة/كتابة الملف
`filename`	اسم الملف مسار الملف (مثل 'data.txt')
`mode`	الوضع 'r' للقراءة، 'w' للكتابة، 'a' للإلحاق

Exemple : فتح ملف لحفظ بيانات الذهب: local file = io.open('gold_prices.txt', 'w')

قراءة محتوى ملف definition

content = file:read('*a')

Formes alternatives

$< < v a r : l i n e > > = < < v a r : f i l e > > : r e a d ()$ — قراءة سطر واحد (بدون '*a')

Symbole	Signification	Unité
`content`	المحتوى المقروء جميع محتوى الملف
`file`	الكائن الملف يجب أن يكون مفتوحًا للقراءة

Exemple : قراءة جميع البيانات من ملف الذهب: local data = file:read('*a')

كتابة إلى ملف definition

file:write(data)

Symbole	Signification	Unité
`file`	الكائن الملف يجب أن يكون مفتوحًا للكتابة
`data`	البيانات المكتوبة أي سلسلة نصية

Exemple : كتابة سعر الذهب إلى ملف: file:write('24K: 245.5\n')

إغلاق الملف definition

file:close()

Symbole	Signification	Unité
`file`	الكائن الملف يجب أن يكون مفتوحًا

Exemple : إغلاق ملف الذهب بعد الكتابة: file:close()

الجداول الفوقية (Metatables)

الجداول الفوقية تسمح بتعديل سلوك الجداول في Lua، مثل تعريف سلوك الجمع أو الوصول إلى المفاتيح الغير موجودة.

تعريف جدول فوقي definition

mt = {}

Symbole	Signification	Unité
`mt`	الجدول الفوقي يتم استخدامه لتعريف السلوكيات الفوقية

Exemple : إنشاء جدول فوقي للجمع التلقائي: local mt = {}

ربط جدول فوقي بجدول definition

setmetatable(t, mt)

Symbole	Signification	Unité
`t`	الجدول المراد تعديله الجدول الذي تريد إضافة سلوك فوقي له
`mt`	الجدول الفوقي الجدول الفوقي الذي يحتوي على السلوكيات

Exemple : ربط الجدول الفوقي بجدول الذهب: setmetatable(gold_prices, mt)

__index: الوصول إلى المفاتيح الغير موجودة definition

mt.__index = function(t, key) ... end

Symbole	Signification	Unité
`t`	الجدول الجدول الذي تم الوصول إليه
`key`	المفتاح المفتاح الذي لم يوجد

Exemple : عند الوصول إلى مفتاح غير موجود، إرجاع سعر افتراضي: mt.__index = function(t, key) return 0 end

الجداول (Tables)

الدوال (Functions)

هياكل التحكم (Control Structures)

السلاسل النصية (Strings)

الملفات (File I/O)

الجداول الفوقية (Metatables)

المصادر