التعليق هو شرح أو تعليق توضيحي يمكن قراءته بواسطة المبرمج في كود مصدر Kotlin. تتم إضافتها بغرض تسهيل فهم البشر للكود المصدري، ويتم تجاهلها بواسطة مترجم Kotlin.
تمامًا مثل معظم اللغات الحديثة، تدعم Kotlin التعليقات ذات السطر الواحد (أو نهاية السطر) والتعليقات متعددة الأسطر (الكتلة). تعليقات Kotlin تشبه إلى حد كبير التعليقات المتوفرة في لغات البرمجة Java وC وC++.
تعليقات Kotlin ذات السطر الواحد
تبدأ تعليقات السطر الواحد في Kotlin بشرطين مائلتين للأمام وتنتهي بنهاية السطر. لذا فإن أي نص مكتوب بين // ونهاية السطر يتم تجاهله بواسطة مترجم Kotlin.
فيما يلي نموذج لبرنامج Kotlin الذي يستخدم تعليقًا من سطر واحد:
// This is a comment
fun main() {
println("Hello, World!")
}
عند تشغيل برنامج Kotlin أعلاه، فإنه سيولد المخرجات التالية:
Hello, World!
يمكن أن يبدأ التعليق بسطر واحد من أي مكان في البرنامج وينتهي حتى نهاية السطر. على سبيل المثال، يمكنك استخدام تعليق سطر واحد على النحو التالي:
fun main() {
println("Hello, World!") // This is also a comment
}
تعليقات Kotlin متعددة الأسطر
يبدأ التعليق متعدد الأسطر في Kotlin بـ /* وينتهي بـ /. لذلك سيتم التعامل مع أي نص مكتوب بين / و */ كتعليق وسيتم تجاهله بواسطة مترجم Kotlin.
تسمى التعليقات متعددة الأسطر أيضًا بحظر التعليقات في Kotlin.
فيما يلي نموذج لبرنامج Kotlin الذي يستخدم تعليقًا متعدد الأسطر:
/* This is a multi-line comment and it can span
* as many lines as you like
*/
fun main() {
println("Hello, World!")
}
عند تشغيل برنامج Kotlin أعلاه، فإنه سيولد المخرجات التالية:
Hello, Word!
تعليقات Kotlin المتداخلة
يمكن أن تكون التعليقات في Kotlin متداخلة، مما يعني أنه يمكن وضع تعليق من سطر واحد أو تعليقات متعددة الأسطر داخل تعليق متعدد الأسطر على النحو التالي:
/* This is a multi-line comment and it can span
* as many lines as you like
/* This is a nested comment */
// Another nested comment
*/
fun main() {
println("Hello, World!")
}
عند تشغيل برنامج Kotlin أعلاه، فإنه سيولد المخرجات التالية:
Hello, Word!