இந்த கட்டுரையில் , உங்கள் code-யில் கருத்துகளைச் சேர்ப்பது எப்படி என்பதை நீங்கள் கற்றுக் கொள்வீர்கள். block comments, inline comments, and documentation strings. உங்கள் பைதான் நிரல்களை மிகவும் புரிந்துகொள்ளக்கூடியதாகவும், பராமரிக்கக்கூடியதாகவும், பயனர்களுக்கு ஏற்றதாகவும் மாற்றுவதில் அவை முக்கிய பங்கு வகிக்கின்றன. எனவே இதன்முலம் பல்வேறு வகையான python comments with Examples நீங்கள் கற்றுக்கொள்வீர்கள் மற்றும் செயல்படுக்ககையும் கற்றுக்கொள்வீர்கள் .
குறியீடு (code) செயல்படுத்தும் போது பைதான் கருத்துகள் (Python comments) பைதான் மொழிபெயர்ப்பாளரால் (Python interpreter) புறக்கணிக்கப்படுகின்றன, அதாவது அவை உங்கள் நிரலின் (program) செயல்பாட்டை பாதிக்காது. மாறாக, நீங்கள் மற்றும் எதிர்காலத்தில் குறியீட்டில் பணிபுரியும் அல்லது மதிப்பாய்வு செய்யக்கூடிய பிற டெவலப்பர்கள் உட்பட மனித வாசகர்களுக்காக அவை வடிவமைக்கப்பட்டுள்ளன. இதன் மூலம் இந்த program-யின் செயல்பாடு பற்றி புரிந்துகொள்ளலாம்.
Python Comments இரண்டு முதன்மை வகைகள் உள்ளன:
- single-line comments (ஒற்றை வரி கருத்துகள் )
- Multi-line comments (பல வரி கருத்துகள் அல்லது மல்டி-லைன் கருத்துகள்)
single-line comments:
இந்த கருத்துகள் ஒற்றை வரி குறியீட்டில் சுருக்கமான விளக்கங்களுக்குப் பயன்படுத்தப்படுகின்றன. அவை "#" குறியீட்டில் தொடங்கி அந்த வரியின் இறுதி வரை நீள்கின்றன. ஒரு குறிப்பிட்ட வரிக்கு விரைவான தெளிவுபடுத்தல்கள் அல்லது சூழலை (context for a specific line of code) வழங்குவதற்கு ஒற்றை வரி கருத்துகள் எளிதாக இருக்கும்.
Examples:
# This is a single-line comment
print("Welcome To, Free Seo Tricks!") # This is another comment (same singel-line comment)
Multi-line comments:
மல்டி-லைன் கருத்துகள், பெரும்பாலும் டாக்ஸ்ட்ரிங்ஸ் (docstrings or documentation strings) என்று குறிப்பிடப்படுகின்றன, மேலும் விரிவான ஆவணப்படுத்தலுக்குப் பயன்படுத்தப்படுகின்றன. அவை மூன்று மேற்கோள்களில் (''' அல்லது """) இணைக்கப்பட்டுள்ளன, மேலும் பல வரிகளை விரிவுபடுத்தலாம். டாக்ஸ்ட்ரிங்ஸ் (docstrings or documentation strings) பொதுவாக (document functions, classes, modules) ஆவண செயல்பாடுகள், வகுப்புகள், தொகுதிகள் மற்றும் பலவற்றிற்குப் பயன்படுத்தப்படுகின்றன. அவை valuable source of information செயல்படுகின்றன. (purpose, usage, and parameters of code elements).
For examples :
'''
This is a multi-line comment (docstring).
It can span multiple lines and is often used to document functions and classes.
'''
def add(a, b):
'''
This function adds two numbers and returns the result.
Parameters:
a (int): The first number.
b (int): The second number.
Returns:
int: The sum of a and b.
'''
return a + b
மேலே உள்ள எடுத்துக்காட்டில், டாக்ஸ்ட்ரிங் அதன் add function, including its purpose, parameters, and return value. பற்றிய விரிவான தகவல்களை வழங்குகிறது.
குறிப்பாக பெரிய திட்டங்களில் பணிபுரியும் போது அல்லது பிற டெவலப்பர்களுடன் ஒத்துழைக்கும்போது, குறியீட்டு ஆவணங்கள் மற்றும் புரிதலுக்கு கருத்துகள் அவசியம். அவை உங்கள் குறியீட்டை மிகவும் பராமரிக்கக்கூடியதாக ஆக்குகிறது மற்றும் உங்கள் குறியீட்டின் பல்வேறு பகுதிகளின் தர்க்கத்தையும் நோக்கத்தையும் மற்றவர்களுக்கு (அல்லது உங்கள் எதிர்கால சுயம்) புரிந்துகொள்ள உதவுகிறது.