Python Comment: चरण-दर-चरण गाइड

Python कमेंट प्रोग्राम में टेक्स्ट की एक लाइन होती है जिसे इंटरप्रेटर द्वारा निष्पादित नहीं किया जाता। कमेंट्स का उपयोग डिबगिंग के दौरान समस्याओं की पहचान करने और कोड समझाने के लिए किया जाता है। कमेंट्स हैश कैरेक्टर (#) से शुरू होते हैं।

Python में कमेंट कैसे करें

कमेंट्स नोट्स या कोड को दर्शाते हैं जिन्हें आप Python को चलाना नहीं चाहते। उदाहरण के लिए, मान लीजिए आप कई घंटों में एक जटिल प्रक्रिया लिख रहे हैं। आप कुछ कमेंट्स लिखना चाह सकते हैं ताकि प्रत्येक कोड लाइन क्या करती है इसका ट्रैक रख सकें ताकि आप ट्रैक न खोएं।

कमेंट्स लिखना कई कारणों से उपयोगी है। यदि आप बड़े Python प्रोग्राम के साथ काम कर रहे हैं, तो कमेंटिंग आपको यह ट्रैक रखने में मदद कर सकती है कि क्या हो रहा है। कमेंटिंग टीम सदस्यों को सहयोगी प्रोजेक्ट पर एक-दूसरे के काम को समझने में भी मदद करती है।

हर डेवलपर अंततः ऐसी स्थिति का सामना करता है जहां कोड लिखते समय उन्हें कमेंट्स शामिल करने होंगे।

लेकिन Python में कोड पर कमेंट कैसे करते हैं? हर दूसरी प्रोग्रामिंग भाषा की तरह, Python कमेंटिंग का समर्थन करता है। इस गाइड में, हम Python में कमेंट्स लिखने के बारे में बात करने जा रहे हैं।

Python Comment क्या है?

Python कमेंट टेक्स्ट की एक लाइन है जो प्रोग्राम में दिखाई देती है लेकिन प्रोग्राम द्वारा निष्पादित नहीं की जाती। आप हैशटैग (#) का उपयोग करके कमेंट घोषित कर सकते हैं। कमेंट्स नई लाइन पर या कोड की मौजूदा लाइन के अंत में दिखाई दे सकते हैं।

कमेंट्स का उपयोग यह समझाने के लिए किया जाता है कि कोड कैसे काम करता है और परीक्षण उद्देश्यों के लिए।

यहाँ Python में सिंगल लाइन कमेंट का एक उदाहरण है:

# This is a demo comment

आप # हैश मार्क देख सकते हैं जो हमारे कमेंट को दर्शाता है। हमने अपने कमेंट टेक्स्ट और # साइन को स्पेस से अलग किया है। यह आवश्यक नहीं है लेकिन यह प्रत्येक कमेंट को पढ़ना आसान बनाता है।

जब हम अपना कोड चलाते हैं तो यह लाइन कंपाइलर द्वारा अनदेखी की जाती है। कमेंट्स इंसानों द्वारा पढ़े जाने के लिए हैं। वे प्रोग्राम द्वारा निष्पादित करने के लिए नहीं हैं।

कमेंट्स को उसी इंडेंट स्तर पर जोड़ा जाना चाहिए जिस कोड पर कमेंट संदर्भित कर रहा है। उदाहरण के लिए, मान लीजिए आप if स्टेटमेंट के भीतर कोड की एक लाइन के बारे में लिख रहे हैं। आप अपने कमेंट को उसी तरह इंडेंट करेंगे जैसे आपने अपने कोड के साथ किया था।

Python Comments उदाहरण

मान लीजिए आप फॉर लूप लिख रहे हैं, और आप खुद को याद दिलाना चाहते हैं कि यह कैसे काम करता है। आप कुछ कमेंट्स लिखना चाह सकते हैं। जब आप बाद में अपने कोड को देखने आएंगे, तो आप अपने नोट्स पढ़ पाएंगे।

Python फॉर लूप में, आपके कमेंट्स इस तरह दिख सकते हैं:

# Define students variable as an array of strings
students = ["Nathan", "Alyssa", "Matthew", "Malcolm", "Alexis", "Katie"]
# Loop through each item in the students array and print out each name
for s in students:
    print("Student Name: ", s)

हमारे कमेंट्स हमें अपने कोड का उद्देश्य समझने और ट्रैक रखने में मदद करते हैं कि क्या हो रहा है।

आइए Python में कमेंट्स की इंडेंटेशन संरचना को स्पष्ट करने के लिए एक उदाहरण का उपयोग करें। नीचे दिए गए उदाहरण में, हमारा प्रोग्राम दो Python सरणियों के माध्यम से लूप करता है और प्रत्येक छात्र को उनके टेस्ट के लिए pass या fail देता है। पास और फेल छात्रों के टेस्ट पर उनके संख्यात्मक स्कोर के आधार पर निर्धारित किए जाते हैं:

# Define an array with student names
students = ["Nathan", "Alyssa", "Matthew", "Malcolm", "Alexis", "Katie"]
# Define an array with student grades
numericalGrades = [55, 72, 64, 86, 86, 59]
# Loop through every student in "students" array
for s in range(0, len(students)):
    # Check if the student's numerical grade is equal to or above 60
    if numericalGrades[s] >= 60:
        # Print a message saying the student has passed their test
        print(students[s], "passed their test.")
    else:
        # Print a message saying the student has failed their test
        print(students[s], "failed their test.")

यह प्रोग्राम छात्रों की सूची और उनके ग्रेड लेता है। फिर, हमारा प्रोग्राम छात्रों की सूची के माध्यम से लूप करता है। हम जांचते हैं कि प्रत्येक छात्र ने अपना टेस्ट पास किया है या फेल।

ऊपर के उदाहरण में, आप देख सकते हैं कि हम उस लाइन के समान इंडेंटेशन स्तर पर कमेंट करते हैं जिसका हम संदर्भ दे रहे हैं। जब हम अपने Python if स्टेटमेंट पर चर्चा कर रहे हैं, उदाहरण के लिए, हमने अपने कमेंट को अपने कोड के साथ इंडेंट किया है।

ये सिंगल लाइन कमेंट्स लिखकर, हमारा प्रोग्राम कोड के लेखक दोनों के लिए अधिक पठनीय है। हमारा प्रोग्राम किसी और के लिए भी पढ़ना आसान है जो हमारे प्रोग्राम को देख सकता है।

Python Inline Comments

Python इंलाइन कमेंट्स स्टेटमेंट के समान लाइन पर लिखे जाते हैं, कोड लिखे जाने के बाद। इंलाइन कमेंट्स को कोड की एक लाइन के उद्देश्य या यह कैसे काम करता है यह समझाना चाहिए।

इंलाइन कमेंट के लिए सिंटैक्स यहाँ है:

print(students) # Print the variable "students"

इंलाइन कमेंट्स उपयोगी हैं यदि आपको कोड के जटिल भागों को समझाने की आवश्यकता है। वे तब भी उपयोगी हैं यदि आपको लगता है कि आप भविष्य में भूल सकते हैं कि कोड की एक विशिष्ट लाइन कैसे काम करती है।

इंलाइन कमेंट्स तब भी उपयोगी हैं यदि आप टीम में काम कर रहे हैं और यह सुनिश्चित करने की आवश्यकता है कि हर कोई एक विशिष्ट लाइन को समझता है।

अन्य प्रकार के कमेंट्स के विपरीत, केवल कभी-कभी इंलाइन कमेंट्स का उपयोग करें। ऐसा इसलिए है क्योंकि बहुत सारे इंलाइन कमेंट्स प्रोग्राम को पढ़ना कठिन बना देते हैं।

Python Multiline Comments

Python मल्टीलाइन कमेंट्स, या Python ब्लॉक कमेंट्स, उस कोड को समझाते हैं जो या तो अधिक जटिल है या जिसका उद्देश्य तुरंत स्पष्ट नहीं है। आप किसी बाहरी लाइब्रेरी का उपयोग करने वाले अद्वितीय फ़ंक्शन को समझाने के लिए ब्लॉक कमेंट का उपयोग कर सकते हैं, उदाहरण के लिए।

ब्लॉक कमेंट्स Python में मल्टी-लाइन कमेंट्स हैं और उनके नीचे कुछ या सभी कोड पर लागू होते हैं। ब्लॉक कमेंट्स, किसी अन्य कमेंट की तरह, उस कोड के समान स्तर पर इंडेंटेड होते हैं जिस पर कमेंट चर्चा कर रहा है।

Multiline Comment उदाहरण

यहाँ Python sort() फ़ंक्शन को समझाने वाले मल्टीलाइन स्ट्रिंग का एक उदाहरण है:

# The sortStudents function will parse arguments via the "student" variable. The
# function simply returns the length of each student's name. We reference the sortStudents
# function in the sort() function later in the code, which iterates over each item in the
# "students" array and executes our sortStudents function.
def sortStudents(student):
    return len(student)
students = ["Nathan", "Alyssa", "Matthew", "Malcolm", "Alexis", "Katie"]
students.sort(key=sortStudents)

हमारा कमेंट कई लाइनों तक फैला हुआ है और इसके नीचे लिखे कोड का उद्देश्य बताता है।

जबकि कुछ डेवलपर्स इस कोड को समझ सकते हैं, अन्य प्रोग्रामर्स इस बारे में भ्रमित हो सकते हैं कि यह कैसे काम करता है या इसे क्यों लिखा गया है। ब्लॉक कमेंट का उपयोग पूरी प्रक्रिया को समझाने का एक शानदार तरीका है। ब्लॉक कमेंट्स किसी अन्य कोड को समझाने के लिए उपयोगी हैं जिसका उद्देश्य डेवलपर के लिए तुरंत स्पष्ट नहीं है।

निष्कर्ष

यही है Python में कमेंट कैसे करते हैं! कमेंट्स का उपयोग करके, आप अपने प्रोग्राम्स को सभी के लिए अधिक पठनीय बना सकते हैं, जिसमें आप स्वयं भी शामिल हैं।

अच्छी तरह से लिखे गए कमेंट्स आपको आगे बढ़ते हुए अपने कोड का ट्रैक रखने में मदद कर सकते हैं। वे आपको एक रिकॉर्ड बनाए रखने की अनुमति देते हैं जिसे बाद में संदर्भित किया जा सकता है यदि आप बाद में अपने कोड को समझने में संघर्ष कर रहे हैं।

क्या आप चुनौती के लिए तैयार हैं? अपने प्रोग्राम्स में से एक के शीर्ष पर ब्लॉक कमेंट लिखें। इस कमेंट में शामिल होना चाहिए:

• आपका नाम
• जब आपने फ़ाइल बनाई
• फ़ाइल का नाम
• फ़ाइल का उद्देश्य

अपना कोड चलाने का प्रयास करें। यदि आपका प्रोग्राम कमेंट के कारण नहीं चलता है, तो आपने त्रुटि की है। यदि आपका प्रोग्राम सामान्य रूप से चलता है, तो बधाई! आपने सफलतापूर्वक कमेंट लिखा है।

इस ट्यूटोरियल में, हमने Python में कमेंट्स, इंलाइन कमेंट्स, और ब्लॉक कमेंट्स कैसे लिखें, इसका पता लगाया। हमने यह भी चर्चा की कि कैसे कुछ डेवलपर्स परीक्षण के लिए कमेंट्स लिखते हैं। अब आप Python विशेषज्ञ की तरह कमेंट्स लिख सकते हैं!

Python प्रोग्रामिंग भाषा में मास्टर बनना चाहते हैं? शीर्ष Python कोर्सेज, किताबें, और सीखने के संसाधनों पर समर्थन के लिए, हमारा व्यापक How to Learn Python गाइड देखें।