Instruction Python, indentation et commentaires

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

Instruction Python

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

Instruction multi-lignes

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

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

Il s'agit d'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 entourant ( ) faire la continuation de ligne implicitement. Il en va de même pour [ ] et { } . Par exemple :

colors = ['red',
          'blue',
          'green']

Nous pouvons également mettre plusieurs déclarations 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 tels que 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. La quantité d'indentation dépend de vous, mais elle doit être cohérente tout au long de ce bloc.

Généralement, quatre espaces blancs 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 une apparence soignée et propre. Cela se traduit par 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 d'indenter. Cela rend le code plus lisible. Par exemple :

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

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

les deux sont valides et font la même chose, mais le premier 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'a pas de mal à le comprendre.

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

En Python, nous utilisons le hachage (# ) 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 multi-lignes

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

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

Une autre façon de procéder consiste à 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 multiligne. Sauf s'il s'agit 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 Python Comments.

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, d'une méthode, d'une classe ou d'un 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 à l'aide de triples guillemets.

Les docstrings sont associés à l'objet en tant que leur __doc__ 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__)

Sortie

Function to double the value

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

Mots clés et identifiants Python Variables, constantes et littéraux Python

Python