Juegos en Android / Comentarios

Bienvenidos sean a este post, hoy hablaremos sobre una breve explicacion de como son los comentarios.

Comentar el código es como limpiar el cuarto de baño; nadie quiere hacerlo, pero el resultado es siempre una experiencia más agradable para uno mismo y sus invitados

Ryan Campbell

Tal como dice la cita, el comentar un codigo nos permite saber cual es la accion del bloque siguiente a este, esto puede ser bueno por dos razones:

La primera es para nosotros, muchas va a suceder que estemos trabajando sobre un programa y por alguna razon X lo abandonemos por un tiempo y al volverlo a retomar sin los comentarios nos llevara un tiempo deducir que hace cada parte del programa, y la segunda es cuando otra persona debe continuar con un codigo por nosotros o lo contrario, debemos continuar con el programa iniciado por otra persona, en cualquiera de las situaciones sin los comentarios seria extraordinariamente dificil deducir que hace el codigo.

El comentario va a ser una parte del codigo que el lenguaje ignorara al momento de compilarlo por lo cual no afectara a la ejecucion del mismo pero si nos permitira saber lo que hace, el comentario puede usarse de dos formas, primero veamos la de linea simple:

// texto de ejemplo

Siempre va a comenzar con la doble linea y solamente afectara a esa linea, si escribimos un texto por debajo de esta no se vera afectada por la anterior y tambien disponemos de la multilinea:

/*
Texto de ejemplo
Para entender mejor
el concepto de
comentarios.
*/

En este caso siempre van a comenzar con la barra de dividir y el asterisco para luego finalizar con el asterisco y la barra de dividir, todo lo que este entre estos dos elementos sera considerado como comentario y omitido por el lenguaje.

Hasta ahora dijimos que los comentarios son una forma de decir en el codigo que hace cada funcion, bloque o seccion y que tambien es omitido por el compilador pero para que es usado el 99.9% de las veces? 🤔 Justamente para omitir una parte del codigo.

Los comentarios tambien nos permiten omitir una parte de nuestro codigo, vamos a suponer que tenemos la siguiente funcion:

public void miFuncion(int a)
{
... instrucciones ...
}

Y nosotros creamos una version mejorada de dicha funcion pero tenemos algunas instrucciones o un bloque el cual nos puede servir mas adelante y no lo queremos borrar del codigo, entonces lo que hacemos es comentarlo de la siguiente manera:

/* public void miFuncion(int a)
{
... instrucciones ...
} */

Con esto el codigo de la funcion sigue dentro del programa pero al momento de compilarlo sera ignorado, tambien podemos usarlo para cuando efectuamos una depuracion de nuestro programa.

Nota: Se llama depuracion a la accion de investigar nuestro codigo cuando posee un error.

Vamos a suponer que nuestro programa en un punto devuelve un error y nuestro compilador (en este caso Android Studio) nos informa en cual lugar, para ver si es esa linea podemos comentarla con la doble barra y ver la conducta del programa, si el programa funciona correctamente procedemos a analizar el porque genera un error.

Con esto se daran cuenta que en general los programadores no usan mucho los comentarios para comentar el codigo sino para omitir ciertas partes del mismo en caso de necesitar omitirlo o analizar una parte del mismo, con el tiempo y practica comprenderan el uso de los mismos.

En resumen, hoy hemos hablado sobre los comentarios en Java, como es su sintaxis, para que se deberian usar, y para que se usan realmente, espero les haya sido util sigueme en tumblr, Twitter o Facebook para recibir una notificacion cada vez que subo un nuevo post en este blog, nos vemos en el proximo post.

Tengo un Patreon donde podes acceder de manera exclusiva a material para este blog antes de ser publicado, sigue los pasos del link para saber como.