2.1.5.1 Méthodes des chaînes de caractères
Les méthodes suivantes sont applicables aux chaînes de caractères 8-bits
et aux chaînes unicode (ou objets unicode).
stringcapitalize()
-
Retourne une copie de la chaîne avec seulement le premier caractère en capitale.
stringcenter(longueur)
-
Retourne un chaîne centrée de taille longueur, le remplissage est
réalisé avec des espaces.
stringcount(souschaine[, debut[, fin]])
-
Retourne le nombre d'occurrences de la sous-chaîne souschaine dans la chaîne
S
[debut:fin]. Les arguments en option debut et fin
sont compris comme dans les notations propres aux intervalles.
stringencode([encodage[,erreurs]])
-
Retourne une version encodée de la chaîne. L'encodage par défaut est l'encodage
courant. erreurs peut être spécifié comme autre mode de gestion d'erreurs.
Le mode par défaut est
'strict', qui signifie que toute erreur lève une
exception ValueError. Les autres modes sont 'ignore' et
'replace'.
stringendswith(suffixe[, debut[, fin]])
-
Retourne vrai si la chaîne se termine par le suffixe suffixe, sinon
retourne faux. Si debut est fourni, la comparaison commence à cette
position ; si fin est fourni, elle se termine à cette position.
stringexpandtabs([tailletab])
-
Retourne une copie de la chaîne avec les tabulations traduites en espaces.
Si tailletab est absent, la taille
8 est utilisée. Autrement
dit, chaque tabulation est remplacée par 8 espaces.
stringfind(souschaine[, debut[, fin]])
-
Retourne le plus petit index où se trouve souschaine. Si les arguments
debut et fin sont spécifiés, avec la notation propre aux intervalles,
seul l'intervalle spécifié est examiné. Retourne
-1 si souschaine
est absente.
stringindex(souschaine[, debut[, fin]])
-
Similaire à find(), mais lève l'exception ValueError
si souschaine n'est pas trouvée.
stringisalnum()
-
Retourne vrai si la chaîne est non vide et ne contient que des
caractères alphanumériques, sinon retourne faux.
stringisalpha()
-
Retourne vrai si la chaîne est non vide et ne contient que des
caractères alphabétiques, sinon retourne faux.
stringisdigit()
-
Retourne vrai si la chaîne est non vide et ne contient que des
chiffres, sinon retourne faux.
stringislower()
-
Retourne vrai si la chaîne est non vide et ne contient que des
minuscules, sinon retourne faux.
stringisspace()
-
Retourne vrai si la chaîne est non vide et ne contient que des
espaces, sinon retourne faux.
stringistitle()
-
Retourne vrai si la chaîne peut être considérée comme titre, c'est à dire
que les majuscules sont précédées de caractères sans casse (chiffres, espaces, etc)
et que les minuscules sont précédées de caractères avec casse.
Sinon retourne faux
stringisupper()
-
Retourne vrai si tous les caractères avec casse de la chaîne sont en majuscule
et si la chaîne contient au moins un caractère avec casse, sinon retourne faux.
stringjoin(seq)
-
Retourne la chaîne résultant de la concaténation des chaînes de seq.
Le séparateur entre les éléments est la chaîne dont cette méthode est un attribut
('*'.join(['un','deux','trois']) donne 'un*deux*trois').
stringljust(taille)
-
Retourne la chaîne justifiée à gauche dans une chaîne de longueur taille.
Le remplissage est réalisé avec des espaces. La chaîne originelle est retournée
si taille est plus petite que
len(s).
stringlower()
-
Retourne une copie de la chaîne convertie en minuscules.
stringlstrip()
-
Retourne une copie de la chaîne sans espace en début de chaîne.
stringreplace(avant, apres[, max])
-
Retourne une copie de la chaîne avec les sous-chaînes avant
remplacées par apres. Si l'argument max est spécifié,
seules les max premières sous-chaînes avant sont remplacées.
stringrfind(souschaine [,debut [,fin]])
-
Retourne l'index le plus grand pour lequel souschaine est trouvée.
Si les arguments
debut et fin sont spécifiés, avec la notation propre aux intervalles,
seul l'intervalle spécifié est examiné.
stringrindex(souschaine [,debut [,fin]])
-
Comportement identique à rfind() mais lève une exception ValueError
si souschaine n'est pas trouvée.
stringrjust(taille)
-
Retourne la chaîne justifiée à droite dans une chaîne de taille.
Le remplissage est réalisé avec des espaces. La chaîne originelle est retournée
si taille est plus petite que
len(s).
stringrstrip()
-
Retourne une copie de la chaîne sans espace en fin de chaîne.
stringsplit([sep [,max]])
-
Retourne une liste des mots de la chaîne en utilisant sep
comme délimiteur. Si max est spécifié, au plus max découpages
sont effectués. Si sep n'est pas spécifié ou vaut
None,
toute chaîne d'espaces est considérée comme séparateur.
stringsplitlines([gardefinsdeligne])
-
Retourne une liste de chaînes. Chaque chaîne est une ligne de la chaîne
originelle, les fins de lignes ne sont pas incluses sauf si gardefinsdeligne
contient la valeur vrai.
stringstartswith(prefixe[, debut[, fin]])
-
Retourne vrai si la chaîne débute avec prefixe, sinon retourne faux.
Les arguments optionnels debut et fin spécifient l'intervalle à prendre
en compte dans la chaîne.
stringstrip()
-
Retourne une copie de la chaîne sans espaces en début et fin de chaîne.
stringswapcase()
-
Retourne une copie de la chaîne pour laquelle les majuscules sont converties
en minuscules et vice-versa.
stringtitle()
-
Retourne une chaîne au format titre (à l'anglaise), c'est-à-dire
que les mots commencent par une majuscule et que toutes les autres
lettres sont en minuscule.
stringtranslate(table[, efface])
-
Retourne une copie de la chaîne où les caractères présents dans
la chaîne optionnelle efface sont enlevés, et ceux qui restent sont changés en
se basant sur la table de traduction table. Cette table est
une chaîne de taille 256; le caractère
chr(i) de la chaîne d'origine
est traduit en table[i].
stringupper()
-
Retourne une copie de la chaîne convertie en majuscules.
