पायथन टिप्पणी:एक चरण-दर-चरण मार्गदर्शिका

पायथन टिप्पणी एक प्रोग्राम में पाठ की एक पंक्ति है जिसे दुभाषिया द्वारा निष्पादित नहीं किया जाता है। टिप्पणियों का उपयोग डिबगिंग के दौरान मुद्दों की पहचान करने और कोड की व्याख्या करने के लिए किया जाता है। टिप्पणियाँ एक हैश वर्ण (#) से शुरू होती हैं।

पायथन में कैसे कमेंट करें

टिप्पणियाँ उन नोट्स या कोड को दर्शाती हैं जिन्हें आप नहीं चाहते कि पायथन चले। उदाहरण के लिए, मान लें कि आप घंटों की अवधि में एक जटिल प्रक्रिया लिख ​​रहे हैं। कोड की प्रत्येक पंक्ति क्या करती है, इस पर नज़र रखने के लिए आप कुछ टिप्पणियां लिखना चाह सकते हैं ताकि आप ट्रैक न खोएं।

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

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

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

पायथन टिप्पणी क्या है?

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

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

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

81% प्रतिभागियों ने कहा कि बूटकैंप में भाग लेने के बाद उन्हें अपनी तकनीकी नौकरी की संभावनाओं के बारे में अधिक आत्मविश्वास महसूस हुआ। आज ही एक बूटकैंप से मिलान करें।

बूटकैंप शुरू करने से लेकर अपनी पहली नौकरी खोजने तक, औसत बूटकैंप ग्रेड ने करियर संक्रमण में छह महीने से भी कम समय बिताया।

# This is a demo comment

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

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

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

पायथन टिप्पणियों का उदाहरण

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

लूप के लिए पायथन में, आपके पास ऐसी टिप्पणियां हो सकती हैं जो इस तरह दिखती हैं:

# 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)

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

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

# 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.")

यह कार्यक्रम छात्रों और उनके ग्रेड की एक सूची लेता है। फिर, हमारा कार्यक्रम छात्रों की सूची से गुजरता है। हम जाँचते हैं कि क्या प्रत्येक छात्र अपनी परीक्षा उत्तीर्ण या अनुत्तीर्ण हुआ है।

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

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

पायथन इनलाइन टिप्पणियाँ

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

इनलाइन टिप्पणी के लिए सिंटैक्स यहां दिया गया है:

print(students) # Print the variable "students"

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

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

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

पायथन मल्टीलाइन टिप्पणियाँ

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

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

मल्टीलाइन टिप्पणी उदाहरण

यहां एक मल्टीलाइन स्ट्रिंग का उदाहरण दिया गया है जो पायथन सॉर्ट () फ़ंक्शन की व्याख्या करता है:

# 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)

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

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

निष्कर्ष

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

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

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

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

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

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

पायथन प्रोग्रामिंग भाषा में महारत हासिल करना चाहते हैं? पायथन के शीर्ष पाठ्यक्रमों, पुस्तकों और सीखने के संसाधनों पर समर्थन के लिए, हमारी व्यापक 'हाउ टू लर्न पायथन' मार्गदर्शिका देखें।