Module « builtins » Python 3.11.3

Fonction len - module builtins

Signature de la fonction len

 def len(data) -> int

Description

Cette fonction permet de calculer la taille d'une donnée composées (chaîne de caractères, list, tuple, set, dict...). C'est le fait qu'il s'agisse d'une fonction et non d'une méthode, qui garanti que l'on pourra invoquer len sur des données de divers types. Voici quelques exemples d'utilisation de la fonction len.

>>> # Comment calculer la taille d'une chaîne de caractères ?
>>> len("Une chaîne de caractères")
24
>>> # Comment calculer la taille d'une liste ?
>>> len(["une", "liste", "de", "string"])
4
>>> # Comment calculer la taille d'un tuple ?
>>> len(("un", "tuple", "de", "string"))
4
>>> # Comment calculer la taille d'un dictionnaire ?
>>> len({"first": 10, "second": 20})
2
>>> # Comment calculer la taille d'un set ?
>>> len({10, 20, 30, 10, 20, 30, 40})
4
>>>

help(builtins.len)

Return the number of items in a container.

Paramètre

Paramètre	Description
data : object	La donnée pour laquelle calculer sa taille.

Valeur de retour

La valeur de retour est de type int.

Elle correspond au nombre d'éléments constituant la donnée passée en paramètre.

Exception

```
 TypeError :
```
Une exception de ce type sera déclenchée si la valeur passée en paramètre n'est pas un ensemble d'éléments. De manière plus précise, l'objet passé en paramètre doit exposer une méthode __len__() pour que la fonction puisse correctement évaluer son résultat.

Exemple(s) de code

Comment utiliser la fonction len sur des collections

On considère, bien entendu, qu'une chaîne de caractères est une collection de caractères.

Exemple d'utilisation de la fonction len.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16	#!/usr/bin/python3 try: with open("AFile.txt", "r") as inputFile: lines = inputFile.readlines() if len(lines) == 0: raise Exception("Le fichier doit contenir au moins une ligne de texte") for line in lines: line = line.strip() if len(line) == 0: raise Exception("Une ligne du fichier ne doit pas être vide") print("J'ai réussi à charger plein de données :-)") except: print("Le Fichier spécifié ne peut pas être lu") print("bye bye")

#!/usr/bin/python3

try: 
    with open("AFile.txt", "r") as inputFile:
        lines = inputFile.readlines()
        if len(lines) == 0:
            raise Exception("Le fichier doit contenir au moins une ligne de texte")
        for line in lines:
            line = line.strip()
            if len(line) == 0:
                raise Exception("Une ligne du fichier ne doit pas être vide")
        print("J'ai réussi à charger plein de données :-)")
except:
    print("Le Fichier spécifié ne peut pas être lu")
    
print("bye bye")

Exemple d'utilisation de la fonction len.

Comment définir une classe supportant le calcul de taille ?

Pour support le calcul de taille, une classe doit fournir une méthode __len__(). Comme le nom de cette méthode commence par deux underscores (caractère blanc souligné) et se termine par deux underscores, cela sous-entend que vous ne devez pas invoquer cette méthode en direct (obj.__len__()). Veuillez préférer l'utilisation de la fonction len qui finira par invoquer la méthode __len__.

Voici comment définir une classe supportant le calcul de taille.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17	#!/usr/bin/python3 from random import randint class MyCollection: def __init__(self): pass def __len__(self): # On calcule une taille aléatoire (c'est un exemple). return randint(0, 10) if __name__ == '__main__': obj = MyCollection() print(len(obj))

#!/usr/bin/python3

from random import randint

class MyCollection:
    
    def __init__(self):
        pass
    
    def __len__(self):
        # On calcule une taille aléatoire (c'est un exemple).
        return randint(0, 10)
    
    
if __name__ == '__main__':
    obj = MyCollection()
    print(len(obj))