Classe « str » Python 3.12.1

Méthode builtins.str.replace

Signature de la méthode replace

 def replace(self, old, new, count=-1) -> str

Description

Produit une nouvelle chaîne en replaçant les occurrences d'une chaîne de caractères par une autre. Si le paramètre count n'est pas spécifié (ou si sa valeur est négative), toutes les occurrences sont remplacées.

>>> "toto titi tata toto".replace("to", "tu")
'tutu titi tata tutu'
>>>

Si le paramètre count est spécifié, seules les count premières occurrences sont remplacées.

>>> "toto titi tata toto".replace("to", "tu", 3)
'tutu titi tata tuto'
>>>

help(str.replace)

Return a copy with all occurrences of substring old replaced by new.

  count
    Maximum number of occurrences to replace.
    -1 (the default value) means replace all occurrences.

If the optional argument count is given, only the first count occurrences are
replaced.

Paramètres

Paramètre	Description
self : str	La chaîne de caractères courante. Rappel : `self` est implicitement passée lors de l'appel de la méthode.
old : str	La sous-chaîne de caractères à remplacer.
new : str	La nouvelle chaîne de caractères.
count : int = -1	Le nombre maximal d'occurrence à remplacer. Une valeur négative demande à remplacer toutes les occurrences.

Valeur de retour

La valeur de retour est de type str.

Elle correspond à la nouvelle chaîne de caractères après remplacement.

Exception

```
 TypeError :
```
Une exception de ce type sera déclenchée si l'un des paramètres n'est pas du type attendu.

Exemple(s) de code

Exemple d'utilisation de la méthode replace.
1 2 3 4 5 6 7 8 9 10	#!/usr/bin/python3 initial_string = "Le langage Perl est fun. Vive Perl !" first = initial_string.replace("Perl", "Python", 1) print("1x:", first) all = initial_string.replace("Perl", "Python") print("all:", all)

#!/usr/bin/python3

initial_string = "Le langage Perl est fun. Vive Perl !"


first = initial_string.replace("Perl", "Python", 1)
print("1x:", first)

all = initial_string.replace("Perl", "Python")
print("all:", all)

Exemple d'utilisation de la méthode replace.

Et voici les résultats produits par cet exemple.

$> python3 sample.py
1x: Le langage Python est fun. Vive Perl !
all: Le langage Python est fun. Vive Python !
$>

Voir aussi

Classe str
Méthode str.expandtabs
Méthode str.lstrip
Méthode str.rstrip
Méthode str.strip

Le tutoriel Python complet (Text+Vidéos)

Le tutoriel Python en vidéos

Evaluez vos compétences en Python

Améliorations / Corrections