فهم جمل بايثون، المسافات البادئة، والتعليقات

يوفر هذا البرنامج التعليمي فهمًا أساسيًا لتعليمات بايثون، والمسافات البادئة، والتعليقات – وهي عناصر بالغة الأهمية لكتابة شفرة نظيفة وفعالة وقابلة للصيانة.

محتويات الجدول

1. تعليمات بايثون
2. مسافات بايثون البادئة
3. تعليقات بايثون

تعليمات بايثون

في بايثون، تعتبر التعليمات عبارة عن تعليمة مفردة ينفذها المُفسّر. بينما تشغل عادةً سطرًا واحدًا، يمكن أن تمتد التعليمات الطويلة عبر أسطر متعددة باستخدام متابعة السطر (شرطة مائلة عكسية أو أقواس ()). تشمل التعليمات التعيينات، وعمليات استدعاء الدوال، والحلقات، والتعليمات الشرطية.

أمثلة:

• التعيين: x = 10 (يعين 10 إلى x)
• استدعاء الدالة: print("Hello!")
• التعليمات الشرطية:

  
  if x > 5:
      print("x أكبر من 5")
  else:
      print("x ليس أكبر من 5")
  

• تعليمة الحلقة:

  
  for i in range(5):
      print(i)
  

مسافات بايثون البادئة

على عكس اللغات التي تستخدم الأقواس المجعدة {} لتحديد كتل الشفرة، تستخدم بايثون المسافات البادئة. وهذا يحدد تجميع التعليمات داخل الكتل (if، else، for، while، الدوال، الفئات). تعتبر المسافات البادئة المتسقة إلزامية؛ حيث تسبب عدم الاتساقات IndentationError.

مسافات بادئة صحيحة:

if x > 5:
    print("x أكبر من 5")
    y = x * 2
else:
    print("x ليس أكبر من 5")

مسافات بادئة غير صحيحة:

if x > 5:
print("x أكبر من 5")  # IndentationError
y = x * 2
else:
print("x ليس أكبر من 5") # IndentationError

استخدم 4 مسافات للمسافات البادئة؛ وتجنب علامات التبويب.

تعليقات بايثون

الـتعليقات هي ملاحظات توضيحية يتجاهلها المُفسّر. وهي تعزز قابلية قراءة الشفرة وفهمها. تقدم بايثون نوعين:

• تعليقات سطر واحد: تبدأ بـ #. أي شيء بعد # على نفس السطر هو تعليق.
• تعليقات متعددة الأسطر (سلاسل الوثائق): محاطة بعلامات اقتباس ثلاثية (''' أو """). تُستخدم بشكل متكرر لتوثيق الدوال، والفئات، والوحدات.

أمثلة:

x = 10  # تعليق سطر واحد

'''
هذا تعليق
متعدد الأسطر.
'''

def my_function():
    """هذا سلسلة وثائق."""
    pass

يُعد التعليق الفعال أمرًا بالغ الأهمية للشفرة النظيفة والقابلّة للصيانة. حافظ على التعليقات موجزة وذات صلة؛ وتجنب التفسيرات الزائدة عن الحاجة.