Subtitles of the Movie

En este modulo veremos los comentarios. Muchas personas no los conocen, pero los programadores de otros lenguajesÉ tendran una mayor idea de su significado. Para quienes no los conocen, un comentario es un texto ubicado dentro de un programaÉ para que este sea mas legible y mas comprensible. Un comentario es completamente ignorado por el compilador. Veamos algunos ejemplos. Este es un sencillo programa del C para calcular el area de un circulo si el usuario especifica un radio. No hay nada en este programa que no hayamos visto, aunque puede parecer extrana la sentencia "pi = 3.14", etc. Es como decir "pi=6". Aunque "pi" no es 6, esta es la manera de especificar un numero decimal en comparacion con un entero. En este caso utilizaremos variables de tipo "double" e "int", "int" en la variable "radius" y "double" en "area" y "pi". Obviamente las funciones "printf" y "scanf" realizan el calculo "pi" por "radius" por "radius" para obtener el area de un circuloÉ y desplegar el resultado. Es muy sencillo. Vamos a verificar que el programa funciona como esperamos. Compilamos, obtenemos "Please enter the radius", ingresamos el valor 10 y el area del circulo es 314 con unos valores decimales. Si el radio es 10, este al cuadrado es 100 y este valor por 100 nos da aproximadamente 314. El programa funciona bien. Veamos los comentarios. Voy a aumentar el tamano de la pantalla. Ahora vamos a incluir algunos comentarios. Estos estan disenados para mejorar la legibilidad del programa y para explicar aspectos que no son facilmente comprensibles. Veamos un ejemplo aqui; antes del calculo voy a ingresar un comentario. Ingresamos una barra diagonal y cambia el color. Escribimos "The area of a circle is pi times the radius squared". Esto explica la funcion de esta formula para hallar el area de un circulo, asi que por lo tanto, creo que hemos mejorado la legibilidad del programa al hacerlo mas comprensibleÉ para quienes se les dificulta las matematicas. Esta linea indica que de hecho tenemos "radius" por "radius" o sea "radius" al cuadrado. Veamos con mas detalle el comentario. Primero, quiero que ignore el hecho de que el color es purpura o azul oscuroÉ y que aparece en cursiva. Esta es una funcion del Entorno de Desarrollo Dev C++ y no tiene que ver con los comentarios en general. Quiero que observe el inicio y el final del comentario. El inicio es una barra diagonal y un asterisco y el final es un asterisco y una barra diagonal. El texto en medio es ignorado. Podemos separarlo en varias lineas si queremosÉ y tambien funcionara bien. No importa cuanto espacio en blanco tenga el comentario, pues aun funcionara correctamente. Los comentarios no tienen que estar en lineas separadas. Podemos tener aqui el comentario "we need a lot of precision". para explicar la utilizacion de la variable "pi" de tipo "double" en vez de "float" o incluso "int". El punto del ejercicio es mostrar que los comentarios pueden ocupar una parte de una lineaÉ y que no tienen que ocupar toda una linea o varias de ellas. Es conveniente incluir un comentario al inicio del programa, ya sea antes o despues de la linea "#include", para explicar la funcion y el objetivo del mismo. Podemos tener el nombre del programa "comment.c" y una explicacion como esta. Ahora el comentario esta completo. Esta es la apariencia de un comentario al inicio de un programa. Para resumir, los comentarios comienzan con "/*" y terminan con "*/". Estos pueden cubrir multiples lineas y podemos aplicar comentarios de nuevo estilo en un programa del C. Este estilo del C de edicion ANSI se denomina Estilo C++ y fue inventado junto al lenguaje C++. Desde entonces ha sido adoptado por casi todos los compiladores del C y ha sido parte de la definicion estandar ANSI C. Los comentarios de nuevo estilo inician con una doble barra diagonal y proceden hasta el final de la linea. Veamos el programa con comentarios de nuevo estilo. Lo llamamos "comment2.c" y observe las dobles barras inclinadas. Este es un ejemplo clasico. Si este comienza con las dos barras diagonales y procede hasta el final de la linea, y si nada designa la terminacion del comentario, entonces el final de la linea en si es el final del comentario. Nos desplazamos hacia abajo y aqui tenemos otro comentario. Esto es todo al respecto. Regresamos al programa original "comment.c" y veamos una ultima norma de los comentarios. No podemos tener un comentario dentro de otro comentario. Veamos este aspecto. Veremos un ejemplo aqui. Este es un comentario dentro de otro comentario. Podemos escribirlo, pero al compilarlo obtendremos varios errores. Veamos. Obtenemos un error: "parse error before /". Lo que ocurre es que el comentario comenzo aqui y procede hacia delante. El C no reconoce los comentarios que comienzan dentro de otros y los toma como parte del original. Esta parte inicial del comentario no es especial si comienza dentro de un comentario. y procede hacia delante. Ya que no hay un final para el comentario, este se toma como un comentario completo. El compilador lo interpreta como codigo del C regular, pero de inmediato identifica que algo esta mal. Tenemos un comentario cerrado, pero no estamos dentro de otro, asi que obtenemos un error. A esto me refiero cuando hablo de anidar comentarios: no podemos ubicar un comentario dentro de otro en el C. Finalmente, antes de terminar el modulo eliminamos esto y regresamos al codigo correcto. Un comentario es muy util para ocultar ante el compilador algun codigo que queremos eliminar temporalmente, pero que planeamos utilizar mas adelante. Digamos que no queremos desplegar el area del circulo en esta etapa, asi que aplicamos un comentario a esta linea. De hecho, es mejor aplicarlo de esta maneraÉ porque asi los delimitadores son mas faciles de eliminar al terminar con ellos. Esta linea se convierte en un comentario y ya no es una linea de codigo. Aun es una linea de codigo, pero esta oculta ante el compilador. Compilamos sin errores, ejecutamos y obtenemos "Please enter the radius". No obtenemos respuesta por parte de la funcion "printf". Esto es particularmente util al depurar un programa y al buscar posibles errores. Comunmente aplicamos comentarios en varias areas del codigoÉ hasta encontrar las lineas en cuestion. No explicare este aspecto con detalle porque no es importante en este momento, sino que estamos viendo la ubicacion y la manera de utilizar de los comentarios. La depuracion no es importante en este momento. Con esto concluimos los comentarios.