Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

Paramètre positionnel à arité variable `*items`

Dans une définition de fonction, `*items` regroupe les arguments positionnels restants dans un tuple. À l’appel, `*values` fait l’inverse : il transmet les éléments d’un itérable comme arguments positionnels distincts.

Version : Python 3.12

Syntaxe

def macro_bullet(title, *items, marker="-"):
    ...

En Python 3.12, *items dans une définition de fonction déclare un paramètre positionnel à arité variable. Dans def macro_bullet(title, *items, marker="-") :, le premier argument positionnel est affecté à title et les suivants forment le tuple items, dans l’ordre où ils sont transmis. S’il ne reste aucun argument positionnel, items vaut (). Le nom items est libre ; args est courant.

Un paramètre ordinaire placé après *items, comme marker, ne peut être renseigné que par mot-clé, par exemple avec marker="+". Écrire items=... n’affecte pas le tuple items : l’appel lève TypeError sauf si la fonction accepte ce mot-clé via **kwargs, qui recueille les arguments nommés supplémentaires dans un dictionnaire distinct. Un * seul marque le début des paramètres à renseigner par mot-clé, sans recueillir d’arguments positionnels.

Dans l’appel macro_bullet("Plan", *values), l’astérisque dépaquette l’itérable values en arguments positionnels distincts. Sans astérisque, values est transmis comme un seul argument, même si c’est une liste. Dans la définition, l’astérisque regroupe les arguments ; lors de l’appel, il les dépaquette.

Exemples

def macro_bullet(title, *items, marker="-"):
    return title, items, marker

values = [10, 20]
print(macro_bullet("Plan"))
print(macro_bullet("Plan", values))
print(macro_bullet("Plan", 10, 20, marker="+"))
print(macro_bullet("Plan", *values, marker="+"))

Résultat

('Plan', (), '-')
('Plan', ([10, 20],), '-')
('Plan', (10, 20), '+')
('Plan', (10, 20), '+')

La première ligne montre un tuple vide ; la deuxième, un tuple contenant une seule liste. Les deux dernières lignes sont identiques : dépaqueter `values` transmet les mêmes nombres que si on les écrivait séparément. Les deux appels fournissent `marker` par mot-clé.

Leçons associées

  • Python · Leçon 34 · Avancé · Version : 5

Sources