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