C / Comentarios

Bienvenidos sean a este post, hoy veremos algo que se usa incorrectamente.

Pero como es esto? ya veremos el porque pero por el momento centremonos en el tema, los comentarios como su nombre lo indica sirven para comentar en el codigo lo que sea necesario ya sea desde datos del programas hasta comentar partes del mismo, para hacerlo tenemos dos formas, veamos la primera:

// un texto por aqui

Esta es su forma mas basica y se denomina comentario de una sola linea porque solamente contendra ese texto hasta el final de la linea, veamos el siguiente:

/* este es un comentario
	de mas de una linea */

Este es un tipo de comentario con mas de una linea, todo el comentario que este entre el operador /* y */ se convertira en un comentario, otra forma de comentario multiple es el siguiente:

/* este es un 
 * comentario
 * de mas de 
 * una linea 
 */

Por ultimo tambien pueden utilizar al primer tipo de comentario como de lineas multiples de la siguiente manera:

//
// este es un 
// comentario
// de mas de 
// una linea 
//

Para entenderlo vamos a tomar el codigo que trabajamos en los posts anteriores, sino lo tienen simplemente generen un archivo llamado hola.c y agreguen el siguiente codigo:

hola.c

#include <stdio.h>

int main()
{
	printf("Hola, Mundo\n");
	return 0;
}

Con nuestro archivo creado procederemos a modificarlo de la siguiente manera:

/*
	Este es nuestro primer codigo
	para aprender C desde
	el sitio de tinchicus.com
*/

#include <stdio.h>

int main()
{
	printf("Hola, Mundo\n"); // mennsaje en pantalla
	return 0;
}

//
// Un comentario mas
// antes de salir
//

Es basicamente lo mismo que antes pero ahora agregamos unos comentarios, uno antes de las librerias, uno al final del codigo y otro despues del punto y coma (;), pasemos a compilarlo:

$ gcc hola.c -o hola

Y vamos a ejecutarlo para verlo en accion:

tinchicus@dbn001vrt:~/lenguajes/C$ ./hola 
Hola, Mundo
tinchicus@dbn001vrt:~/lenguajes/C$

Como pueden ver sigue funcionando correctamente porque todo lo que este dentro de los comentarios sera omitido por el compilador, y aqui entra en accion para que lo usan el 99.9% de los programadores, como es la depuracion.

Pero que es la depuracion? Si bien no vamos a entrar en detalles simplemente vamos a decir que es el tratamiento de los errores, si suman uno mas uno se daran cuenta que los comentarios nos permiten omitir una parte del codigo ante un posible error, vamos a tomar el codigo anterior y vamos a modificarlo de la siguiente manera:

hola.c

#include <stdio.h>

int main()
{
	// printf("Hola, Mundo\n");
	return 0;
}

Observen que quitamos todos los comentarios y «comentamos» la linea que nos muestra el mensaje en pantalla, si lo compilamos nuevamente y ejecutamos nos sucedera lo siguiente:

tinchicus@dbn001vrt:~/lenguajes/C$ ./hola 
tinchicus@dbn001vrt:~/lenguajes/C$

Es decir que de ahora en mas el programa no hara nada porque hemos omitido la linea comentada, esto se hace habitualmente ante un error en una determinada linea donde podemos comentarla y ver si el programa continua correctamente y en caso de ser asi ver porque en esa linea genera un error, tambien podemos usar un comentario de varias lineas para comentar una porcion de codigo que se modifico con otra pero que nos puede ser util para otras circunstancias y por esa razon no deseamos eliminarla, en fin con el tiempo y la practica se daran cuenta que otras utilidades tienen los comentarios, para ir finalizando les dejo esta frase que lo resume todo:

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

En resumen, hoy hemos visto los comenttarios, como son, los disponibles, como usarlos yyyy para que se usan realmente 😁, espero les haya sido de utilidad 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.