DESCRIPTION.

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

SYNTAXE.

Texte = chaine.format_map ( donnees )

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

chaine ⇨ chaine de caractères [ OBLIGATOIRE ]

.format_map ( ) ⇨ 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 dict ( ), les valeurs sont nommées et identifiées par leur nom.

La méthode .format_map ( ) est identique à la méthode .format ( ), mais elle n'accepte que des dict ( ) en argument.

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² = { deux }, 3² = { trois }.".format_map ( { "deux" : 4 , "trois" : 9 } ) ) retourne 2² = 4, 3² = 9.

print ( "{ homme } et { femme }.".format_map ( { "femme" : "Eve" , "homme" : "Adam" } ) ) retourne Adam et Eve.

print ( "{ fils } et { fille }.".format_map ( { "femme" : "Eve" , "homme" : "Adam" } ) ) retourne KeyError: 'fils'.

DCT_Titres = { "femme" : "Mesdames" , "homme" : "Messieurs" }

print ( "Bonjour { femme }.".format_map ( DCT_Titres ) ) retourne Bonjour Mesdames.

print ( "Bonjour { homme }.".format_map ( DCT_Titres ) ) retourne Bonjour Messieurs.

print ( "Bonjour { couple }.".format_map ( DCT_Titres ) ) retourne KeyError: 'couple'