1.6. Comentarios

(Nota: En la versión 2016 del curso tienes una variante más reciente y más detallada de este apartado)

Podemos escribir comentarios, que el compilador ignora, pero que pueden servir para aclararnos cosas a nosotros. Se escriben entre /* y */:

int suma; /* Porque guardaré el valor para usarlo más tarde */

Es conveniente escribir comentarios que aclaren la misión de las partes de nuestros programas que puedan resultar menos claras a simple vista. Incluso suele ser aconsejable que el programa comience con un comentario, que nos recuerde qué hace el programa sin que necesitemos mirarlo de arriba a abajo. Un ejemplo casi exagerado:

/* ---- Ejemplo en C: sumar dos numeros prefijados ---- */

#include 

main()
{
  int primerNumero = 234;
  int segundoNumero = 567;
  int suma;  /* Porque guardaré el valor para usarlo más tarde */

  /* Primero calculo la suma */
  suma = primerNumero + segundoNumero;
  /* Y después muestro su valor */
  printf("Su suma es %d", suma);
}

Un comentario puede empezar en una línea y terminar en otra distinta, así:

/* Esto
es un comentario que
ocupa más de una línea
*/

El estándar C99, que siguen algunos compiladores posteriores a 1999, permite también comentarios de una sola línea, que comienzan con doble barra y terminan al final de la línea actual. Al igual que pasaba con las declaraciones en cualquier punto del programa, es posible que este tipo de comentarios también lo permitan algunos compiladores más antiguos pero que sean compiladores de lenguaje C y también de C++. El fuente anterior se podría rescribir de la siguiente forma, usando comentarios de una línea:

// ---- Ejemplo en C: sumar dos numeros prefijados ---- 

#include 

int main()
{
  int primerNumero = 234;
  int segundoNumero = 567;
  int suma;  // Porque guardaré el valor para usarlo más tarde

  // Primero calculo la suma
  suma = primerNumero + segundoNumero;
  // Y después muestro su valor
  printf("Su suma es %d", suma);
  
  return 0;
}