Search⌘ K
AI Features
Home
Courses
تعلم أساسيات Python 3

كتابة أول كود برمجي لدينا

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

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

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

الprint() وظيفة

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

إليكم كيفprint() تعمل هذه الدالة في Python:

Python 3.10.4
print("Data to be printed")

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

Python 3.10.4
print("Hello World")

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

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

Python 3.10.4
print(50)
print(1000)
print(3.142)

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

طباعة أجزاء متعددة من البيانات

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

Print statement
Print statement

جرب بنفسك

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

Python 3.10.4
print(50, 1000, 3.142, "Hello World")

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

Python 3.10.4
print("Hello", end="")
print("World")
print("Hello", end=" ")
print("World")
print("Hello", end=", ")
print("World")

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

تعليقات

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

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

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

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

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

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

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) بديلاً لهذه التعليقات متعددة الأسطر، وهو اختصار لـ "سلاسل التوثيق". ويتم وضعه بين علامتي اقتباس ثلاثيتين.''' ويمكن استخدامها لاستبدال التعليقات متعددة الأسطر.

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 ، يجب أن يحتوي كل نص برمجي، وكل جزء من الكود المتاح للعامة، على وصف توضيحي في بدايته لإرشاد المستخدمين حول كيفية استخدام الكود بفعالية.