DESCRIPTION.

Retourne une nouvelle chaine de caractères formatés en fonction des arguments à insérer aux positions indiquées.

SYNTAXE.

Texte = chaine.format ( donnees )

Texte = ⇨ variable qui recevra la nouvelle chaine [ optionnel ]

chaine ⇨ chaine de caractères [ OBLIGATOIRE ]

.format ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

donnees ⇨ données à insérer [ OBLIGATOIRE ]

REMARQUES.

chaine doit être un str ( ) valide.

donnees peut avoir la forme : 

- d'un tuple ( ), les valeurs sont identifiées par leur index ;

- d'un dict ( ), les valeurs sont nommées et identifiées par leur nom ;

- ou les deux, dans ce cas la forme dict ( ) doit être placé en deuxième.

Depuis Python 3.6 str ( ).format ( ) est remplacé par f" { } " (f-string) plus lisible. La connaissance de format ( ) se limite maintenant à la maintenance, voire la conversion, d'anciens scripts où l'emploi de format ( ) est fréquent.

EXEMPLES.

print ( "2² = {0}, 3² = {1}, 4² = {2}, 5² = {3}.".format ( 4 , 3*3 , "16" , 5**2 ) ) retourne 2² = 4, 3² = 9, 4² = 16, 5² = 25.

print ( "{1} et {0}.".format ( "Eve" , "Adam" ) ) retourne Adam et Eve.

Monsieur = "Dupont"

print ( "Bonjour Monsieur {0}.".format ( Monsieur ) ) retourne Bonjour Monsieur Dupont.

Madame = "Durant"

Accueil = "Bienvenue Madame {0}.".format ( Madame )

print ( Accueil ) retourne Bienvenue Madame Durant.

print ( "Bonjour {0}.".format ( "Messieurs" , "Mesdames" ) ) retourne Bonjour Messieurs.

print ( "Bonjour {1}.".format ( "Messieurs" , "Mesdames" ) ) retourne Bonjour Mesdames.

print ( "Bonjour {2}.".format ( "Messieurs" , "Mesdames" ) ) retourne IndexError: Replacement index 2 out of range for positional args tuple

print ( "2² = {0}, 3² = {1}, 4² = {quatre}, 5² = {cinq}.".format ( "4" , 9 , quatre = "16" , cinq = 25 ) ) retourne 2² = 4, 3² = 9, 4² = 16, 5² = 25.