Que signifient les barres obliques dans la sortie `help()` de Python pour les signatures de méthodes ?

Comprendre les barres obliques dans la sortie d'aide de Python pour les signatures de méthode

Lors de l'utilisation de la fonction help() de Python, les utilisateurs peuvent rencontrer des barres obliques dans la sortie de la méthode signatures. Cet article démystifie la signification de ce symbole, donnant un aperçu de sa signification.

Paramètres de position uniquement

La barre oblique (/) indique la fin des paramètres de position uniquement. dans une signature de méthode. Ce sont des paramètres qui ne peuvent pas être transmis en tant qu'arguments de mot-clé, ce qui signifie qu'ils doivent être spécifiés dans le bon ordre. Avant Python 3.8, les paramètres de position uniquement étaient limités à l'API C.

Exemple : contient Méthode

Par exemple, dans l'aide sortie pour la méthode __contains__ de l'objet range, la barre oblique indique que l'argument clé ne peut être fourni que par position:

>>> help(range.__contains__)
...
__contains__(self, key, /)
    Return key in self.
...

Cela signifie qu'une syntaxe telle que range(5).__contains__(key=3) n'est pas valide, car l'argument clé doit être passé par position : range(5).__contains__(3) .

Documentation Argument Clinic

La documentation Argument Clinic fournit des informations supplémentaires clarification :

Pour marquer tous les paramètres comme étant uniquement positionnels dans Argument Clinic, ajoutez un / sur une ligne seule après le dernier paramètre, en retrait de la même manière que les lignes de paramètres.

FAQ Python et PEP 570

Récemment, la FAQ Python a également abordé les questions de position uniquement paramètres :

Une barre oblique dans la liste d'arguments d'une fonction indique que les paramètres qui la précèdent sont uniquement de position.

De plus, PEP 570 a codifié la syntaxe des paramètres de position uniquement dans Python spécification du langage à partir de la version 3.8.

Avantages du positionnement uniquement Paramètres

L'utilisation de paramètres de position uniquement offre plusieurs avantages :

• API plus propres : Elle applique l'ordre des paramètres, rendant le code plus lisible et moins sujet aux erreurs.
• Cohérence améliorée : Implémentations Pure-Python des modules C uniquement deviennent plus cohérents et maintenables.
• Performance : Les paramètres de position uniquement nécessitent moins de traitement, ce qui entraîne une vitesse d'exécution du code améliorée.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!