الجمل في Python، indentation و التعليقات

في هذا المقال، ستتعرف على تعليمات بايثون وأهمية التباعد وكيفية استخدام التعليقات في البرمجة.

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

تعليمات يمكن تنفيذها من قبل معالج بايثون تسمى تعليمات. على سبيل المثال، a = 1 هي تعليمة تعيين. تعليمات مثل if، for، while هي أنواع أخرى من التعليمات، وسنناقشها لاحقًا.

تعليمات متعددة السطور

في بايثون، يتم استخدام علامة النهاية للتعليمات بالسطر. ولكن يمكننا توسيع التعليمات إلى سطور متعددة تحتوي على سطور متتابعة من الأحرف (\). على سبيل المثال:

a = 1 + 2 + 3 + \

　　　　4 + 5 + 6 + \

　　　　7 + 8 + 9

هذا هو التمديد الموضح للسطور. في بايثون، يتم إجراء التمديد في البارtheses ()، brackets [] و braces {} تلقائيًا.

a = (1 + 2 + 3 +
　　　　4 + 5 + 6 +
　　　　7 + 8 + 9)

في هذا السياق، يتم إجراء التمديد في البارtheses () تلقائيًا عبر السطور. نفس الشئ بالنسبة للـ [] و {} أيضًا. على سبيل المثال:

colors = ['red',
　　　　　　　　　　'blue',
　　　　　　　　　　'green'

يمكننا أيضًا استخدام نقاط السطر لوضع عدة تعليمات في سطر واحد، مثلما هو موضح أدناه

a = 1; b = 2; c = 3

التباعد في بايثون

معظم لغات البرمجة (مثل C، C ++، Java) تستخدم الكواشف {} لتعريف كتل الكود.بينما يستخدم بايثون التباعد).

كتلة الكود (الكود في الدالةالجسمفي الدوراتتبدأ الجسم (مثل الدوال والقوائم) بالتباعد وتنتهي ببداية السطر غير المتباعد. يعتمد تباعد الكود علىك، ولكن يجب أن يكون التباعد متساويًا داخل الكتلة.

عادةً ما يتم استخدام أربعة مسافات للتباعد، ويتم التفضيل للواحدات على الأشرطة.

يحقق التنسيق في بايثون نظافة الكود. مما يؤدي إلى برنامج بايثون يبدو مشابهًا ومتناسقًا.

التباين يمكن تجاهله في السطور المتتابعة. من الجيد دائمًا التباعد. إنه يجعل الكود أكثر وضوحًا. على سبيل المثال:

if True:
　　　　print('Hello')
　　　　a = 5

و

if True: print('Hello'); a = 5

كلاهما صالحان ويقومان بنفس الشيء. ولكن النمط الأول أكثر وضوحًا.

التنسق غير الصحيح يؤدي إلى خطأ IndentationError.

تعليقات بلاك بيري

التعليقات مهمة جدًا عند كتابة البرامج. إنها توضح ما يحدث داخل البرنامج، مما يجعل من السهل على من يرى الكود فهمه. قد تنسى تفاصيل مهمة للغاية لكود كتبته قبل شهر. لذلك، دائمًا ما يكون من الجيد تفسير هذه المفاهيم بتعليقات.

نستخدم علامة الـ # لنبدأ في كتابة التعليقات في بلاك بيري.

يتمدد إلى ماركة النهاية. التعليقات مخصصة للبرمجيين لتسهيل فهم البرنامج. يغيب المترجم بلاك بيري التعليقات.　

# هذا هو تعليق
# طباعة إخراج Hello
print('Hello')

تعليقات متعددة الأسطر

إذا كان لدينا تعليق متعدد الأسطر، فإن طريقة واحدة هي استخدام علامة البداية في بداية كل سطر. على سبيل المثال:

# هذا هو تعليق طويل
# يمدد
# إلى الأسطر المتعددة

يمكنك أيضًا استخدام ثلاثة تكرارات، ''' أو """.

تستخدم هذه الثلاثة تكرارات عادةً لنصوص متعددة الأسطر. ولكن يمكن أيضًا استخدامها كتعليقات متعددة الأسطر. إلا إذا كانت ليست تعليقات وثائقية، فإنها لن تولد أي كود إضافي.

"""هذا أيضًا هو
مثال مثالي
تعليقات متعددة الأسطر """

التعريف الوثائقي في بلاك بيري

التعريف الوثائقي هو اختصار للتعريف الوثائقي.

إنهالنص،يظهر كأول جملة في تعريف النموذج،وظيفة،فئة أو طريقة. يجب علينا كتابة وظيفة/فئة في التعريف الوثائقي.

استخدم ثلاثة تكرارات للنصوص عند كتابة التعريف الوثائقي. على سبيل المثال:

def double(num):
　　　　"""وظيفة ضاعفة القيمة"""
　　　　العودة 2*num

التعريف الوثائقي كـ __doc__ الخاص بوظيفة يمكننا استخدامه. بعد تشغيل البرنامج أعلاه، في الشل قم بإرسال التالي.　　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　 　

def double(num):
　　　　"""وظيفة ضاعفة القيمة"""
　　　　العودة 2*num
print(double.__doc__)

الإخراج:

وظيفة ضاعفة القيمة