Dalam artikel ini, anda akan belajar mengenai komen Kotlin, dan mengapa dan bagaimana menggunakannya.
Dalam pengaturcaraan, komen adalah sebahagian daripada program yang ditujukan untuk anda dan rakan pengaturcara anda untuk memahami kodnya. Mereka tidak diendahkan sepenuhnya oleh penyusun Kotlin (Kompiler).
Sama seperti Java, terdapat dua jenis komen di Kotlin
/*… *///… .
Komen tradisional / *… * /
Ini adalah komen multiline yang boleh merangkumi pelbagai baris. Penyusun Kotlin mengabaikan segala-galanya /*hingga */. Sebagai contoh,
/* This is a multi-line comment. * The problem prints "Hello, World!" to the standard output. */ fun main(args: Array) ( println("Hello, World!") )
Komen tradisi juga digunakan untuk mendokumentasikan kod Kotlin (KDoc) dengan sedikit variasi. Komen KDoc bermula dengan /**dan berakhir dengan */.
Ulasan Akhir Garis //
Penyusun mengabaikan segalanya dari //hujung baris. Sebagai contoh,
// Kotlin Hello World Program utama yang menyeronokkan (args: Array) (println ("Hello, World!") // keluaran Hello, World! Di skrin)
Program di atas mengandungi dua komen baris akhir:
// Program Kotlin Hello World
dan
// output Hello, World! di skrin
Gunakan Komen dengan Cara yang Betul
Komen tidak boleh menjadi pengganti cara untuk menjelaskan kod yang kurang ditulis dalam bahasa Inggeris. Tuliskan kod yang tersusun dan boleh dibaca, dan kemudian gunakan komen.
Ada yang percaya bahawa kod harus mendokumentasikan diri dan komen harus jarang. Namun, saya harus tidak setuju sepenuhnya (Ini pendapat peribadi saya). Tidak ada yang salah dengan menggunakan komen untuk menjelaskan algoritma kompleks, regex atau senario di mana anda telah memilih satu teknik daripada yang lain (untuk rujukan masa depan) untuk menyelesaikan masalah.
Dalam kebanyakan kes, gunakan komen untuk menerangkan 'mengapa' dan bukannya 'bagaimana' dan anda sudah bersedia.
