← Back to Kotlin Course | Chapter 1: Setup & Basics | Lesson 7 of 7

Kotlin में Comments

Comments code के अंदर छोड़े गए छोटे notes हैं जिन्हें computer नज़रअंदाज़ करता है, लेकिन जो लोगों को यह समझने में मदद करते हैं कि code क्या कर रहा है।
Syntax
kotlin
// single-line comment

/* multi-line
   block comment */

/**
 * KDoc documentation comment
 */

Single-Line Comments

एक double slash // उस line पर इसके बाद की हर चीज़ को एक comment के रूप में चिह्नित करता है, जिसे compiler पूरी तरह नज़रअंदाज़ करता है। यह code के साथ छोटे notes छोड़ने का सबसे आम तरीका है।

उदाहरण: Single-Line Comments

markup
fun main() {
    // This line prints a greeting
    println("Hello!") // greeting printed here
}

Multi-Line Block Comments

text को /* और */ में wrap करना एक block comment बनाता है जो कई lines तक फैल सकता है, लंबी explanations के लिए उपयोगी। Kotlin, Java के विपरीत, इन block comments को एक-दूसरे के अंदर nest होने की भी अनुमति देता है।

उदाहरण: Multi-Line Block Comments

markup
fun main() {
    /*
     * This program demonstrates block comments.
     * They can span several lines.
     */
    println("Block comments explained above")
}

Documentation Comments (KDoc)

/** से शुरू होने वाले comments KDoc comments हैं, जो functions और classes को document करने के लिए उपयोग होते हैं ताकि tools Java में Javadoc जैसी reference documentation अपने आप generate कर सकें।

उदाहरण: Documentation Comments (KDoc)

markup
/**
 * Greets a person by name.
 */
fun greet(name: String) {
    println("Hello, $name!")
}

fun main() {
    greet("Kotlin")
}

Writing Useful Comments

सबसे अच्छे comments यह समझाते हैं कि code का कोई टुकड़ा *क्यों* मौजूद है या कोई decision क्यों लिया गया, यह नहीं कि यह स्पष्ट रूप से क्या करता है। जो comments सिर्फ code को दोहराते हैं वे समझ बढ़ाए बिना गंदगी जोड़ते हैं।

Note: अगर आपको लगे कि किसी line *क्या करती है* इस पर comment चाहिए, तो इसके बजाय variables/functions का नाम ऐसा रखने पर विचार करें कि code खुद-स्पष्ट हो जाए।

उदाहरण: Writing Useful Comments

markup
fun main() {
    // Using 0.5 as a discount rate agreed with the finance team
    val discountRate = 0.5
    println("Discount rate: $discountRate")
}
Related Topics
{# common_mistakes/chapter_summary/browser_support: on Hindi pages the view already swaps in the hi_ translation fields (or blanks these out if untranslated), so this renders correctly for both languages without a lang_code check here. #}
आम गलतियां
  1. यह भूल जाना कि // सिर्फ उस single line के बाकी हिस्से को comment करता है, इसलिए उसी line पर उसके बाद का code तो ठीक है लेकिन अगली line सामान्य रूप से चलती है।
  2. /* */ block comments को गलत तरीके से nest करना, यह न समझते हुए कि Kotlin असल में Java के विपरीत nested block comments को support करता है।
  3. ऐसे comments लिखना जो सिर्फ वह दोहराएं जो code पहले से कहता है, बजाय यह समझाने के कि यह *क्यों* मौजूद है।
चैप्टर सारांश
  • // एक single-line comment शुरू करता है जो उस line के अंत तक जारी रहता है।
  • /* ... */ एक multi-line block comment को चिह्नित करता है, और Kotlin इन्हें nested होने देता है।
  • KDoc comments /** ... */ से शुरू होते हैं और functions और classes के लिए documentation generate करने के लिए उपयोग होते हैं।
  • अच्छे comments intent और reasoning समझाते हैं, सिर्फ वह नहीं दोहराते जो code स्पष्ट रूप से करता है।
🔒

Chapter Quiz — Complete all 7 topics to unlock

0/7 topics done

Complete these topics first:

Login to run this code

C/C++/Java/PHP execution requires a free account. Your code is saved — you'll land right back in the editor after logging in.