Java की टिप्पणियाँ

आप फ़ाइल में अपने लिए एक टिप्पणी रखना चाहते हैं, और चाहते हैं कि स्क्रीन वही रहे। स्क्रीन अब भी mint है। टिप्पणी उस व्यक्ति के लिए है जो Mint.java पढ़ता है। वह स्क्रीन के लिए कोई शब्द नहीं है। यह पन्ना उस टिप्पणी को दो रूपों में रखता है, दिखाता है कि mint अब भी अकेली पंक्ति है, और फिर वह एक जगह दिखाता है जहाँ mint स्क्रीन से मिट जाता है। आप Java फिर से स्थापित नहीं कर रहे। आप यह नहीं ढूँढ़ रहे कि कौन-सी पंक्ति स्क्रीन लिखती है। आप जानते हैं कि वह पंक्ति System.out.println("mint") है। नया काम उसी के पास की टिप्पणी है।

टिप्पणी आदेश नहीं है

आदेश वह पंक्ति है जिसे Java चलाता है। System.out.println("mint") एक आदेश है। वह mint लिखता है और पंक्ति खत्म करता है। टिप्पणी वह शब्द हैं जिन्हें आप फ़ाइल में छोड़ते हैं ताकि आप, या अगला पढ़ने वाला, कोई बात याद रखे। Java टिप्पणी को छोड़ देता है। छोड़ना यह है कि टिप्पणी चलाई नहीं जाती, और स्क्रीन पर लिखी नहीं जाती। टिप्पणी के अक्षर चलने के बाद भी फ़ाइल में रहते हैं। आप Mint.java खोलकर उन्हें पढ़ सकते हैं। स्क्रीन पर वे नहीं मिलते। स्क्रीन पर अब भी एक पंक्ति है, और वह पंक्ति mint है, जब तक लिखने वाला आदेश खुद टिप्पणी न बना हो।

दो रूप हैं। पंक्ति-टिप्पणी दो तिरछी रेखाओं से शुरू होती है: //। Java उन दो रेखाओं से उसी पंक्ति के अंत तक छोड़ देता है। अगली पंक्ति फिर सामान्य पंक्ति होती है। दूसरा रूप / से शुरू होता है और पहली / पर खत्म होता है। Java इन दो चिह्नों के बीच की हर चीज़ छोड़ देता है, अगली पंक्ति पर जाना भी। यह टिप्पणी एक पंक्ति में हो सकती है या कई पंक्तियों में। दोनों रूप टिप्पणी हैं। कोई भी स्क्रीन नहीं लिखता। तिरछी रेखाएँ नहीं छपतीं। तारे नहीं छपते। उनके बीच जो शब्द आप रखते हैं, वे भी नहीं छपते।

वह फ़ाइल जिसे आप रखते हैं

इसे Mint.java नाम से सहेजिए। यही वह फ़ाइल है जिसे यह पन्ना रखता है। इसमें लिखने वाले आदेश के ऊपर एक पंक्ति-टिप्पणी है, लिखने वाले आदेश की अपनी पंक्ति पर एक और, और main के ऊपर एक पंक्ति-टिप्पणी। लिखने वाला आदेश अब भी वहीं है, और वह तिरछी रेखा के पीछे नहीं है।

ऊपर से पढ़िए, और हर पंक्ति के लिए तय कीजिए कि स्क्रीन उसे लेती है या नहीं। पहली पंक्ति अब भी public class Mint है। आप जानते हैं कि यह पंक्ति फ़ाइल का नाम बताती है और स्क्रीन नहीं लिखती। अगली पंक्ति // the file is named Mint.java है। दो तिरछी रेखाएँ टिप्पणी शुरू करती हैं, इसलिए शब्द the file is named Mint.java आपके लिए हैं। स्क्रीन उन्हें नहीं दिखाती। तिरछी रेखाएँ भी नहीं दिखाती। पंक्ति public static void main(String[] args) वह जगह है जहाँ Java शुरू होता है, और उन शब्दों में से कोई भी स्क्रीन पर नहीं है। यह नहीं बदला।

