تمارين الدوال في Python تساعدك على تحويل مسألة طويلة إلى عمليات لها مدخلات ونواتج واضحة. سنحسب المضروب وعدد الحافلات، ونبني لوحة XO ونضع فيها علامة بعد الفحص. لكل دالة دور واحد بدل خلط الإدخال والطباعة والحساب في كتلة كبيرة. لا يتطلب المثال مكتبات خارجية أو واجهة رسومية، ويمكن استدعاء الدوال من اختبارات صغيرة قبل بناء برنامج يتفاعل مع المستخدم.
التجهيز والتشغيل
استخدم Python 3.9 أو أحدث واحفظ المثال في ملف مستقل خارج مجلد مكتبات Python.
python lesson_25598.pyحساب المضروب وحالة الصفر
تعيد factorial حاصل ضرب الأعداد من اثنين حتى العدد المطلوب، وتبدأ النتيجة بواحد. بهذه البداية يكون 0! و1! مساويين لواحد دون حلقة خاصة. نرفض الأعداد السالبة والقيم غير الصحيحة بدل إعطاء نتيجة توحي بأنها مضروب صالح. لا نسمّي الدالة sum أو pow لأن هذين الاسمين يستخدمان لدوال مدمجة، وحجبهما يجعل بقية المثال مربكًا. الأعداد الصحيحة كبيرة السعة لا تعني أن حساب مدخل ضخم مجاني زمنيًا.
قسمة للأعلى دون أعداد عشرية
إذا احتوت الحافلة خمسين مقعدًا، فإن 51 راكبًا يحتاج حافلتين لا واحدة. نستخدم (passengers + capacity – 1) // capacity للمدخلات الصحيحة غير السالبة. عند صفر ركاب تكون النتيجة صفرًا، بينما السعة يجب أن تكون موجبة حتى لا تحدث قسمة على صفر. اختيار السعة وسياسة عد الركاب جزء من تعريف المسألة، ولا تفترض أن كل أنواع النقل تتبع الرقم نفسه. جرب مضاعف السعة والعدد الذي يليه مباشرة.
المثال البرمجي الكامل
def factorial(number):
if type(number) is not int or number < 0:
raise ValueError("Use a non-negative integer")
result = 1
for value in range(2, number + 1):
result *= value
return result
def buses_needed(passengers, capacity=50):
if type(passengers) is not int or passengers < 0:
raise ValueError("Passengers must be a non-negative integer")
if type(capacity) is not int or capacity <= 0:
raise ValueError("Capacity must be a positive integer")
return (passengers + capacity - 1) // capacity
def empty_board():
return [["_" for _ in range(3)] for _ in range(3)]
def place_mark(board, row, column, mark):
if type(row) is not int or type(column) is not int or not (0 <= row < 3 and 0 <= column < 3):
raise ValueError("Row and column must be integers from 0 to 2")
if len(board) != 3 or any(len(line) != 3 for line in board):
raise ValueError("Board must be 3 by 3")
mark = mark.upper()
if mark not in {"X", "O"} or board[row][column] != "_":
raise ValueError("Invalid mark or occupied cell")
board[row][column] = mark
def render_board(board):
return "\n".join(" | ".join(row) for row in board)
if __name__ == "__main__":
print("0!:", factorial(0), "5!:", factorial(5))
print("Buses:", buses_needed(101))
board = empty_board()
place_mark(board, 0, 2, "x")
print(render_board(board))
لوحة بصفوف مستقلة
تنشئ empty_board ثلاث قوائم مستقلة، بدل ضرب قائمة صف واحد في ثلاثة ثم اكتشاف أن تعديل خلية يغير عدة صفوف. place_mark تتحقق من فهارس من صفر إلى اثنين، ومن شكل اللوحة والعلامة والخانة الفارغة. ترفض القيم السالبة رغم أن Python تسمح بالفهرسة السالبة، لأن عقد اللعبة لا يستخدمها. تتحول x إلى X قبل التخزين، وتبقى العلامات الأخرى مرفوضة.
دالة تعيد قيمة ودالة تعدل حالة
تعيد factorial وbuses_needed قيمًا دون تعديل بيانات المستدعي، بينما تعدل place_mark اللوحة المرسلة عمدًا. يجب أن يكون هذا الفرق واضحًا عند تصميم واجهة الدالة. أما render_board فتعيد نص العرض مع محارف أسطر جديدة، وتترك الطباعة إلى main. لا تتوقع أن كل دالة تعيد الكائن الذي عدلته؛ عندما لا توجد return صريحة تكون النتيجة None. اكتب اختبار الحالة قبل الاستدعاء وبعده لفهم الأثر.
ما الذي لا تنفذه لوحة التدريب؟
المثال يوضح وضع علامة وفحص الخلية فقط؛ لا يعلن فائزًا ولا يدير تبادل الأدوار أو يمنع اللاعب نفسه من الحركة مرتين. يمكن إضافة دالة فوز تقرأ الصفوف والأعمدة والقطرين بعد نجاح الأساس. لا تصف البرنامج بأنه لعبة كاملة ثم تترك شروط الفوز ضمن توقعات القارئ. عند توسيعه قرر هل ستعدل اللوحة أم تعيد نسخة جديدة، وحافظ على النهج نفسه عبر الدوال.
تشغيل وحالات حدية مهمة
عند التشغيل يظهر مضروب خمسة يساوي 120 وعدد حافلات 101 راكب يساوي ثلاثة. توضع X في الصف الأول والعمود الثالث فقط. اختبر مضروب صفر وسعة صفر ومدخلًا عشريًا وخانة مشغولة وفهرسًا خارج الحدود. جرّب طباعة صف آخر بعد التعديل لتتأكد من استقلال القوائم. هذه الاختبارات تكشف أخطاء لا تظهر عند تشغيل المثال مرة واحدة بمدخل صالح ومحدد سلفًا.
توسيع التمارين بطريقة منظمة
أضف دالة لجمع القيم الموجبة والسالبة في قائمة دون خلطها مع حساب المضروب، أو دالة تطبق قوة عدد بأس متغير مع اسم يوضح العملية. اكتب لكل إضافة المدخلات المقبولة وما يحدث عند الفراغ والقيم غير الصالحة. وإذا أضفت input فضع التحويل ومعالجة ValueError في طبقة التفاعل، ثم مرر قيمًا متحققًا منها للدوال. بهذا تبقى الاختبارات قابلة للتكرار ولا تحتاج كتابة الأرقام يدويًا في كل تشغيل.
المراجع
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.







