توضیحات (Comments)
اینجا «توضیحات پایتون» را یاد می گیری. «توضیح یا کامنت (Comment)» نوشته ای برای انسان است. کامپیوتر آن را اجرا نمی کند. بنابراین کد خواناتر می شود و خطاها راحت تر پیدا می شوند.
ساخت یک توضیح ساده
علامت # یعنی از اینجا به بعد، توضیح است و اجرا نمی شود.
# This is a comment
print("Hello, World!")
توضیح در پایان خط
می توانی آخر خط، توضیح بگذاری. از # به بعد نادیده گرفته می شود.
print("Hello, World!") # This is a comment
غیرفعال کردن اجرای کد
گاهی می خواهی موقتاً کدی اجرا نشود. آن را کامنت کن.
# print("Hello, World!")
print("Cheers, Mate!")
توضیح چندخطی با #
پایتون دستور ویژه چندخطی ندارد. اما می توانی هر خط را با # شروع کنی.
# This is a comment
# written in
# more than just one line
print("Hello, World!")
توضیح چندخطی با رشته سه تایی
می توانی رشته سه تایی بنویسی. اگر به متغیر ندهی، نادیده گرفته می شود.
"""
This is a comment
written in
more than just one line
"""
print("Hello, World!")
گام های عملی
- جلوی یک خط،
#بگذار و اجرا کن. - آخر یک دستور، توضیح کوتاه اضافه کن.
- سه خط توضیح با
#بنویس و تست کن.
نکته: توضیح باید کوتاه و واضح باشد. دلیل کار را بگو.
جمع بندی سریع
#یعنی این بخش اجرا نمی شود.- می توانی آخر خط هم کامنت بگذاری.
- برای چندخطی، هر خط را با
#شروع کن. - رشته سه تاییِ بدون انتساب، مثل توضیح عمل می کند.