Comentarios

Poner comentarios en el código: ¿por qué, cuándo y dónde?

Quizá en algún momento será necesario poner algunas palabras en el código dirigidas no a Python, sino a las personas quienes estén leyendo el código con el fin de explicarles como es que funciona, o tal vez especificar el significado de las variables, también para documentar quien es el autor del programa y en que fecha fue escrito.

Un texto insertado en el programa el cual es, omitido en la ejecución, es denominado un comentario.

¿Cómo se colocan este tipo de comentarios en el código fuente? Tiene que ser hecho de cierta manera para que Python no intente interpretarlo como parte del código.

Cuando Python se encuentra con un comentario en el programa, el comentario es completamente transparente, desde el punto de vista de Python, el comentario es solo un espacio vacío, sin importar que tan largo sea.

En Python, un comentario es un texto que comienza con el símbolo # y se extiende hasta el final de la línea.

Si se desea colocar un comentario que abarca varias líneas, se debe colocar este símbolo en cada línea.

Justo como el siguiente código:

# Este programa calcula la hipotenusa (c)
# a y b son las longitudes de los catetos
a = 3.0
b = 4.0
c = (a ** 2 + b ** 2) ** 0.5  # se utiliza ** en lugar de la raíz cuadrada.
print("c =", c)

Es muy conveniente comentar el código, pero además otra forma de hacer que el código sea entendible es elegir buenos nombres a las variables y a las funciones.

Por ejemplo, si una variable determinada esta diseñada para almacenar el área de un cuadrado, el nombre area_cuadrado será muchísimo mejor que tia_juana.

Los comentarios pueden ser útiles en otro aspecto, se pueden utilizar para marcar un fragmento de código que actualmente no se necesita. Observa el siguiente ejemplo, sí se descomenta la línea resaltada, esto afectara la salida o resultado del código:

# Este es un programa de prueba.
x = 1
y = 2
# y = y + x
print(x + y)

Esto es frecuentemente realizado cuando se esta probando un programa, con el fin de aislar un fragmento de código donde posiblemente se encuentra un error.

Cuestionario

1. ¿Cuál es el resultado del siguiente fragmento?

   # print("Cadena #1")
   print("Cadena #2") 

2. ¿Qué pasará cuando se ejecute el siguiente código?

   #Este es
   un comentario
   multilínea.#
   
   print("¡Hola!") 

Solución cuestionario

1. Pregunta 1:

   Cadena #2

2. Pregunta 2:

   SyntaxError: invalid syntax