Komentar #

Komentar dalam Kotlin adalah teks yang disertakan dalam kode sumber untuk memberikan penjelasan atau catatan kepada pengembang tanpa mempengaruhi eksekusi program. Kotlin mendukung dua jenis komentar utama: komentar satu baris (single-line comments) dan komentar multi-baris (multi-line comments). Komentar sangat berguna untuk mendokumentasikan kode, menjelaskan logika kompleks, atau menonaktifkan sementara bagian dari kode selama proses debugging.

Komentar Satu Baris #

Komentar satu baris dimulai dengan dua garis miring (//). Segala sesuatu yang tertulis setelah // di baris yang sama akan dianggap sebagai komentar dan diabaikan oleh compiler.

Contoh:

val number = 10 // Ini adalah komentar satu baris
println(number) // Mencetak nilai dari variabel number

Dalam contoh di atas, teks setelah // pada setiap baris adalah komentar dan tidak akan dieksekusi oleh program.

Komentar Multi-Baris #

Komentar multi-baris dimulai dengan /* dan diakhiri dengan */. Komentar ini dapat mencakup beberapa baris, dan sangat berguna untuk menambahkan penjelasan yang lebih panjang atau untuk menonaktifkan bagian kode yang lebih besar.

Contoh:

/*
    Ini adalah komentar multi-baris.
    Anda dapat menambahkan lebih banyak informasi di sini,
    dan komentar ini dapat meliputi beberapa baris.
*/
val number = 10
println(number)

Komentar multi-baris sering digunakan untuk mendokumentasikan blok kode yang lebih panjang atau memberikan penjelasan yang lebih mendalam.

Komentar Dokumentasi #

Selain komentar biasa, Kotlin juga mendukung komentar khusus yang digunakan untuk mendokumentasikan kode. Komentar ini dikenal sebagai Dokumentasi KDoc, mirip dengan Javadoc di Java. Dokumentasi KDoc digunakan untuk memberikan penjelasan formal tentang fungsi, kelas, atau properti, dan dimulai dengan /** dan diakhiri dengan */.

Contoh:

/**
 * Fungsi ini mengembalikan kuadrat dari sebuah angka.
 * 
 * @param x Angka yang akan dikuadratkan
 * @return Hasil dari x * x
 */
fun square(x: Int): Int {
    return x * x
}

KDoc ini dapat digunakan oleh alat dokumentasi untuk menghasilkan dokumentasi otomatis dari kode Anda. KDoc mendukung tag seperti @param dan @return untuk menjelaskan parameter dan nilai kembalian dari fungsi.

Kesimpulan #

Komentar adalah alat penting dalam pengembangan perangkat lunak yang membantu membuat kode lebih mudah dipahami oleh pengembang lain atau diri Anda sendiri di masa depan. Kotlin menyediakan dukungan untuk komentar satu baris dan multi-baris, serta komentar dokumentasi yang sangat berguna untuk menulis dokumentasi formal langsung di dalam kode sumber.