Python Fonction property()

Python 内置函数Fonctions intégrées de Python


Description

property()La fonction est utilisée pour renvoyer les valeurs d'attribut dans les classes de nouveau style.

Syntaxe

Voici la syntaxe de la méthode property() :

class property([fget[, fset[, fdel[, doc]]]])

Parameters

  • fget -- Fonction pour obtenir la valeur de l'attribut
  • fset -- Fonction pour définir la valeur de l'attribut
  • fdel -- Fonction pour supprimer la valeur de l'attribut
  • doc -- Informations de description de l'attribut

Valeur de retour

Renvoie les attributs des classes de nouveau style.

Exemples

Définir une valeur d'attribut contrôlable x

class C(object): def __init__(self): self._x = None def getx(self): return self._x def setx(self, value): self._x = value def delx(self): del self._x x = property(getx, setx, delx, "Je suis la propriété 'x'.")

SicOuiCSi c est une instance de C, c.x déclenchera le getter, c.x = value déclenchera le setter, et del c.x déclenchera le deleter.

Si le paramètre doc est donné, il deviendra la docstring de la valeur de cet attribut ; sinon, la fonction property copiera la docstring de la fonction fget (le cas échéant).

Utiliser la fonction property comme décorateur permet de créer facilement des propriétés en lecture seule :

class Parrot(object): def __init__(self): self._voltage = 100000 @property def voltage(self): """Obtenir la tension actuelle.""" return self._voltage

Le code ci-dessus convertit la méthode voltage() en une méthode getter pour une propriété en lecture seule du même nom.

Les méthodes getter, setter et deleter de property peuvent également être utilisées comme décorateurs :

class C(object): def __init__(self): self._x = None @property def x(self): """Je suis la propriété 'x'.""" return self._x @x.setter def x(self, value): self._x = value @x.deleter def x(self): del self._x

Ce code est exactement le même que le premier exemple, mais notez que les noms de ces fonctions supplémentaires sont les mêmes que ceux sous property, comme x ici.

Python 内置函数Fonctions intégrées de Python

Autres extensions