Planète Python RSS

Morsels Python : Commenter en Python

« Les commentaires Python, essentiels pour la clarté du code, commencent par le symbole « # », souvent appelé octothorpe. Un commentaire s'étend jusqu'à la fin de la ligne, permettant aux développeurs d'expliquer la fonctionnalité du code. Ce sont des commentaires à une seule ligne ; Python ne dispose pas d'une syntaxe de commentaire multiligne spécifique. Les commentaires peuvent être utilisés en ligne avec le code ou sur des lignes séparées pour des explications plus détaillées. L'exemple fourni démontre l'utilisation d'un commentaire pour clarifier le but d'un code d'échappement ANSI dans le nettoyage de la ligne actuelle. Le commentaire explique que le code remplace "Hello!" par "Goodbye!" en déplaçant le curseur et en effaçant la ligne. Il note également un problème de compatibilité avec Windows, soulignant l'importance de commentaires informatifs. Bien que essentiels pour la lisibilité, les commentaires doivent être utilisés avec discernement, expliquant le "pourquoi" plutôt que le "quoi" du code. Le sur-commentaire peut nuire à la lisibilité et à la maintenabilité. »
favicon
pythonmorsels.com
Python Morsels: Commenting in Python
Create attached notes ...