Déclaration Python, indentation et commentaires

Dans ce didacticiel, vous découvrirez les instructions Python, pourquoi l'indentation est importante et l'utilisation des commentaires dans la programmation.

Déclaration Python

Les instructions qu'un interpréteur Python peut exécuter sont appelées des instructions. Par exemple, a = 1est une instruction d'affectation. ifdéclaration, fordéclaration, whiledéclaration, etc. sont d'autres types de déclarations qui seront discutées plus tard.

Déclaration multiligne

En Python, la fin d'une instruction est marquée par un caractère de nouvelle ligne. Mais nous pouvons faire une déclaration s'étendre sur plusieurs lignes avec le caractère de continuation de ligne (). Par exemple:

 a = 1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9

Ceci est une continuation de ligne explicite. En Python, la continuation de ligne est implicite entre parenthèses (), crochets () et accolades (). Par exemple, nous pouvons implémenter l'instruction multiligne ci-dessus comme:

 a = (1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9)

Ici, les parenthèses environnantes () font la continuation de ligne implicitement. Il en va de même avec () et (). Par exemple:

 colors = ('red', 'blue', 'green')

Nous pouvons également mettre plusieurs instructions sur une seule ligne en utilisant des points-virgules, comme suit:

 a = 1; b = 2; c = 3

Indentation Python

La plupart des langages de programmation comme C, C ++ et Java utilisent des accolades () pour définir un bloc de code. Python, cependant, utilise l'indentation.

Un bloc de code (corps d'une fonction, boucle, etc.) commence par une indentation et se termine par la première ligne non indentée. Le montant de l'indentation dépend de vous, mais il doit être cohérent tout au long de ce bloc.

En général, quatre espaces sont utilisés pour l'indentation et sont préférés aux tabulations. Voici un exemple.

 for i in range(1,11): print(i) if i == 5: break

L'application de l'indentation en Python donne au code un aspect net et net. Il en résulte des programmes Python qui semblent similaires et cohérents.

L'indentation peut être ignorée dans la continuation de ligne, mais c'est toujours une bonne idée de l'indenter. Cela rend le code plus lisible. Par exemple:

 if True: print('Hello') a = 5

et

 if True: print('Hello'); a = 5

les deux sont valides et font la même chose, mais l'ancien style est plus clair.

Une indentation incorrecte entraînera IndentationError.

Commentaires Python

Les commentaires sont très importants lors de l'écriture d'un programme. Ils décrivent ce qui se passe à l'intérieur d'un programme, de sorte qu'une personne qui regarde le code source n'ait pas de mal à le comprendre.

Vous pourriez oublier les détails clés du programme que vous venez d'écrire dans un mois. Prendre le temps d'expliquer ces concepts sous forme de commentaires est donc toujours fructueux.

En Python, nous utilisons le symbole dièse ( # ) pour commencer à écrire un commentaire.

Il s'étend jusqu'au caractère de nouvelle ligne. Les commentaires sont destinés aux programmeurs pour mieux comprendre un programme. L'interpréteur Python ignore les commentaires.

 #This is a comment #print out Hello print('Hello')

Commentaires sur plusieurs lignes

Nous pouvons avoir des commentaires qui s'étendent sur plusieurs lignes. Une façon consiste à utiliser le symbole dièse ( # ) au début de chaque ligne. Par exemple:

 #This is a long comment #and it extends #to multiple lines

Une autre façon de faire est d'utiliser des guillemets triples, soit '' 'ou "" ".

Ces guillemets triples sont généralement utilisés pour les chaînes multilignes. Mais ils peuvent également être utilisés comme commentaire sur plusieurs lignes. À moins qu'il ne s'agisse de docstrings, ils ne génèrent aucun code supplémentaire.

 """This is also a perfect example of multi-line comments"""

Pour en savoir plus sur les commentaires, consultez la page Commentaires Python.

Docstrings en Python

Une docstring est l'abréviation de chaîne de documentation.

Les docstrings Python (chaînes de documentation) sont les littéraux de chaîne qui apparaissent juste après la définition d'une fonction, méthode, classe ou module.

Les guillemets triples sont utilisés lors de l'écriture de docstrings. Par exemple:

 def double(num): """Function to double the value""" return 2*num

Les docstrings apparaissent juste après la définition d'une fonction, d'une classe ou d'un module. Cela sépare les docstrings des commentaires multilignes en utilisant des guillemets triples.

Les docstrings sont associés à l'objet en tant __doc__qu'attribut.

Ainsi, nous pouvons accéder aux docstrings de la fonction ci-dessus avec les lignes de code suivantes:

 def double(num): """Function to double the value""" return 2*num print(double.__doc__)

Production

 Fonction pour doubler la valeur

Pour en savoir plus sur les docstrings en Python, visitez Docstrings Python.

Articles intéressants...