str.format()

Insère des valeurs aux emplacements marqués par des accolades.

Renvoie
Une nouvelle chaîne, formatée.
Modifie l’original
Non
Sur cette page

Exemple

#
Python
template = "{name} a obtenu {points:,} pts ({ratio:.0%} de l’objectif)"
print(template.format(name="Léa", points=1240, ratio=0.62))

print("{} + {} = {}".format(2, 3, 2 + 3))
print("{0}{1}{0}".format("ab", "c"))
Résultatrésultat enregistré, vous pouvez le vérifier
Léa a obtenu 1,240 pts (62% de l’objectif)
2 + 3 = 5
abcab

Définition et utilisation

#

La méthode format() remplace les champs {} d’une chaîne par des arguments successifs. Les champs peuvent être numérotés ({0}) ou nommés ({name}), et après un deux-points ils prennent une spécification de format, tout comme dans les f-strings.

Dans du code neuf, les f-strings sont en général plus pratiques. format() reste utile quand le modèle de chaîne est stocké séparément, par exemple dans un fichier de traductions, et rempli plus tard.

Le style de formatage le plus ancien, avec l’opérateur % ("%s a %d ans" % (name, age)), apparaît dans du code plus ancien, mais il vaut mieux l’éviter dans du code neuf.

Syntaxe

#
Syntaxe
modèle.format(*args, **kwargs)

Paramètres

#
  • args, kwargs

    valeurs

    Les valeurs insérées dans les champs positionnels ou nommés.

Bonnes pratiques

#
  • Remplissez les modèles stockés dans des fichiers de traduction ou de configuration à l’aide de format().
  • Dans le code courant, préférez les f-strings, elles sont plus courtes et plus claires.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.