Objectifs Etre capable de commenter votre code en Python Introduction Les commentaires sont des lignes qui existent dans les programmes informatiques et qui sont ignorées par les compilateurs et les interprètes. L'inclusion de commentaires dans les programmes rend le code plus lisible pour les humains car il fournit des informations ou des explications sur ce que fait chaque partie d'un programme. Lorsque vous travaillez avec un langage de programmation, vous incluez des commentaires dans le code pour noter votre travail. Cela détaille à quoi servent certaines parties du code et permet aux autres développeurs – vous y compris – de savoir ce que vous faisiez lorsque vous avez écrit le code. Programmation C-C++/Les commentaires — Wikilivres. C'est une pratique nécessaire, et les bons développeurs font un usage intensif du système de commentaires. Sans cela, les choses peuvent devenir vraiment déroutantes, très vite. En Python, il existe deux façons d'annoter votre code. La première méthode La première consiste à inclure des commentaires qui détaillent ou indiquent ce que fait une section de code – ou un extrait de code -.
Bienvenue sur notre plateforme de consentement cookies de × Lorsque vous naviguez sur le site Breizh Info, des cookies sont déposés sur votre navigateur. Pour certains d'entre eux, votre consentement est nécessaire. Cliquez sur chaque catégorie de cookies pour activer ou désactiver leur utilisation. Pour bénéficier de l'ensemble des fonctionnalités proposées par le site de Breizh info (partage d'articles sur les réseaux sociaux, publicités conformes à vos centres d'intérêt, amélioration du site grâce aux statistiques de navigation, etc. Commentaire en charge. ), il est conseillé de garder l'activation des différentes catégories de cookies. Accepter Rejeter Confidentialité & cookies Gestion des cookies
Ceci est utile tant pour l'auteur du code lui-même que pour toute autre personne amenée à consulter le code. Vous devez séparer les détails relatifs à l'implémentation (comment la procédure fait ce qu'elle doit faire) des commentaires décrivant les caractéristiques fonctionnelles. Si vous fournissez des informations d'implémentation dans la description, n'oubliez pas de les mettre à jour lors de la mise à jour de la fonction. Les commentaires peuvent soit suivre une instruction sur la même ligne, soit occuper une ligne entière. Ces deux cas sont illustrés par le code suivant: ' This is a comment beginning at the left edge of the screen. = "Hi! " ' This is an inline comment. Si votre commentaire doit occuper plusieurs lignes, utilisez le symbole de commentaire sur chacune d'elles, comme l'exemple ci-dessous l'illustre. ' This comment is too long to fit on a single line, so we break ' it into two lines. Some comments might need three or more lines. Commentaire composé amélie vioux. Le tableau suivant fournit des recommandations générales sur les types de commentaires qui peuvent précéder une section de code.