1.10. Comentarios

Como ya hemos visto, podemos escribir comentarios, que el compilador ignora, pero que pueden servir para aclararnos cosas a nosotros. En su formato más general, 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. También es habitual que ese comentario inicial incluya el nombre del autor y la fecha de creación. Un ejemplo casi exagerado (porque la mayoría de comentarios que incluye son superfluos y no aportan nada) podría ser:

/* Ejemplo (exagerado) de uso de comentarios - ej011001.c */
/* Parte del Curso de C, Nacho Cabanes                    */

#include 

int main()
{
    /* Declaración de variables */
    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);

    /* Y fin del programa */
    return 0;
}

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

      /*  Este
          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 también de lenguaje C++, no sólo de C:

// Este es un comentario hasta fin de línea

El fuente anterior se podría rescribir de la siguiente forma, usando comentarios de una línea:

// Ejemplo de comentarios hasta fin de línea - ej011002.c
// Necesita un compilador de C99 o de C++
// Parte del Curso de C, Nacho Cabanes

#include 

int main()
{
    // Declaración de variables
    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);

    // Y fin del programa
    return 0;
}