Commentaire (informatique)
vignette|Exemple de code source Java avec coloration syntaxique : le code source est en bleu, les commentaires en rouge (commentaires en bloc) et en vert (commentaires en ligne). Les commentaires sont, en programmation informatique, des portions du code source ignorées par le compilateur ou l’interpréteur, car destinées en général à un lecteur humain et non censées influencer l’exécution du programme. Les commentaires sont le plus souvent utilisés pour expliquer le code ; certains outils, appelés générateurs de documentation, permettent d’extraire l’information disponible dans les commentaires pour créer automatiquement une documentation du programme. On utilise parfois une mise en commentaires pour court-circuiter quelque temps une section de code, mais aussi pour préciser des contraintes ou des propriétés, notamment des préconditions, des postconditions et des invariants comme cela se fait dans la programmation par contrat. Les façons de distinguer les commentaires du reste du code varient suivant le langage utilisé. On distingue trois catégories principales, chaque langage pouvant implémenter plusieurs catégories de commentaires : commentaires en pleine ligne ; commentaires de fin de ligne ; commentaires en bloc. Un commentaire en pleine ligne commence par un marqueur annonçant une ligne de commentaires (ou par l’absence d’un marqueur annonçant une ligne de code). BASIC, Fortran et Cobol sont des langages utilisant des commentaires en pleine ligne. Le code reprend naturellement à la ligne suivante. BASIC : REM commentaire Cobol : 000010*COMMENTAIRE (l’astérisque doit se trouver en sur la ligne) Fortran : C commentaire (exactement 6 espaces entre le caractère C et le commentaire ; C doit absolument être le premier caractère de la ligne) REALbasic : rem commentaire // commentaire ' commentaire Les fichiers de commandes BATCH pour cmd.exe de Windows : rem commentaire Un commentaire de fin de ligne commence par un marqueur annonçant le début d’un commentaire, et se termine automatiquement à la fin de la ligne, sans nécessité de marqueur de fin.
