Les commentaires
 

Ce chapitre sera court, simple et très rapide à comprendre bref du vrai bonheur!

Avant d'apprendre à créer des commentaires nous allons voir leurs utilités ainsi que qu'est-ce qu'un commentaire.

 

Qu'est-ce qu'un commentaire?

Dans votre code, vous aimeriez peut être écrire du texte pour vous rappeler que telle instruction fait ceci, l'autre cela, etc..
Cependant, vous ne souhaitez pas que ces informations apparaissent à l'écran.
C'est ce que l'on appelle des commentaires.


Grâce à eux vous pouvez commenter votre code sans que rien ne change.

Pour l'instant vous ne faîtes qu'apprendre le C et créer des programmes assez simples mais imaginez à la fin de ce tutoriel ce que vous saurez/pourrez faire!

Mettons nous à rêver un instant:

Vous programmez un super jeu et vous avez écrit des milliers de lignes de code! Seulement voilà, vous ne vous y retrouvez plus et vous ne saurez plus qu'elle fonction fait quoi, etc... bref vous serez perdu.

 

Comme nous venons de le voir les commentaires sont très utiles. Il ne nous reste plus maintenant qu'à savoir en créer, et vous allez voir, c'est super simple

Comment créer des commentaires?

Déjà ce qu'il faut savoir c'est que contrairement aux variables par exemple, vous pouvez mettre tous les signes que vous souhaitez dans les commentaires (lettres accentuées, espaces, etc...)


Il existe deux types de commentaires:

Les commentaires unilignes --> Vous pouvez écrire un commentaire juste sur la ligne désignée.

Les commentaires multilignes --> Vous pouvez écrire des romans d'autant de pages que vous le souhaitez avec (bon faut pas abuser un :P).



Les commentaires unilignes

Pour créer un commentaire uniligne, il suffit de marquer deux slashs consécutifs puis de marquer votre commentaire. Vous verrez que sous code::block le commentaire prend une couleur grisée.

Comme ceci:


          //On inclue les librairies (bibliothèques).
          #include <stdlib.h>
          #include <stdio.h>

             int main(int argc, char *argv[])
             {
                  printf("Hello world"); //Affiche le texte "Hello world" à l'écran.

                   //Quitte le programme.
                 return 0;
             }

Danc cet exemple la présence de commentaires ne sert à rien tellement le code semble évident, il s'agissait juste pour moi de vous montrer l'utilisation des commentaires unilignes
 

Attention!
Ce commentaire ci:

//Un exemple de commentaire,
blablabla.......

est faux!

Avec le commentaire uniligne il est interdit de faire des retours à la ligne, c'est à dire que tous doit tenir sur une seule ligne!
Pour palier cet inconvénient, les programmeurs ont inventés le commentaire multiligne.



Le commentaire multiligne

Pour ce type de commentaire, il suffit d'écrire un slash suivi d'une étoile puis d'écrire son commentaire sur plusieurs lignes si on le souhaite et de "fermer" le commentaire en écrivant cette fois une étoile suivit d'un slash comme ceci:


          /*On inclue les librairies
          (bibliothèques) permetant le
          bon fonctionnement du programme*/

          #include <stdlib.h>
          #include <stdio.h>

             int main(int argc, char *argv[])
             {
                  printf("Hello world"); /*Affiche le texte "Hello world"
                                                       à l'écran.*/

                  /*Quitte le programme.*/
                  return 0;
             }


Comme vous pouvez le voir, il n'y a rien de difficile
 

Ne mettez pas de commentaires dans d'autres commentaires, cela n'est pas recommandé du tout!

Exemple (code non correct):


          #include <stdlib.h>
          #include <stdio.h>

             int main(int argc, char *argv[])
             {
                  printf("Hello world"); /*Affiche le texte "Hello world"
                                                       /*autre commentaire*/ à l'écran.*/
                  return 0;
             }

C'est tout pour les commentaires Vous étiez prévenu, ce chapitre sera l'un des moins difficile mais c'est par contre l'un des plus utile! Ne sous-estimez pas les commentaires sans pour autant en écrire plus que de lignes de code!

Dans le prochain chapitre, nous verrons notre premier "vrai" TP! Un programme qui convertit les degrés Celsius en degrés Fahrenheit


 La gestion des flux d'entrées                              TP: Convertion degrés Celsius-Fahrenheit