پائتھن کورس کا لیکچر 8۔ اپنے پائتھن کوڈ کو مزید پڑھنے کے قابل اور قابل فہم بنانے کے لیے تبصرے شامل کرنے کا طریقہ اور کیوں سیکھیں۔
ہمیں تبصرے کیوں لکھنے چاہئیں؟
کوڈ کمپیوٹر کو بتاتا ہے کہ کیا کرنا ہے۔ تبصرے انسانوں کو بتاتے ہیں کہ کوڈ کیا کر رہا ہے۔
جب آپ کوڈ لکھتے ہیں، تو یہ واضح لگ سکتا ہے کہ یہ کیا کرتا ہے۔ لیکن جب آپ ایک ہفتے، ایک مہینے، یا ایک سال بعد اس پر واپس آتے ہیں، تو آپ اپنی سوچ کا عمل بھول سکتے ہیں۔ تبصرے آپ کے مستقبل کے لیے اور دوسرے پروگرامرز کے لیے نوٹس کا کام کرتے ہیں جو آپ کے کوڈ پر کام کر سکتے ہیں۔
- وضاحت: وہ آپ کے کوڈ کے پیچیدہ یا مشکل حصوں کی وضاحت کرتے ہیں۔
- تعاون: وہ دوسرے لوگوں کو آپ کے کوڈ کو جلدی سمجھنے میں مدد کرتے ہیں۔
- ڈیبگنگ: آپ غلطیوں کو تلاش کرنے کے لیے کوڈ کی لائنوں کو عارضی طور پر “تبصرہ” کر سکتے ہیں تاکہ انہیں حذف کیے بغیر غیر فعال کر سکیں۔
پائتھن میں تبصرے کیسے لکھیں
پائتھن میں، کوئی بھی لائن جو ہیش سمبل (#) سے شروع ہوتی ہے وہ ایک تبصرہ ہے۔ پائتھن انٹرپریٹر ان لائنوں کو مکمل طور پر نظر انداز کر دیتا ہے جب وہ پروگرام چلاتا ہے۔
تبصروں کی مثال
# This is a full-line comment. It explains the purpose of the code below.
# This program will ask for the user's name and age.
# Get user input for their name
name = input("Enter your name: ")
age = 25 # This is an inline comment. It explains a single line.
# Print a greeting message
print("Hello,", name)
# The following line is commented out, so it will not run.
# print("Your age is", age)اچھے تبصرے کی عادات
- واضح بات نہ کہیں۔ “یہ ایک متغیر ہے” جیسا تبصرہ مددگار نہیں ہے۔
- کیوں کی وضاحت کریں، کیا کی نہیں۔ کسی لائن کے کام کی وضاحت کرنے کے بجائے (جو کوڈ خود دکھانا چاہیے)، اگر وجہ واضح نہ ہو تو یہ کیوں موجود ہے اس کی وضاحت کریں۔
- تبصروں کو اپ ڈیٹ رکھیں۔ اگر آپ اپنا کوڈ تبدیل کرتے ہیں، تو یقینی بنائیں کہ آپ تبصروں کو بھی اپ ڈیٹ کرتے ہیں!
لیکچر کا خلاصہ
آپ نے سیکھا ہے کہ صاف، قابل فہم کوڈ لکھنے کے لیے تبصرے کتنے اہم ہیں۔ اب آپ جانتے ہیں کہ ہیش سمبل (#) کا استعمال کرتے ہوئے انہیں کیسے لکھنا ہے اور اپنے تبصروں کو مفید بنانے کے لیے کچھ بہترین طریقے بھی سیکھے ہیں۔
اگلی بار
غلطیاں ہوتی رہتی ہیں! اگلے لیکچر میں، ہم کوڈ کی غلطیوں کو سمجھنا شروع کریں گے تاکہ آپ انہیں ٹھیک کرنا سیکھ سکیں۔
لیکچر 7: متن کے ساتھ کام کرنا سٹرنگز
