Bu yazıda Kotlin yorumlarını ve bunların neden ve nasıl kullanılacağını öğreneceksiniz.
Programlamada yorumlar, programın sizin ve programcı arkadaşlarınızın kodu anlamasını amaçlayan bir parçasıdır. Kotlin derleyicisi (Kompiler) tarafından tamamen göz ardı edilirler.
Java gibi, Kotlin'de de iki tür yorum vardır
/*… *///… .
Geleneksel yorum / *… * /
Bu, birden çok satıra yayılabilen çok satırlı bir yorumdur. Kotlin derleyicisi, /*ile arasındaki her şeyi yok sayar */. Örneğin,
/* This is a multi-line comment. * The problem prints "Hello, World!" to the standard output. */ fun main(args: Array) ( println("Hello, World!") )
Gelenek yorumu, Kotlin kodunu (KDoc) küçük bir değişiklikle belgelemek için de kullanılır. KDoc yorumları ile başlar /**ve ile biter */.
Satır Sonu Yorumu //
Derleyici //, satırın sonuna kadar her şeyi yok sayar . Örneğin,
// Kotlin Hello World Program fun main (args: Array) (println ("Merhaba, Dünya!") // ekranda Merhaba, Dünya! Çıktıları)
Yukarıdaki program iki satır sonu yorumu içerir:
// Kotlin Merhaba Dünya Programı
ve
// Merhaba, Dünya! ekranda
Yorumları Doğru Şekilde Kullanın
Kötü yazılmış bir kodu İngilizce olarak açıklamanın bir yolu, yorumlar yerine geçmemelidir. İyi yapılandırılmış ve okunabilir bir kod yazın ve ardından yorumları kullanın.
Bazıları kodun kendi kendini belgelemesi gerektiğine ve yorumların az olması gerektiğine inanıyor. Ancak buna tamamen katılmıyorum (bu benim kişisel görüşüm). Problemi çözmek için (ileride başvurmak üzere) bir tekniği diğerine tercih ettiğinizde karmaşık algoritmaları, normal ifadeleri veya senaryoları açıklamak için yorumları kullanmakta yanlış bir şey yoktur.
Çoğu durumda, "nasıl" yerine "neden" i açıklamak için yorumları kullanın ve gitmeniz iyi olur.
