Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

str : la représentation textuelle d’un objet

str crée une chaîne Unicode. Convertir un nombre en texte n’effectue pas de calcul ; transformer des octets en texte exige de choisir consciemment un encodage.

Version : Python 3.14

Syntaxe

str()
str(object)
str(object, encoding, errors='strict')

str(23) produit le texte "23". Le joindre à "5" donne donc "235", pas une somme numérique. Les chaînes sont immuables : les méthodes qui renvoient du texte modifié produisent un résultat au lieu de changer un caractère de la chaîne existante. str() sans argument donne une chaîne vide.

Pour les objets, str utilise leur représentation lisible, définie par __str__. repr a un autre objectif : une représentation utile au débogage. Ne suppose pas que toute chaîne obtenue à partir d’un objet pourra être reconvertie sans perte.

str(b"ok") affiche la représentation de l’objet d’octets, avec son marqueur b, au lieu de décoder son contenu. str(b"ok", "utf-8") décode les octets selon l’encodage indiqué. Des octets invalides en mode strict, utilisé par défaut, déclenchent UnicodeDecodeError ; ignorer les erreurs peut perdre des données.

L’exemple montre ces deux chemins séparément. str ne fournit ni échappement HTML, ni protection SQL, ni format d’échange sûr. Choisis un mécanisme adapté, comme les paramètres de requête ou la sérialisation JSON.

Exemples

print(str(23) + "5")
print(str(b"ok"))
print(str(b"ok", "utf-8"))
try:
    str(b"\xff", "utf-8")
except UnicodeDecodeError:
    print("UnicodeDecodeError")

Résultat

235
b'ok'
ok
UnicodeDecodeError

Sources