Commentaires de bloc
Leçon 6 sur 28 du cours Clean Code - Écrire un meilleur code avec Python de Coddy.
« Si l'implémentation est difficile à expliquer, c'est une mauvaise idée. »
- Le Zen de Python
Les commentaires sont importants pour que quiconque lira votre code puisse le comprendre.
Les commentaires en Python se divisent en 3 types :
- Commentaires de bloc
- Commentaires en ligne
- Chaînes de documentation (Docstrings)
Commençons par les Commentaires de bloc -
- Commencent au même niveau d'indentation que le code qu'ils décrivent.
- Commencent chaque ligne par un
#suivi d'un seul espace.
Par exemple,
while i < 10:
# Boucle sur i jusqu'à ce que i < 10
# affiche i avec un saut de ligne et l'incrémente de 1
print(i, '\n')
i += 1
Défi
FacileOn vous donne la fonction greet, écrivez un commentaire de bloc pour décrire ce que fait cette fonction - avec vos propres mots.
Suivez les règles !
Essayez vous-même
def greet(name):
print('Hello', name)