Programmation C++/Les commentaires

Un livre de Wikilivres.
Sauter à la navigation Sauter à la recherche


Tout bon programme a des fichiers sources bien commentés pour expliquer comment cela fonctionne et pourquoi certains choix ont été faits. Ce qui évite une perte de temps lorsque le code source est repris et modifié, soit par un autre développeur, soit par l'auteur qui ne se souvient pas forcément de son projet s'il n'y a pas touché depuis longtemps.

Bloc de commentaire[modifier | modifier le wikicode]

Un bloc de commentaire est délimité par les signes slash-étoile /* et étoile-slash */ comme en Java et en C#. Exemple :

/*
    Un commentaire explicatif
    sur plusieurs lignes...
*/

Les blocs ne peuvent être imbriqués car dès que le compilateur trouve slash-étoile /*, il recherche la première occurrence d'étoile-slash */ terminant le commentaire.

Avertissement Ce code contient une erreur volontaire !
/* : début du commentaire

    /* : ignoré

    fin du commentaire : */

erreur ici car le commentaire est fini : */

Commentaire de fin de ligne[modifier | modifier le wikicode]

Un commentaire de fin de ligne débute par un double slash // et se termine au prochain retour à la ligne. Exemple :

x++;  // augmenter x de 1

Astuce : La majorité des éditeurs évolués (Visual Studio, Borland C++, Eclipse ...) utilisent ce type de commentaire pour les commandes commenter/décommenter le groupe de lignes sélectionnées.