main के अंदर, पंक्ति // a note for the reader केवल टिप्पणी है। Java उसे पढ़ता है, छोड़ देता है, और अगली पंक्ति पर जाता है। अगली पंक्ति वही है जो मायने रखती है: System.out.println("mint"); // the screen is this word। इस पंक्ति को दो टुकड़ों में पढ़िए, जिन्हें तिरछी रेखाएँ अलग करती हैं। रेखाओं से पहले आदेश System.out.println("mint"); है। यह आदेश mint लिखता है और पंक्ति खत्म करता है। रेखाओं के बाद शब्द the screen is this word टिप्पणी हैं। वे आदेश वाली ही पंक्ति पर बैठे हैं, और फिर भी छोड़ दिए जाते हैं। टिप्पणी को अकेली पूरी पंक्ति लेना ज़रूरी नहीं। अगर आप खत्म हो चुके आदेश के बाद // लिखते हैं, तो आदेश चलता है और पंक्ति का बाकी हिस्सा नहीं चलता। अर्धविराम आदेश को खत्म करता है। अर्धविराम के बाद की तिरछी रेखाएँ टिप्पणी शुरू करती हैं। अर्धविराम को वहीं रहने दीजिए। स्क्रीन mint दिखाती है। the screen is this word नहीं दिखाती। दूसरी पंक्ति भी नहीं दिखाती।

इसे पहले की तरह चलाइए। जिस फ़ोल्डर में यह Mint.java है, वहाँ javac Mint.java टाइप कीजिए। जब फ़ाइल ठीक हो, यह आदेश कोई पंक्ति नहीं लिखता। टिप्पणियाँ javac से पंक्ति नहीं लिखवातीं, और उसे असफल भी नहीं करतीं। फिर java Mint टाइप कीजिए। java के बाद .java न लिखिए। स्क्रीन mint दिखाती है। एक पंक्ति। उद्धरण चिह्न नहीं। तिरछी रेखा नहीं। दूसरी पंक्ति नहीं। शब्द mint अब भी वही शब्द है जो उद्धरण चिह्नों के बीच है। वह कोई शब्द नहीं जिसे आपने आदेश में टाइप किया हो, और कोई शब्द नहीं जिसे आपने टिप्पणी में टाइप किया हो।

/ और / के बीच की टिप्पणी

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

main के अंदर की पंक्ति-टिप्पणियों की जगह / और / के बीच की एक टिप्पणी रखिए, और लिखने वाला आदेश अपनी जगह छोड़ दीजिए। स्क्रीन नहीं बदलती। यह दूसरी फ़ाइल है। आप टिप्पणी का रूप देख रहे हैं। जो फ़ाइल आप रख रहे थे, उसमें पंक्ति-टिप्पणियाँ थीं। इसमें / और / के बीच की टिप्पणी है। दोनों mint लिखती हैं।

टिप्पणी उस पंक्ति से शुरू होती है जो / से शुरू होती है। शब्द a note उसके अंदर हैं। अगली पंक्ति, across two lines, भी अंदर है, क्योंकि बंद करने वाला / अभी लिखा नहीं गया। उस दूसरी पंक्ति के अंत का / टिप्पणी खत्म करता है। उसके बाद Java आदेश System.out.println("mint"); चलाता है, क्योंकि यह आदेश टिप्पणी के बाहर है, अंत के चिह्न के नीचे। स्क्रीन mint दिखाती है। शब्द a note और across two lines स्क्रीन पर नहीं हैं। तारे और तिरछी रेखाएँ स्क्रीन पर नहीं हैं। अगर आप / को ऊपर ले जाएँ ताकि वह पहली पंक्ति पर बैठे, a note के ठीक बाद, तो दूसरी पंक्ति अब टिप्पणी के अंदर नहीं रहती। वह दूसरी पंक्ति असली Java पंक्ति होनी चाहिए, और across two lines आदेश नहीं है। तब javac चुप रहने की जगह त्रुटि लिखेगा। इस पन्ने पर */ दूसरी पंक्ति के अंत में रहता है, इसलिए पूरी टिप्पणी छोड़ दी जाती है और javac चुप रहता है।

