Python Comments

Python கருத்துகள்

கருத்துகள்

Python குறியீட்டை விளக்க கருத்துகள் பயன்படுத்தப்படலாம்.

குறியீட்டை மேலும் படிக்கக்கூடியதாக மாற்ற கருத்துகள் பயன்படுத்தப்படலாம்.

குறியீட்டை சோதிக்கும் போது இயக்கத்தைத் தடுக்க கருத்துகள் பயன்படுத்தப்படலாம்.

விளக்கம்

சிக்கலான குறியீட்டை விளக்க கருத்துகளைப் பயன்படுத்தவும். இது உங்களுக்கும் பிறருக்கும் குறியீட்டைப் புரிந்துகொள்ள உதவும்.

வாசிப்புத்திறன்

நீண்ட குறியீட்டைப் பிரிவுகளாகப் பிரிக்க கருத்துகளைப் பயன்படுத்தவும். இது குறியீட்டைப் பின்தொடரவும் புரிந்துகொள்ளவும் எளிதாக்குகிறது.

சோதனை

குறியீட்டின் பகுதிகளை தற்காலிகமாக முடக்க கருத்துகளைப் பயன்படுத்தவும். இது பிழைதிருத்தத்திற்கு உதவுகிறது.

ஆவணப்படுத்தல்

மாற்றங்கள், ஆசிரியர்கள் மற்றும் தேதிகளைக் குறிக்க கருத்துகளைப் பயன்படுத்தவும். இது பராமரிப்புக்கு உதவுகிறது.

கருத்தை உருவாக்குதல்

கருத்துகள் # உடன் தொடங்குகின்றன, மேலும் Python அவற்றை புறக்கணிக்கும்:

எடுத்துக்காட்டு

உங்கள் சொந்த Python சேவையகத்தைப் பெறுங்கள்

#This is a comment
print("Hello, World!")
Hello, World!

கருத்துகள் ஒரு வரியின் இறுதியில் வைக்கப்படலாம், மேலும் Python வரியின் மீதமுள்ள பகுதியை புறக்கணிக்கும்:

எடுத்துக்காட்டு

print("Hello, World!") #This is a comment
Hello, World!

ஒரு கருத்து குறியீட்டை விளக்கும் உரையாக இருக்க வேண்டியதில்லை, Python குறியீட்டை இயக்குவதைத் தடுக்கவும் இதைப் பயன்படுத்தலாம்:

எடுத்துக்காட்டு

#print("Hello, World!")
print("Cheers, Mate!")
Cheers, Mate!

முதல் print() அறிக்கை கருத்தாக இருப்பதால் இயக்கப்படவில்லை

ஒற்றை வரி கருத்துகள்

வரி தொடக்க கருத்து

# Calculate total price
price = 100
quantity = 3
total = price * quantity
print("Total:", total)

குறியீட்டு பகுதியை விளக்கும் கருத்து

வரி இறுதி கருத்து

price = 100  # Price per item in dollars
quantity = 3  # Number of items purchased
total = price * quantity  # Calculate total cost
print("Total:", total)  # Display the result

ஒவ்வொரு வரியையும் விளக்கும் கருத்துகள்

💡 ஒற்றை வரி கருத்து நடைமுறைகள்:

1. கருத்துக்குப் பிறகு ஒரு இடத்தை வைக்கவும்: # சரியானது vs #தவறானது
2. குறுகிய மற்றும் தெளிவான கருத்துகளை எழுதவும்
3. தெளிவுக்காக ஆங்கிலத்தில் கருத்துகளை எழுதவும்
4. மிகவும் வெளிப்படையான குறியீட்டிற்கு கருத்துகள் தேவையில்லை

பல வரி கருத்துகள்

Python க்கு உண்மையில் பல வரி கருத்துகளுக்கான தொடரியல் இல்லை.

பல வரி கருத்தைச் சேர்க்க, ஒவ்வொரு வரிக்கும் ஒரு # செருகலாம்:

எடுத்துக்காட்டு

#This is a comment
#written in
#more than just one line
print("Hello, World!")
Hello, World!

அல்லது, நோக்கம் அல்லாமல், நீங்கள் ஒரு பல வரி சரத்தைப் பயன்படுத்தலாம்.

Python ஒரு மாறிக்கு ஒதுக்கப்படாத சர மாறிலிகளை புறக்கணிப்பதால், உங்கள் குறியீட்டில் ஒரு பல வரி சரத்தை (மூன்று மேற்கோள்கள்) சேர்க்கலாம், மேலும் உங்கள் கருத்தை அதில் வைக்கலாம்:

எடுத்துக்காட்டு

"""
This is a comment
written in
more than just one line
"""
print("Hello, World!")
Hello, World!

