تعلم Python 3 المتوسط/

...

/

كتابة الكود الأول الخاص بنا

كتابة الكود الأول الخاص بنا

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

سنغطي ما يلي...

لنبدأ بالأشياء الممتعة من خلال الغوص مباشرة في الكود.

الprint() وظيفة

عند تعلم أي لغة برمجة جديدة، من المعتاد البدء بعرض النص "مرحبًا بالعالم!" على الشاشة. لكل لغة قواعدها النحوية الخاصة لإخراج المعلومات أو طباعتها. تُسهّل Python، المعروفة بسهولة قراءتها، هذه المهمة باستخدامprint() وظيفة.

وهنا كيفprint() تعمل الوظيفة في Python:

Press + to interact
print("Data to be printed")

يتم تضمين جميع المحتويات المراد طباعتها داخل الأقواس التي تليprint الآن، لنحاول طباعة "Hello World" في المحطة الطرفية.

Press + to interact
Python 3.10.4
print("Hello World")

ومن المهم أن نلاحظ أن النصHello World يتم وضعه بين علامتي اقتباس لأنه يمثل سلسلة ، وهي عبارة عن تسلسل من الأحرف.

بعد ذلك، سنطبع بعض الأرقام. كل استدعاء لـprint سيتم نقل إخراج إلى سطر جديد.

Press + to interact
Python 3.10.4
print(50)
print(1000)
print(3.142)

هل لاحظت أننا لم نضع الأرقام بين علامتي اقتباس؟ لو فعلنا ذلك، لعاملها المترجم كسلاسل نصية. سيتضح الفرق بينهما أكثر عند مناقشة أنواع البيانات.

طباعة قطع متعددة من البيانات

يمكننا طباعة عناصر متعددة في واحدةprint يمكنك كتابة الأوامر ببساطة عن طريق فصلها بفاصلات.

Press + to interact
Print statement
Print statement

جربها بنفسك

حاول إصلاح الكود التالي وتشغيله بنجاح. يمكن لمرشد الذكاء الاصطناعي لدينا إرشادك أيضًا.

Press + to interact
Python 3.10.4
print(50, 1000, 3.142 "Hello World"

افتراضيا، كلprint تطبع العبارة النص في سطر جديد. إذا أردنا عدةprint إذا أردنا طباعة عبارات في نفس السطر، فيمكننا استخدام الكود التالي:

Press + to interact
Python 3.10.4
print("Hello", end="")
print("World")
print("Hello", end=" ")
print("World")
print("Hello", end=", ")
print("World")

قيمةend تمت إضافته إلى إخراج، والتاليprint وسوف يستمر البيان من تلك النقطة.

تعليقات

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

أفضل الممارسات لكتابة التعليقات:

  • يجب أن تكون التعليقات دقيقة وواضحة ومختصرة وذات معنى - وتشرح وظيفة الكود بطريقة يسهل فهمها.

  • قد يختلف مستوى التفاصيل في التعليقات اعتمادًا على تعقيد الكود - بدءًا من سطر واحد للكود الأكثر بساطة إلى تفسيرات أكثر تفصيلاً للخوارزميات المعقدة.

  • حافظ على نمط وتنسيق متسقين لتعليقاتك في قاعدة التعليمات البرمجية لتحسين قابلية القراءة.

يمكن كتابة تعليق باستخدام# في Python، توضح أداة الكود التالية كيفية كتابة تعليقات سطر واحد. لاحظ أن كل سطر من التعليقات يجب أن يبدأ بـ# شخصية.

Press + to interact
Python 3.10.4
print(50)  # This line prints 50
print("Hello World")  # This line prints Hello World
# This is just a comment hanging out on its own!
# For multi-line comments, we must
# add the hashtag symbol
# each time

كبديل لهذه التعليقات متعددة الأسطر، تُعدّ سلاسل التوثيق (docstrings) اختصارًا لسلاسل التوثيق. وهي محاطة بعلامتي اقتباس ثلاثيتين.''' ويمكن استخدامه لاستبدال التعليقات متعددة الأسطر.

Press + to interact
Python 3.10.4
''' Docstrings are pretty cool
for writing longer comments
or notes about the code '''
print(50)  # This line prints 50
print("Hello World")  # This line prints Hello World

في Python، تخدم التعليقات والسلاسل الوثائقية أغراضًا مختلفة:

  • تُستخدم التعليقات لشرح أسطر أو كتل برمجية محددة. وهي مُصممة لتمكين المطورين من فهم منطق الكود وهدفه. وهي غير قابلة للتنفيذ. استخدم التعليقات لتوضيح الكود المُعقد، وتوضيح الافتراضات، وإبراز النقاط المهمة.

  • تُقدم سلاسل الوثائق رؤية أوسع لمكونات مختلفة من الكود الخاص بك، وتُستخدم لتوفير الوثائق على مستوى أوسع. ويمكن الوصول إليها عبرhelp() الوظيفة، وهي مُصممة لوصف الغرض العام من الكود واستخدامه. وفقًا لدليل أسلوب Python ، يجب أن يحتوي كل نص برمجي وجميع أجزاء الكود المتاحة للعامة على سلسلة توثيق في البداية لإرشاد المستخدمين حول كيفية استخدام الكود بفعالية.