Los comentarios son parte esencial de cualquier lenguaje de programación. En este capítulo verás los tipos de comentarios que puedes utilizar en Kotlin, y como los puedes usar.
Comentarios de fin de línea en Kotlin
En Kotlin los comentarios de una línea, se denominan en múltiples ocasiones como end-of-line comments (comentarios de fin de línea).
Estos se representan con dos barras al principio del comentario:
// Comentario de una línea
Este tipo de comentario solo puede ocupar su propia línea. Si haces un salto de línea, todo lo que venga después, ya no formará parte de él.
Estos comentarios se pueden colocar a la derecha del código, para comentarlo sin anularlo:
fun main() {
var nombre = "Programación Fácil"
print(nombre) // Se imprime el valor de la variable nombre
}Comentarios multilínea o de bloque en Kotlin
Los comentarios multilínea o de bloque, son aquellos que pueden abarcar más de una sola línea.
Aquí tienes un ejemplo un tanto exagerado, pero que te muestra la sintaxis:
fun main() {
/* Programa que imprime un nombre
* en la consola.
* Esto se consigue gracias a la
* función print() */
var nombre = "Programación Fácil"
print(nombre)
}Para abrir y cerrar estos comentarios es obligatorio utilizar /* para la apertura y */ para el cierre. El resto de asteriscos son meras decoraciones para hacer más atractivo y legible el comentario.
Comentarios multilínea anidados
Kotlin posee una característica especial con los comentarios multilínea. Es capaz de establecer anidación:
/* Comentario
multilínea principal
/* Comentario
multilínea secundario */
Sigue el comentario principal
*/Puedes pensar que simplemente, el comentario interno son meros caracteres pertenecientes al mismo comentario. Sin embargo, piensa que en la línea 4, se establece un cierre para lo que sería el comentario principal.
En Kotlin, esto se permite, y se detectan los cierres y aperturas internos, cosa que el plugin highlighter para exponerte el código, ni siquiera detecta bien.
De hecho, no lo hace ni el de la referencia del lenguaje, en el sitio web oficial:
Este comportamiento de los marcadores de código es muy entendible, puesto que en la mayoría de lenguajes de programación, cuando se encuentra el primer cierre de un comentario multilínea, se termina.
En Kotlin no tiene porqué.
Cometarios para desactivar código
Como en cualquier lenguaje de programación, podemos desactivar ciertas partes del código, comentándolas. Así evitamos borrarlas y podemos hacer pruebas:
fun main() {
println("Línea 1")
/*
println("Línea 2")
println("Línea 3")
*/
println("Línea 4")
//println("Línea 5")
}Resultado en la consola
Línea 1
Línea 4
No te pierdas nada del curso de Kotlin.
