Classe « str » Python 3.11.3

Méthode builtins.str.startswith

Signature de la méthode startswith

 def startswith(self, prefix, start=0, end=None) -> bool

Description

Cette méthode permet de déterminer si une chaîne (ou une sous-chaîne) commence par le préfixe spécifié. Vous pouvez spécifier le(s) préfixe(s) via le premier paramètre qui doit être une chaîne de caractères ou un tuple de chaînes de caractères : dans le dernier cas, chaque préfixe sera testé à tour de rôle.

Si vous souhaitez tester si la chaîne totale commence par le préfixe, spécifiez qu'un unique paramètre : le(s) préfixe(s) à tester.
Si vous souhaitez tester si une partie de la chaîne courante commence par le préfixe, veuillez spécifier des valeurs pour les deux paramètres suivants.

De plus, l'appel "a sample string".startswith("str", 9, 15) est équivalent à "a sample string"[9:15].startswith("str") (slice notation).

help(str.startswith)

S.startswith(prefix[, start[, end]]) -> bool

Return True if S starts with the specified prefix, False otherwise.
With optional start, test S beginning at that position.
With optional end, stop comparing S at that position.
prefix can also be a tuple of strings to try.

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.
prefix : str\|tuple	La chaîne de caractères (ou un tuple de chaînes de caractères) à tester comme préfixe.
start : int = 0	L'indice du premier caractère à partir duquel réaliser la vérification. Rappel : les indices sont basés à partir de 0.
end : int = None	Indice du caractère à partir duquel arrêter la vérification. La valeur `None` indiquant que le test se fait jusqu'à la fin de la chaîne courante.

Valeur de retour

La valeur de retour est de type str.

Retourne True si la chaîne commence bien par le préfixe spécifié (ou l'un des préfixes), False dans le cas contraire.

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 startswith
1 2 3 4 5 6 7 8 9 10 11 12 13 14	#!/usr/bin/python3 import os log_file_count = 0 entries = os.listdir(".") for entry in entries: if not entry.startswith("log-"): continue print(entry, "est un fichier de log.") log_file_count += 1 print(log_file_count, "fichier(s) de log pour", len(entries), "fichiers.")

#!/usr/bin/python3

import os

log_file_count = 0
entries = os.listdir(".")

for entry in entries:
    if not entry.startswith("log-"): 
        continue
    print(entry, "est un fichier de log.")
    log_file_count += 1
    
print(log_file_count, "fichier(s) de log pour", len(entries), "fichiers.")

Exemple d'utilisation de la méthode startswith

Et voici les résultats produits par cet exemple.

$> python3 sample.py
log-2020-03-01.txt est un fichier de log.
1 fichier(s) de log pour 8 fichiers.
$>

Voir aussi

Classe str
Méthode str.count
Méthode str.endswith
Méthode str.find
Méthode str.index
Méthode str.rfind
Méthode str.rindex

Le tutoriel Python complet (Text+Vidéos)

Le tutoriel Python en vidéos

Evaluez vos compétences en Python

Améliorations / Corrections