الرؤية عبر print والتوضيح عبر التعليقات

المشكلة التي نقوم بحلها

كتبت برنامجاً. شغّلته. الطرفية لم تقل شيئاً.

هل نجح؟ هل توقف في المنتصف؟ ما نتيجة الحساب في الداخل؟ لا توجد طريقة للمعرفة، لأن الحاسوب لا يخبرك بشيء من تلقاء نفسه — ما تريد رؤيته يجب أن تطلبه.

print هي طريقة الطلب. في البداية هي نافذتك الوحيدة: إلى أين وصل البرنامج، وماذا يحمل متغير (variable) ما، وماذا أنتج الحساب. حتى المطورون ذوو الخبرة يضعون print في الكود مرات كثيرة في اليوم رغم وجود أداة تصحيح (debugger) في متناولهم — ولا عيب في ذلك، فهذا جزء من العمل.

في نهاية هذا الفصل ستستطيع

• طباعة عدة أشياء في استدعاء واحد، والتحكم في الفراغ بينها
• تغيير شكل المخرجات باستخدام sep وend
• ملاحظة الفرق بين النص (string) والأرقام — ولماذا "2" + "3" ليس 2 + 3
• كتابة التعليقات (comments)، ومعرفة أي التعليقات تستحق الكتابة فعلاً

المتطلبات المسبقة: الطرفية والمجلدات ومشروعك الأول.

print تقبل أكثر من شيء واحد

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

print("Order", 7, "confirmed")

Order 7 confirmed

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

وفي نهاية كل print تنتقل إلى سطر جديد:

print("line one")
print("line two")

line one
line two

print() الفارغة تطبع سطراً فارغاً فقط — وهي أبسط طريقة لتقسيم المخرجات الطويلة إلى مجموعات سهلة القراءة.

sep — الفراغ بالشكل الذي تريده

إذا لم تكن تلك المسافة ما تريده، فغيّرها:

print("2026", "09", "10", sep="-")
print("home", "user", "notes.txt", sep="/")
print("a", "b", "c", sep="")

2026-09-10
home/user/notes.txt
abc

end — ماذا يحدث في نهاية السطر

افتراضياً تُنهي print السطر وتنتقل إلى الأسفل. ويمكن تغيير ذلك أيضاً:

print("Loading", end="")
print(".", end="")
print(".", end="")
print(". done")

Loading... done

أربعة استدعاءات منفصلة لـ print، وسطر واحد من المخرجات — لأن الثلاثة الأولى طُلب منها ألا تضع شيئاً في نهاية السطر.

النصوص والأرقام ليست الشيء نفسه

هذان السطران يبدوان متشابهين تقريباً، لكنهما يتصرفان بشكل مختلف:

print(2 + 3)
print("2" + "3")

5
23

ما بين علامتي الاقتباس نص (string)، و+ هنا لا تجمع — بل تضم النصين معاً. وما هو خارجهما رقم، و+ هنا تجمع فعلاً.

هذا التمييز هو أساس الفصول التالية، وهو أيضاً سبب نصف الأخطاء التي يواجهها المبتدئون تقريباً. الآن تذكّر القاعدة فقط: علامات الاقتباس تعني نصاً.

التعليقات — الأسطر التي لا يقرؤها بايثون

من العلامة # إلى نهاية السطر، يتجاهل بايثون كل شيء:

# Friday delivery report
total = 12 + 8
print("Total:", total)  # the sum shown at the bottom of the report

Total: 20

التعليقات لا تؤثر في طريقة عمل البرنامج. إنها للناس — لزميلك، ولك أنت بعد ثلاثة أشهر، حين تكون قد نسيت كل هذا.

*التعليق الجيد يقول لماذا، لا ماذا.* ما يفعله الكود ظاهر في الكود نفسه:

# Weak: repeats what the code already says
count = count + 1  # add 1 to count

# Useful: gives the reason, which the code cannot show
count = count + 1  # the header row was counted too, so shift by one

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

وأثناء التعلم للتعليقات استخدام آخر — إيقاف سطر مؤقتاً لترى كيف يعمل البرنامج بدونه:

print("first")
# print("second")
print("third")

first
third

مثال كامل

أنشئ الملف report.py وشغّله:

# A small sales report
print("=" * 24)
print("SALES REPORT")
print("=" * 24)

print("Items sold:", 3 + 5 + 2)
print("Revenue:", 3 * 120 + 5 * 90 + 2 * 250)

print()
print("Prepared by", "Rafi", sep=": ")

========================
SALES REPORT
========================
Items sold: 10
Revenue: 1310

Prepared by: Rafi

لاحظ السطر الفارغ بعد Revenue: 1310 في المخرجات — مصدره print() الفارغة. وهو يفصل الجزء الأخير من التقرير.

ولاحظ أيضاً "=" * 24. ضرب نص في رقم يجعل بايثون يكرره ذلك العدد من المرات، فلا حاجة إلى كتابة أربع وعشرين علامة مساواة يدوياً لرسم خط.

عندما يحدث خطأ

SyntaxError: unterminated string literal فُتحت علامة اقتباس ولم تُغلق. print("Hello) يسبب هذا. عُدّ علامات الاقتباس في البداية والنهاية.

تحتاج إلى علامة اقتباس داخل النص استخدم نوعاً في الخارج والنوع الآخر في الداخل: print("It's working") أو print('She said "yes"').

SyntaxError: Missing parentheses in call to 'print'. Did you mean print(...)? كتابة print "Hello" تعطي هذا. هذه صياغة بايثون 2. في بايثون 3 print دالة (function)، لذلك تحتاج إلى أقواس: print("Hello"). هذا الخطأ يأتي عادةً من درس أو إجابة قديمة.

إعطاء sep أو end قيمة بلا علامات اقتباس print("a", "b", sep=-) يعطي SyntaxError: invalid syntax. sep وend يأخذان نصاً دائماً: sep="-".

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

دورك الآن

اكتب ملفاً باسم profile.py يُخرج هذه المخرجات بالضبط:

------------------------
NAME : Rafi
ROLE : Python learner
------------------------
Age next year: 23

ثلاثة شروط:

1. يجب إنتاج الخطين العلوي والسفلي بالضرب، لا بكتابة أربع وعشرين شرطة
2. يجب أن يستخدم السطران NAME : Rafi وROLE : Python learner الوسيط sep
3. في سطر Age next year لا تكتب الرقم بنفسك — بل احصل عليه بالجمع، مثل 22 + 1

وضع تعليقاً في السطر الأول من الملف يقول لماذا يوجد هذا الملف — لا ماذا يفعل.