كتابة الكود الأول الخاص بنا
تعرف على كيفية استخدام عبارات الطباعة والتعليقات والسلاسل الوثائقية.
سنغطي ما يلي...
لنبدأ بالأشياء الممتعة من خلال الغوص مباشرة في الكود.
دالة print()
عند تعلم أي لغة برمجة جديدة، من المعتاد البدء بعرض النص "مرحبًا بالعالم!" على الشاشة. لكل لغة تركيبها النحوي الخاص لإخراج المعلومات أو طباعتها. تُسهّل Python، المعروفة بسهولة قراءتها، هذه المهمة باستخدام دالة print() .
إليك كيفية عمل دالة print() في Python:
print("Data to be printed")
جميع المحتويات المراد طباعتها مُحاطة بالأقواس التي تلي كلمة " print ". الآن، لنحاول طباعة "Hello World" في الطرفية.
print("Hello World")
من المهم ملاحظة أن النص Hello World موجود بين علامتي اقتباس لأنه يمثل سلسلة ، وهي عبارة عن تسلسل من الأحرف.
بعد ذلك، سنطبع بعض الأرقام. كل استدعاء print سينقل إخراج إلى سطر جديد.
print(50)print(1000)print(3.142)
هل لاحظت أننا لم نضع الأرقام بين علامتي اقتباس؟ لو فعلنا ذلك، لعاملها المترجم كسلاسل نصية. سيتضح الفرق بينهما أكثر عند مناقشة أنواع البيانات.
طباعة قطع متعددة من البيانات
يمكننا طباعة عناصر متعددة في أمر print واحد عن طريق فصلها ببساطة باستخدام الفواصل.
جربها بنفسك
حاول إصلاح الكود التالي وتشغيله بنجاح. يمكن لمرشد الذكاء الاصطناعي لدينا إرشادك أيضًا.
print(50, 1000, 3.142 "Hello World"
By default, each print statement prints text in a new line. If we want multiple print statements to print in the same line, we can use the following code:
print("Hello", end="")print("World")print("Hello", end=" ")print("World")print("Hello", end=", ")print("World")
يتم إضافة قيمة end إلى إخراج، وسيستمر بيان print التالي من تلك النقطة.
تعليقات
التعليقات هي أجزاء نصية تُستخدم لوصف ما يحدث في الشيفرة البرمجية. ليس لها أي تأثير على الشيفرة البرمجية. مع ذلك، للتعليقات في البرمجة أغراض مهمة عديدة، فهي تُحسّن سهولة قراءة الشيفرة البرمجية، وتُسهّل فهمها وتصحيح أخطائها وصيانتها. في الفرق الكبيرة، تُسهّل التعليقات التعاون، إذ يُمكن لأعضاء الفريق استخدامها لفهم شيفرة بعضهم البعض، بالإضافة إلى شيفراتهم البرمجية الخاصة.
أفضل الممارسات لكتابة التعليقات:
يجب أن تكون التعليقات دقيقة وواضحة ومختصرة وذات معنى - وتشرح وظيفة الكود بطريقة يسهل فهمها.
قد يختلف مستوى التفاصيل في التعليقات اعتمادًا على تعقيد الكود - بدءًا من سطر واحد للكود الأكثر بساطة إلى تفسيرات أكثر تفصيلاً للخوارزميات المعقدة.
حافظ على نمط وتنسيق متسقين لتعليقاتك في قاعدة التعليمات البرمجية لتحسين قابلية القراءة.
A comment can be written using the # character in Python. The following code widget shows how to write single line comments. Note that each line of comment needs to start with the # character.
print(50) # This line prints 50print("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
An alternative to these multi-line comments are docstrings—short for documentation strings. They are encased in triple quotes, ''', and can be used to replace multi-line comments.
''' Docstrings are pretty coolfor writing longer commentsor notes about the code '''print(50) # This line prints 50print("Hello World") # This line prints Hello World
في Python، تخدم التعليقات والسلاسل الوثائقية أغراضًا مختلفة:
تُستخدم التعليقات لشرح أسطر أو كتل برمجية محددة. وهي مُصممة لتمكين المطورين من فهم منطق الكود وهدفه. وهي غير قابلة للتنفيذ. استخدم التعليقات لتوضيح الكود المُعقد، وتوضيح الافتراضات، وإبراز النقاط المهمة.
تُقدم سلاسل الوثائق رؤيةً أوسع لمكونات الكود المختلفة، وتُستخدم لتوفير توثيق شامل. يمكن الوصول إليها عبر دالة
help()، وهي مُصممة لوصف الغرض العام من الكود واستخدامه. وفقًا لدليل أسلوب Python ، يجب أن يحتوي كل نص برمجي وجميع أجزاء الكود المتاحة للعامة على سلسلة وثائق في البداية لتوجيه المستخدمين حول كيفية استخدام الكود بفعالية.