एक ऐसी टिप्पणी के अंदर दूसरी रखने की कोशिश न कीजिए। पहली / टिप्पणी खत्म कर देती है, भले ही आप चाहते हों कि वही / भीतरी टिप्पणी खत्म करे। उस पहले अंत-चिह्न के बाद Java फिर आदेश पढ़ता है। यह पन्ना टिप्पणी के अंदर टिप्पणी नहीं रखता। एक शुरू, एक अंत, फिर लिखने वाला आदेश।

वह ग़लती जो mint मिटा देती है

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

javac Mint.java अब भी कोई पंक्ति नहीं लिखता, क्योंकि जो फ़ाइल केवल एक टिप्पणी छोड़ती है, वह अब भी वैध फ़ाइल है। Java main से शुरू होता है, उसके अंदर की अकेली पंक्ति छोड़ देता है, और खत्म हो जाता है। फिर java Mint कुछ नहीं लिखता। mint नहीं है। उद्धरण चिह्नों के बीच कोई खाली शब्द नहीं है। दूसरी पंक्ति नहीं है। स्क्रीन खाली है क्योंकि जो आदेश mint लिखता था, वह // के पीछे है। अक्षर System.out.println("mint") अब भी फ़ाइल में हैं, और आप उन्हें पढ़ सकते हैं, पर अब वे टिप्पणी हैं। उद्धरण चिह्न उन्हें नहीं बचाते। उद्धरण चिह्न आदेश के अंदर एक शब्द को चिह्नित करते हैं। वे टिप्पणी को वापस आदेश नहीं बनाते। आगे की दो तिरछी रेखाएँ तय करती हैं, और वे तय करती हैं कि पंक्ति का बाकी हिस्सा पढ़ने वाले के लिए है।

फ़ाइल को वापस वही कर दीजिए जिसे आप रखते हैं। लिखने वाली पंक्ति System.out.println("mint"); होनी चाहिए, और टिप्पणी, अगर आप रखें, अर्धविराम के बाद। तब java Mint फिर mint लिखता है। अगर स्क्रीन खाली है, तो System.out से पहले // ढूँढ़िए। यही पूरी जाँच है। टिप्पणी की वजह से खाली स्क्रीन के लिए Java फिर से स्थापित नहीं करना।

टिप्पणी में कोई भी शब्द हो सकते हैं, Mint, main और mint भी। वे शब्द फिर भी स्क्रीन पर नहीं होते। स्क्रीन उस शब्द का इस्तेमाल करती है जो सच में चलने वाले आदेश के उद्धरण चिह्नों के बीच है। जिस फ़ाइल को आप रखते हैं, उसमें वह शब्द mint है, छोटे m के साथ। जो टिप्पणी Mint कहे, बड़े M के साथ, वह स्क्रीन पर Mint नहीं दिखाती। जो टिप्पणी mint दोहराए, वह दूसरी पंक्ति नहीं लिखती। चलाना टिप्पणी को फ़ाइल से नहीं मिटाता। java Mint के बाद फ़ाइल खोलिए: टिप्पणी अब भी वहीं है।

अब आप Mint.java में टिप्पणी रख सकते हैं और स्क्रीन नहीं बदलती। पंक्ति-टिप्पणी // से शुरू होती है। / और / के बीच की टिप्पणी / से शुरू होती है और पहली / पर खत्म होती है। जिस फ़ाइल को आप रखते हैं, उसकी स्क्रीन mint है, जिसे System.out.println("mint") लिखता है। अगर // उस आदेश के आगे हो, तो स्क्रीन पर कोई पंक्ति नहीं। अगला पन्ना उद्धरण चिह्नों के बीच का शब्द बदलता है, इसलिए स्क्रीन दूसरा शब्द दिखाती है। इस पन्ने की टिप्पणियाँ टिप्पणियाँ ही रहती हैं।

स्क्रीन अब भी mint है

जिस फ़ाइल को आप रखते हैं, वह mint लिखती है। // से शुरू होने वाली टिप्पणियाँ स्क्रीन पर नहीं हैं। / और / के बीच की टिप्पणी स्क्रीन पर नहीं है। पहली */ उस टिप्पणी को खत्म करती है। स्क्रीन पर एक पंक्ति है। दूसरी पंक्ति नहीं है।