Commentaire (informatique)

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 : 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. 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. Les langages C++ et Java utilisent ce type de commentaires. Un commentaire en bloc commence par un marqueur annonçant le début d’un commentaire et se termine avec un marqueur annonçant sa fin, leur intérêt principal est de pouvoir mettre en commentaire plusieurs lignes sans éditer chacune d'entre elles.