Commentaires multi-lignes Python

Chaque langage de programmation fournit un mécanisme pour ajouter des commentaires aux projets. Les commentaires sont les lignes simples des programmes informatiques qui sont ignorés par le compilateur ou l'interprète. Les commentaires sont souvent écrits en langage naturel pour augmenter la compréhensibilité du programmeur. Les développeurs utilisent des commentaires pour ignorer certaines parties du code dans la phase de débogage ou de test.

L'écriture de commentaires dans Python peut être très simple, et créer un commentaire dans Python commence par le symbole '#'. Cet article explique comment créer des commentaires multi-lignes dans Python.

Écriture de commentaires multi-lignes dans Python

Contrairement à de nombreux autres langages de programmation, Python ne fournit aucun moyen spécifique d'écrire des commentaires multi-lignes. Néanmoins, il existe d'autres façons de faire face à ce problème.

En Java, nous écrivons plusieurs commentaires comme suit:

/ *
Ci-dessus, nous écrivons un commentaire multi-ligne.
Ce format de commentaire ne fonctionne pas dans Python.
* /

La méthode ci-dessus pour rédiger les commentaires ne fonctionne pas non plus dans Python.

Voyons d'autres façons d'écrire des commentaires multi-lignes dans Python.

En utilisant plusieurs commentaires de ligne de symboles

Le symbole '#' est utilisé pour écrire le commentaire unique de Python. Avec des commentaires multiples consécutifs, nous pouvons écrire des commentaires multi-lignes. Voyons un exemple de ceci.

#Bonjour à tous
# C'est un commentaire dans Python
#Je écrit des commentaires multi-lignes
#Using le commentaire unique

C'est une façon d'écrire des commentaires multilines. C'est un processus qui prend un peu de temps, car il nous oblige à écrire plusieurs commentaires à une seule ligne.

Maintenant, voyons d'autres façons d'écrire des commentaires multi-lignes dans Python.

Utilisation des littéraux de chaîne pour écrire des commentaires multi-lignes

Comme discuté précédemment, Python ne fournit pas un moyen réel d'écrire des commentaires multi-lignes, mais vous peut Utilisez des littéraux de chaîne pour écrire des commentaires multi-lignes. L'interprète Python néglige les chaînes littérales qui ne sont pas allouées à une variable et ne les exécutent pas. Ainsi, vous pouvez utiliser des littéraux de cordes non attribués pour écrire des commentaires multi-lignes dans Python. Regardons un exemple de ceci.

`` Nous utilisons la chaîne littérale comme commentaire ''
«Ceci est un commentaire multi-lignes»
'Nous imprimons le programme Hello World'
imprimer ("Hello World")

Sortir

Dans la sortie, vous pouvez voir que l'interpréteur Python ne publie aucune erreur et imprime le message 'Hello World.'

Utilisation des littéraux de chaînes triples citées pour écrire des commentaires multi-lignes

Bien que les littéraux de chaînes triples cités soient principalement utilisés pour écrire des docstrings, vous pouvez également utiliser cet outil pour écrire des commentaires multi-lignes. Assurez-vous de ne pas confondre le docstring avec les littéraux de chaîne cités triples qui sont utilisés pour écrire des commentaires multi-lignes. L'indentation incorrecte des littéraux à chaînes triples générés générera une erreur. Regardons un exemple de ceci.

"
Nous utilisons les littéraux de chaînes triples cités pour des commentaires multi-lignes
Le langage de programmation est Python
Imprimons le monde Hello
"
imprimer ("Hello World")

Sortir

Dans la sortie, vous pouvez voir que l'interpréteur Python ne publie aucune erreur et imprime le message 'Hello World.'

Maintenant, utilisons le triple littéraux de chaînes cités à l'intérieur d'une fonction pour écrire des commentaires multi-lignes.

Dans l'exemple donné, nous imprimons la somme de deux nombres.

def cal_sum ():
"
Nous calculons la somme de deux nombres.
Ceci est un programme de somme
"
num1 = 10
num2 = 20
print ("La somme est:", num1 + num2)
"
Fonction principale Python
"
def main ():
cal_sum ()
Si __name__ == "__main__":
principal()

Sortir

Maintenant, changeons l'indentation et dans la sortie, vous verrez que l'interprète publie une erreur.

def cal_sum ():
"
Nous calculons la somme des deux nombres.
Ceci est un programme de somme
"
num1 = 10
num2 = 20
print ("La somme est:", num1 + num2)
"
Fonction principale Python
"
def main ():
cal_sum ()
Si __name__ == "__main__":
principal()

Sortir

L'interprète sort l'erreur d'indentation.

Conclusion

Cet article explique comment créer des commentaires multi-lignes dans le langage de programmation Python. Bien que Python ne fournit aucun moyen réel de rédiger des commentaires multi-lignes, vous pouvez résoudre ce problème en utilisant les différentes méthodes discutées dans cet article.