சரம் ஒரு மாறிக்கு ஒதுக்கப்படாத வரை, Python குறியீட்டைப் படிக்கும், பின்னர் அதை புறக்கணிக்கும், மேலும் நீங்கள் ஒரு பல வரி கருத்தை உருவாக்கியுள்ளீர்கள்.

⚠️ பல வரி கருத்து குறிப்பு:

மூன்று மேற்கோள்கள் உண்மையில் பல வரி கருத்துகள் அல்ல - அவை பல வரி சரங்கள். அவை ஒரு மாறிக்கு ஒதுக்கப்படாவிட்டால் மட்டுமே கருத்துகளாக செயல்படுகின்றன. பொதுவாக, பல வரி கருத்துகளுக்கு ஒவ்வொரு வரியிலும் # பயன்படுத்துவது நல்லது.

கருத்து எடுத்துக்காட்டுகள்

கோப்பு தலைப்பு

# ====================================
# File: calculator.py
# Author: Jassif Team
# Date: 2023-12-25
# Description: Simple calculator program
# ====================================

கோப்பு மெட்டாடேட்டாவை விவரிக்கும் தலைப்பு கருத்து

செயல்பாடு ஆவணப்படுத்தல்

def calculate_total(price, quantity):
    """
    Calculate total price including tax
    
    Parameters:
    price (float): Price per item
    quantity (int): Number of items
    
    Returns:
    float: Total price with 10% tax
    """
    tax_rate = 0.10
    subtotal = price * quantity
    total = subtotal * (1 + tax_rate)
    return total

செயல்பாடுகளை ஆவணப்படுத்த பல வரி சரங்கள்

சோதனை / பிழைத்திருத்தம்

x = 10
y = 5

# Temporary debugging
# print("x =", x)
# print("y =", y)

result = x * y
print("Result:", result)

பிழைத்திருத்த குறியீட்டை முடக்க கருத்துகள்

எச்சரிக்கை கருத்துகள்

# WARNING: This function modifies the
# original list. Make a copy if you
# need to preserve the original data.
def sort_list(items):
    items.sort()
    return items

முக்கியமான எச்சரிக்கைகள் அல்லது குறிப்புகள்

கருத்து சிறந்த நடைமுறைகள்

ஏன் என்பதை விளக்கவும், என்ன செய்கிறது என்பதை அல்ல: குறியீடு என்ன செய்கிறது என்பதைக் காட்டுகிறது. கருத்துகள் ஏன் அப்படி செய்யப்படுகின்றன என்பதை விளக்க வேண்டும்.
தேவையான இடங்களில் மட்டும் கருத்துகளை எழுதவும்: வெளிப்படையான குறியீட்டிற்கு கருத்துகள் தேவையில்லை. x = x + 1 என்பதற்கு "x ஐ 1 ஆல் அதிகரிக்கவும்" என்று கருத்து தேவையில்லை.
கருத்துகளை நாளது தேதிக்கு வைத்திருங்கள்: குறியீடு மாறும்போது கருத்துகளைப் புதுப்பிக்கவும். பழைய கருத்துகள் தவறான தகவல்களை வழங்கலாம்.
மிக நீண்ட கருத்துகளைத் தவிர்க்கவும்: கருத்து குறியீட்டை விட நீளமாக இருந்தால், குறியீட்டை மறுசீரமைக்கவும் அல்லது எளிமைப்படுத்தவும்.
கருத்துகளில் குறியீட்டை வைக்க வேண்டாம்: பழைய குறியீட்டை நீக்கவும், அதை கருத்துகளில் வைக்காதீர்கள். பதிப்புக் கட்டுப்பாட்டு கருவிகளைப் பயன்படுத்தவும்.

பயிற்சி

Python கருத்தை வரையறுக்க எந்த எழுத்து பயன்படுத்தப்படுகிறது?

'
✗ தவறு! ' என்பது ஒற்றை மேற்கோள், கருத்து அல்ல
//
✗ தவறு! // என்பது C++/Java இல் கருத்துக்கானது, Python இல் அல்ல
#
✓ சரி! # என்பது Python இல் கருத்துகளுக்கானது
/*
✗ தவறு! /* */ என்பது C/Java இல் பல வரி கருத்துகளுக்கானது, Python இல் அல்ல

அடுத்த தலைப்பு: Python Variables

அடுத்த பாடத்தில், Python இல் மாறிகளை எவ்வாறு உருவாக்குவது மற்றும் பயன்படுத்துவது என்பதைக் கற்றுக்கொள்வோம்:

🔜 அடுத்து வருவது:

• மாறிகளை உருவாக்குதல் மற்றும் ஒதுக்குதல்
• மாறி பெயரிடும் விதிகள்
• பல்வேறு தரவு வகைகள்
• மாறிகளை வெவ்வேறு வகைகளுக்கு மாற்றுதல்
• உலகளாவிய மற்றும் உள்ளூர் மாறிகள்
• நல்ல மாறி பெயரிடும் நடைமுறைகள்