কমেন্ট #

কোডের সাথে অসংগতিপূর্ণ কমেন্ট, কোনো কমেন্ট না করার চেয়েও বাজে ব্যাপার।

এ বিষয়টি একেবারেই ছোট। খুব অল্পতেই এর আলোচনা শেষ হয়ে যাবে। কিন্তু এর প্রভাব খুব দীর্ঘমেয়াদি। আমরা শুধু এ বিষয়ের মধ্যেই একে সীমাবদ্ধ রাখব না; বরং বিভিন্ন ক্ষেত্রে কমেন্টের ব্যবহার আমাদের শিখতে হবে। প্রথমেই আমরা জানব যে কমেন্ট আসলে কী জিনিস। ইতিমধ্যে আমরা ছোট-ছোট কয়েকটা প্রোগ্রাম লিখেছি। সেখানে ভেরিয়েবল ছিল অল্প। পাইথনের বড় কোনো বাস্তবায়ন কিন্তু সেখানে নেই। যখন কোনো বড় প্রজেক্টে আমরা হাত দেব, তখন বিভিন্ন জিনিস আমাদের কমেন্ট করে রাখা উচিত। কোন ভেরিয়েবল কী জন্য ডিক্লেয়ার করেছি, কোন ফাংশনের কী কাজ, কোন ক্লাস কী জন্য দরকার পড়েছে ইত্যাদি জিনিস কমেন্ট করে লিখে রাখা উচিত। এর ফলে অনেক দিন বাদে আমরা যখন পুরোনো প্রোগ্রাম নিয়ে কাজ করতে যাব, তখন বুঝতে সুবিধা হবে। শুধু তা-ই নয়, অন্যরাও আমাদের প্রোগ্রাম পড়ে সহজে বুঝতে পারবে। কমেন্ট কখনো এক্সিকিউট হয় না। আসলে কমেন্ট হলো এমন কিছু স্টেটমেন্ট, যা ইন্টারপ্রিটার কস্মিনকালেও ইন্টারপ্রিট করবে না। কমেন্ট পূর্ণাঙ্গ বাক্যের মতো হওয়া উচিত, তবে চাইলে বাক্যাংশ (phrase) ব্যবহার করা যায়। যা-ই হোক, কমেন্ট সব সময় বড় হাতের অক্ষর দিয়ে শুরু করা উচিত, যদি না শুরুতে কোনো আইডেন্টিফায়ার থাকে। কমেন্ট ছোট হলে শেষে যতিচিহ্ন না দিলেও চলে। তবে ব্লক কমেন্টে যেহেতু পূর্ণাঙ্গ বাক্য থাকে তাই তার শেষে যতিচিহ্ন দেওয়া বাঞ্ছনীয়। এ ছাড়া পাইথনের কোনো লাইনে, কোনো স্টেটমেন্টের আগে # চিহ্ন দিলে তা আর এক্সিকিউট হয় না। যেমন :

>>> a = 23
>>> # a is an int variable
...
>>>

ইনলাইন কমেন্ট #

স্টেটমেন্টের সাথে একই লাইনে থাকা কমেন্টকে ইনলাইন কমেন্ট বলে। কমপক্ষে দুটি স্পেস দিয়ে ইনলাইন কমেন্টকে স্টেটমেন্ট থেকে আলাদা করতে হয়।

>>> a = 15  # a is a dividend
>>> b = 3  # b is a divisor
>>> a/b
5.0
>>>

প্রতি লাইনের যে অংশে # পাবে তারপর থেকে সেই লাইন আর এক্সিকিউট হবে না। তাহলে নিচের লাইনের আউটপুট কি হবে?

>>> print("I like the # symbole.")

ব্লক কমেন্ট #

ব্লক কমেন্ট বলতে মাল্টি-লাইন কমেন্টকেই বুঝায়। তবে পাইথনে মাল্টি-লাইন কমেন্ট করার জন্য আলাদা কোনকিছু নাই। # দিয়ে লাইন-বাই-লাইন কমেন্ট করতে হয়। ব্লকের প্রতিটা লাইন # চিহ্ন ও এর পরে একটা স্পেস দিয়ে শুরু হয়। যেমন:

>>> # a is an int variable
... # This is another comment.
...
>>>

ডকুমেন্ট স্ট্রিং বা ডকস্ট্রিং #

কখনো কখনো একসাথে কয়েক লাইন কমেন্ট লেখার দরকার হয়ে পড়ে। তখন এ ধরনের কমেন্ট ফরম্যাট ব্যবহার করা হয়। """...""" (শুরুতে ডবল কোটেশন মার্ক ৩টি এবং শেষেও ডবল কোটেশন মার্ক তিনটি) এর ভেতরে যা লেখা থাকবে তা-ই ডকস্ট্রিং হিসেবে বিবেচিত হবে। আর বোমা ফাটানোর মতো কথা হলো, ট্রিপল কোটের ভেতরের এসবও স্ট্রিং। আমরা চাইলে এভাবেও স্ট্রিং ডিক্লেয়ার করতে পারি। যেমন :

>>> """
... a is an int variable.
... This is another comment.
... """
'\na is an int variable.\nThis is another comment.\n'
>>>

স্টাইল গাইড চ্যাপ্টারে ডকস্ট্রিং সম্পর্কে বিস্তারিত আলোচনা করা হবে। আপাতত যা জানলাম তা হল জানার জন্য জানা, শুধুমাত্র মাথায় রাখার জন্য।

এই হল পাইথনে কমেন্টের ব্যাপার-স্যাপার। বাকিটা ধাপে ধাপে শিখে যাব আমরা, বিশেষ করে কোথায় কোথায় কমেন্ট ব্যবহার করা বাঞ্ছনীয় সেটা। কিভাবে কমেন্ট ব্যবহার করব সেটাও কিন্তু একটা ব্যাপার বটে!