Kotlin में Comments
In this page:
// single-line comment
/* multi-line
block comment */
/**
* KDoc documentation comment
*/
Single-Line Comments
एक double slash // उस line पर इसके बाद की हर चीज़ को एक comment के रूप में चिह्नित करता है, जिसे compiler पूरी तरह नज़रअंदाज़ करता है। यह code के साथ छोटे notes छोड़ने का सबसे आम तरीका है।
उदाहरण: Single-Line Comments
fun main() {
// This line prints a greeting
println("Hello!") // greeting printed here
}
Login to try C/C++/Java/PHP code in the editor
Multi-Line Block Comments
text को /* और */ में wrap करना एक block comment बनाता है जो कई lines तक फैल सकता है, लंबी explanations के लिए उपयोगी। Kotlin, Java के विपरीत, इन block comments को एक-दूसरे के अंदर nest होने की भी अनुमति देता है।
उदाहरण: Multi-Line Block Comments
fun main() {
/*
* This program demonstrates block comments.
* They can span several lines.
*/
println("Block comments explained above")
}
Login to try C/C++/Java/PHP code in the editor
Documentation Comments (KDoc)
/** से शुरू होने वाले comments KDoc comments हैं, जो functions और classes को document करने के लिए उपयोग होते हैं ताकि tools Java में Javadoc जैसी reference documentation अपने आप generate कर सकें।
उदाहरण: Documentation Comments (KDoc)
/**
* Greets a person by name.
*/
fun greet(name: String) {
println("Hello, $name!")
}
fun main() {
greet("Kotlin")
}
Login to try C/C++/Java/PHP code in the editor
Writing Useful Comments
सबसे अच्छे comments यह समझाते हैं कि code का कोई टुकड़ा *क्यों* मौजूद है या कोई decision क्यों लिया गया, यह नहीं कि यह स्पष्ट रूप से क्या करता है। जो comments सिर्फ code को दोहराते हैं वे समझ बढ़ाए बिना गंदगी जोड़ते हैं।
उदाहरण: Writing Useful Comments
fun main() {
// Using 0.5 as a discount rate agreed with the finance team
val discountRate = 0.5
println("Discount rate: $discountRate")
}
Login to try C/C++/Java/PHP code in the editor
- यह भूल जाना कि
//सिर्फ उस single line के बाकी हिस्से को comment करता है, इसलिए उसी line पर उसके बाद का code तो ठीक है लेकिन अगली line सामान्य रूप से चलती है। /* */block comments को गलत तरीके से nest करना, यह न समझते हुए कि Kotlin असल में Java के विपरीत nested block comments को support करता है।- ऐसे 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: