Programmation Python/Afficher un texte

Un livre de Wikilivres.

Ce chapitre détaille les différentes manières d'afficher un texte en console, par exemple pour générer des logs. Les interfaces graphiques plus élaborées seront traitées avec des bibliothèques.

print()[modifier | modifier le wikicode]

La fonction print sert à afficher des données sur la sortie standard, qui est l’écran. Exemple :

fonction print
>>> print('Hello World!')
Hello World!

La fonction help de l'interpréteur interactif donne la syntaxe des arguments de la fonction print :

>>> help(print)
Help on built-in function print in module builtins:

print(...)
    print(value, ..., sep=' ', end='\n', file=sys.stdout, flush=False)

    Prints the values to a stream, or to sys.stdout by default.
    Optional keyword arguments:
    file:  a file-like object (stream); defaults to the current sys.stdout.
    sep:   string inserted between values, default a space.
    end:   string appended after the last value, default a newline.
    flush: whether to forcibly flush the stream.

print formaté[modifier | modifier le wikicode]

Il est possible de changer une partie du texte en y incorporant des marqueurs de conversion précédés de l'opérateur "%". Il s'agit alors d'un "print formaté" (comme avec printf dans d'autres langages).

Les paramètres placés entre parenthèses à droite de la chaîne à afficher seront insérés dedans, en lieu et place des marqueurs. Cette technique a l'avantage de convertir automatiquement les variables pour qu'elles s'inscrivent dans le texte et qu'elles s'affichent.

Parmi les marqueurs disponibles[1], on trouve :

  • %s représente un paramètre de type "string" (texte).
  • %d un "digit" (nombre entier).
  • %f un "floating" (flottant : nombre réel).

Exemple :

>>> int1, int2 = 1, 2

>>> print(u"le résultat de " + str(int1) + ' + ' + str(int2) + " est " + str(int1 + int2))
  le résultat de 1 + 2 est 3

>>> print(u"le résultat de", int1 , ' + ', int2, " est ", int1 + int2)
  le résultat de 1 + 2 est 3

>>> print(u"et le résultat de %s + %d est %f" % (int1, int2, int1 + int2))
  et le résultat de 1 + 2 est 3.000000

Depuis la 3.6, On peut aussi format de cette manière :

  • f"{variable1} blabla {variable2} etc."

Donc en reprenant l'exemple au-dessus :

>>> int1, int2 = 1, 2

>>> print(f"et le résultat de {int1} + {int2} est {int1 + int2}")
  et le résultat de 1 + 2 est 3

Cela équivaut à utiliser la méthode format :

>>> a, b = 1, 2

>>> # Paramètres nommés
>>> print("et le résultat de {int1} + {int2} est {int1 + int2}".format(int1=a, int2=b))
  et le résultat de 1 + 2 est 3

>>> # Paramètres ordinaux (il n'est pas possible de mettre une expression, il faut passer le résultat)
>>> print("et le résultat de {0} + {1} est {2}".format(int1,int2,int1+int2))
  et le résultat de 1 + 2 est 3

fstring[modifier | modifier le wikicode]

Similaire au print formaté, la syntaxe fstring est la suivante :

ma_variable = 1
print(f"Valeur de ma variable : {ma_variable}")

input()[modifier | modifier le wikicode]

la fonction input() fait comme la fonction print(), mais stoppe le programme en attente que l'utilisateur presse "entrée". Son résultat sera de type 'string' (chaîne de caractère, texte).

Ici le contenu de ce que l'utilisateur a tapé avant de valider sera stocké dans la variable nommée variable.

>>> variable = input('Quel est votre nom ? ')
Quel est votre nom ? Pierre Henry FAGAN
>>> type(variable)
<class 'str'>
>>> print('Bonjour ' + variable)
Bonjour Pierre Henry FAGAN

raw_input()[modifier | modifier le wikicode]

raw_input() fait comme input(), mais renvoie toujours une chaîne de caractère. Elle ne plante pas si le texte est vide.

Logo

À partir de Python 3.1, la fonction "raw_input()" n'existe plus, et la fonction input() la remplace et renvoie systématiquement une chaîne de caractères.

Afficher des caractères spéciaux[modifier | modifier le wikicode]

Normalement, les symboles ne faisant pas partie du code ASCII sont traités comme les autres. Ex :

print('à â ç é è ê ë ï ô ù ÿ')
à â ç é è ê ë ï ô ù ÿ

Toutefois selon l'encodage, il peut être nécessaire de les convertir en Unicode en plaçant un "u" avant :

print(u'à â ç é è ê ë ï ô ù ÿ')

Pour les retours à la ligne, utiliser "\n".

Antislash[modifier | modifier le wikicode]

Les caractères affichés par les fonctions précédentes doivent être encadrés par des apostrophes ou des guillemets, mais que se passe-t-il s'ils contiennent eux-mêmes ces symboles ?

Testons la fonction print  :

ce qui marche :
>>> print("ça marche aussi")
ça marche aussi
>>> print('et ça ? "ça marche" ou pas')
et ça ? "ça marche" ou pas
>>> print("et on 'essaye' l'inverse")
et on 'essaye' l'inverse
ce qui ne marche pas :
>>> print('un simple guillemet ' encadré par du simple quote ')
[message d'erreur]
>>> print(" pareil pour le " double ")
[message d'erreur]
>>> print("double " deux " fois dans double")
[message d'erreur]

En Python, le simple quote peut encadrer le double, et le double peut encadrer le simple, car la chaîne commence au premier guillemet et finit au même guillemet.


Pour s'affranchir de ces limitations, on utilise un caractère d'échappement, qui est, en Python, l'antislash (« \ »). Il permet quelques subtilités complémentaires :

  • En premier lieu, il permet d'écrire sur plusieurs lignes n'importe quel type de commande. Pratique pour éviter de dépasser les 120 caractères pouvant nécessiter l'utilisation d'un ascenseur latéral pour être lus.
  • À l'intérieur d'une chaîne de caractères, l’antislash permet d'insérer un certain nombre de codes spéciaux (sauts à la ligne, apostrophes, guillemets, etc.). Exemples :
>>> print('une chaîne avec des \' guillemets \' simples dans des simples, c\'est protégé ')
une chaîne avec des ' guillemets ' simples dans des simples, c'est protégé

>>> txt3 = '"N\'est-ce pas ?" répondit-elle.'
>>> print(txt3)
"N'est-ce pas ?" répondit-elle.

>>> Salut = "Ceci est une chaîne plutôt longue\n contenant plusieurs lignes \
... de texte (Ceci fonctionne\n de la même façon en C/C++.\n\
...     Notez que les blancs en début\n de ligne sont significatifs.\n"
>>> print(Salut)
Ceci est une chaîne plutôt longue
 contenant plusieurs lignes de texte (Ceci fonctionne
 de la même façon en C/C++.
    Notez que les blancs en début
 de ligne sont significatifs.

On remarque que la séquence \' permet d'insérer une apostrophe dans une chaîne délimitée par des apostrophes, et \" par des guillemets. De même, "\\" affiche "\".

D'autres caractères peuvent aussi être introduits par antislash :

  • Retour chariot : \n
  • Tabulation : \t

Triple quotes[modifier | modifier le wikicode]

Si le nombre d’antislash nuit à la lisibilité du code, on peut délimiter la chaîne à l'aide de triples guillemets ou de triples apostrophes :

>>> a1 = """
... Usage: trucmuche[OPTIONS]
... { -h
...   -H hôte
... }"""

>>> print(a1)

Usage: trucmuche[OPTIONS]
{ -h
  -H hôte
}

Commentaires[modifier | modifier le wikicode]

Tout ce qui suit un dièse (#) jusqu'à un retour à la ligne est un commentaire : ce n'est pas pris en compte par l'interpréteur. Mais cette règle ne s'applique pas lorsque le dièse est positionné dans une chaîne de caractères (entre quotes).

Le but reste de produire du code compréhensible sans commentaire, mais ce texte affiché uniquement dans le code source, peut servir à expliquer à celui qui relit le code (y compris soi-même), les subtilités les moins évidentes de celui-ci.

# Toute cette première ligne est un commentaire.
print("Bonjour le monde") # Ceci est également un commentaire
print("Bonjour"); print("Le monde"); # Ceci est une ligne comportant
# plusieurs instructions
print("Cette ligne ne contient pas de #commentaire")
Exemple 1 : On notera que la fonction print affiche son argument.


Commentaires de bloc[modifier | modifier le wikicode]

Les commentaires de bloc (block comments en anglais) permettent de commenter plusieurs lignes. En Python, ils sont assurés par des triples apostrophes ou guillemets :

print('début')
'''
Le paragraphe suivant est commenté
sur plusieurs lignes
'''
print('fin')

Couleurs[modifier | modifier le wikicode]

Il est possible d'écrire en couleurs dans un terminal ANSI (Linux) en précisant leurs codes[2]. Exemple :

print('\x1b[31;40m' + ' Texte rouge ' + '\x1b[0m')
print('\x1b[30;42m' + ' Fond vert ' + '\x1b[0m')

Références[modifier | modifier le wikicode]