कोड में जानकारी जोड़ने के लिए टिप्पणियों का उपयोग किया जाता है। यह ज्यादातर संकलक द्वारा अनदेखा किया जाता है, लेकिन मानव विशेषज्ञ उन टिप्पणियों को पढ़ सकते हैं जब वे आपका कोड देखते हैं। डेवलपर्स के लिए टिप्पणियाँ आवश्यक हैं क्योंकि उनके पास सीमित समय है, और टिप्पणी करने से उन्हें एक ही बार में मूल्यवान जानकारी प्राप्त करने या कोड के संबंध में कुछ महत्वपूर्ण विवरण नोट करने की अनुमति मिलती है। इस डेटा तक पहुँचने से वे सही निर्णय ले सकते हैं और तेज़ी से काम कर सकते हैं।
टिप्पणी करना मेरे लिए कैसे उपयोगी हो सकता है?
टिप्पणियाँ आपके लिए व्यक्तिगत रूप से और किसी के लिए भी उपयोगी हैं जिन्हें बाद में इस कोड को पढ़ने या संपादित करने की आवश्यकता हो सकती है। लेकिन वास्तव में कैसे?
- कोडिंग करते समय टिप्पणियाँ प्लेसहोल्डर हो सकती हैं। उस समय आप कुछ मान सकते हैं, और आपको पता चल जाएगा कि भविष्य में आपकी धारणा सही है या नहीं।
- टिप्पणियां आपके विचारों का दस्तावेजीकरण कर सकती हैं या आपके लिए नोट्स बन सकती हैं ताकि बाद में उनके पास वापस आने पर आप अपने कार्यों को न भूलें।
- आपने अपने कोड में जो कुछ किया है उस पर टिप्पणी शामिल कर सकते हैं ताकि अन्य प्रोग्रामर इसे बेहतर और जल्दी समझ सकें (कोडर्स का समय बहुत, बहुत महंगा है)।
- आप टिप्पणियों का उपयोग अस्थायी रूप से अक्षम करने या छोटी गाड़ी के हिस्सों को सक्षम करने के लिए कर सकते हैं।
- स्क्रिप्ट की प्रत्येक पंक्ति पर टिप्पणी करने से यह ट्रैक करना आसान हो जाता है कि प्रोग्राम में बग कहां हो सकते हैं।
- टिप्पणियां बता सकती हैं कि कोड की कुछ पंक्तियाँ क्या कर रही हैं, या आपने किसी गलतफहमी से बचने के लिए कुछ विशेष दृष्टिकोण क्यों चुना (उदाहरण के लिए, जब कोड के कुछ हिस्से किसी अनुभाग या विशेष उद्देश्य के लिए अभिप्रेत हैं जिसे आपको स्पष्ट रूप से समझना चाहिए) ,
- यदि आप नए लोगों या अन्य परियोजनाओं के लोगों के लिए आवश्यक हो तो कोड अनुभाग के बारे में सभी विवरणों को समझाते हुए एक संपूर्ण पैराग्राफ लिख सकते हैं। इनर जॉइन, ग्रुप बाय, आदि जैसे कई क्लॉज के साथ जटिल एसक्यूएल प्रश्नों को लिखते समय अक्सर टिप्पणी की आवश्यकता होती है।
- टिप्पणी करने से आप अपने काम के बारे में नोट्स बना सकते हैं। इससे दूसरों को यह समझने में मदद मिलती है कि आपने कुछ कैसे और क्यों किया ताकि वे इसे आवश्यकतानुसार बनाए रख सकें या संशोधित कर सकें।
क्या SQL टिप्पणियों के लिए एक अच्छी भाषा है?
हां! टिप्पणियाँ अक्सर SQL और PHP जैसी भाषाओं के संयोजन में उपयोग की जाती हैं जहाँ हम उन्हें टिप्पणी फ़ंक्शन * / (जैसे, /* यह मेरी टिप्पणी */) का उपयोग करके टेक्स्ट फ़ाइल या स्क्रिप्ट में सम्मिलित कर सकते हैं। वे आम तौर पर कहीं और भी उपयोग करने में आसान होते हैं।
एसक्यूएल में कमेंट कैसे करें?
टिप्पणी फ़ंक्शन आपको SQL में कोई टिप्पणी जोड़ने के लिए कोई भी टेक्स्ट लिखने देगा। यह अंतिम आउटपुट को तब तक प्रभावित नहीं करता है जब तक कि यह एक निश्चित पूर्व-क्रमादेशित वर्ण के पहले या बाद में आता है।
SQL में टिप्पणियाँ जोड़ने के लिए, आप निम्न प्रतीकों का उपयोग कर सकते हैं:/* */ या # या — (डबल-डैश).
/* */ किसी भी स्थिति के लिए काम करेगा जहां आप उस बिंदु पर अपनी टिप्पणी शुरू करना और समाप्त करना चाहते हैं बिना किसी और चीज (जैसे सिंगल कोट्स) का उपयोग किए।
# एक समय में कोड की एक पंक्ति के लिए उपयोग किया जाता है
— एक समय में एक कोड लाइन के लिए भी लागू होता है। इस डबल डैश के बाद स्पेस देना न भूलें।
आपके कोड में यह इस प्रकार दिखेगा:
-- this is a comment# this is also a comment/*
multiline
comment
*/
यहाँ एक-पंक्ति और बहु-पंक्ति टिप्पणियों के बीच अंतर है:
mysql> SELECT 1+1; # This comment continues to the end of line
mysql> SELECT 1+1; -- This comment continues to the end of line
mysql> SELECT 1 /* this is an in-line comment */ + 1;
mysql> SELECT 1+
/*
this is a
multiple-line comment
*/
1;
यहां एक बहु-पंक्ति टिप्पणी का एक और उदाहरण दिया गया है:
SELECT contact_id, last_name, first_name
/*
* Author: TechOnTheNet.com
* Purpose: To show a comment that spans multiple lines in your SQL
* statement in MySQL.
*/
FROM contacts;
# चिह्न का उपयोग करके टिप्पणी करना
बुनियादी हैश कमेंटिंग स्टाइल को इस तरह टेक्स्ट में डाला जा सकता है:
Select * from users ; # this will list usersडबल-डैश (-) का उपयोग करके टिप्पणी करना
यह कमोबेश एक जैसा है (स्पेस को मत भूलना)। मानक SQL के लिए वास्तव में आपको वहां स्थान का उपयोग करने की आवश्यकता नहीं होती है, लेकिन MySQL इसका उपयोग SELECT 10–1 जैसी कमांड की समस्याओं से बचने के लिए करता है।
Select * from users ; -- this will list users/ * और * / चिह्नों का उपयोग करके टिप्पणी करना
यह बहुपंक्ति टिप्पणी, पिछले दो उदाहरणों के विपरीत, पंक्ति के अंत में रुकने की आवश्यकता नहीं है।
Select * from users ; /* this will list users */निष्पादन योग्य टिप्पणियाँ
एक नियम के रूप में, टिप्पणियों को दूसरे छोर पर किसी के द्वारा अनदेखा किया जाता है (क्योंकि वे केवल प्रोग्रामर के लिए हैं), लेकिन कुछ टिप्पणी प्रकार - निष्पादन योग्य टिप्पणियां - कुछ सिस्टम पर चलने वाले कोड को सक्षम करते हैं।
हमारे मामले में, निष्पादन योग्य टिप्पणियां आपको SQL कोड का उपयोग करने की अनुमति देती हैं जिन्हें केवल MYSQL में निष्पादित किया जाएगा, अन्य डेटाबेस में नहीं।
निष्पादन योग्य टिप्पणियां तारांकित स्लैश . के भीतर होनी चाहिए , हमेशा की तरह कोड के साथ:
<मजबूत>/*! MySQL-विशिष्ट कोड */
हालांकि, इन निष्पादन योग्य टिप्पणियों के लिए नीचे की तरह एक विशिष्ट सिंटैक्स की आवश्यकता होती है:
/*!##### MySQL-विशिष्ट कोड */
आपको !##### . की आवश्यकता है निष्पादन योग्य टिप्पणियों को संकेत देने के लिए भाग। यह MYSQL के न्यूनतम संस्करण का प्रतिनिधित्व करता है जो कमेंट्री निष्पादित कर सकता है।
पहले हैश के बजाय, MYSQL के मुख्य संस्करण को बदलें। दूसरे के बजाय, छोटे संस्करण और पैच के संस्करणों को अंतिम 2 के लिए प्रतिस्थापित किया जाता है।
केवल MySQL 5.1.10 या बाद का संस्करण निम्नलिखित टिप्पणियों को चला सकता है:
CREATE TABLE t1 (
k INT AUTO_INCREMENT,
KEY (k)
) /*!50110 KEY_BLOCK_SIZE=1024; */
निष्कर्ष
टिप्पणियाँ अधिक विवरण जोड़कर कार्यक्रमों को पढ़ना आसान बनाती हैं। आप उनके बारे में कुछ हद तक हैश के समान सोच सकते हैं - वे कोड को समझने के लिए आवश्यक समय को कम करते हैं या पाठ के सार को पकड़ने वाले स्निपेट प्रदान करके इसके कुछ हिस्सों की पहचान करते हैं। यदि आपने कभी शून्य-ज्ञान प्रमाण के साथ काम किया है या Google के माध्यम से Facebook में लॉग इन करने का प्रयास किया है, तो आपको पता चल जाएगा कि हमारा क्या मतलब है।
इसलिए अपने कोड पर टिप्पणी करना और यह जानना आवश्यक है कि इसे सही तरीके से कैसे किया जाए। सूचनात्मक नोटों के साथ अपने कोड को सटीक रखने से सभी शामिल विशेषज्ञों का जीवन आसान हो जाता है।
