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

CKTIS / Python

property()

La lecture de box.area appelle le getter avec l’instance self et donne 3 · 4 = 12.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

property(fget=None, fset=None, fdel=None, doc=None)
@property

La lecture de box.area appelle le getter avec l’instance self et donne 3 · 4 = 12.

Comme descripteur de données, la propriété prévaut sur le dictionnaire de l’instance. Sans setter l’affectation de 8 lève AttributeError.

setter et deleter ajoutent écriture et suppression.

class Box:
    @property
    def area(self): return 12
b = Box()
b.__dict__["area"] = 8
assert b.area == 12

property.setter

@level.setter appelle property.setter et produit une nouvelle propriété dotée d’une écriture. Réutiliser le nom level conserve lecture et écriture sur le même descripteur exposé. m.level=7 modifie _level et le refus de -1 laisse 7.

class Meter:
    def __init__(self):
        self._level = 0
    @property
    def level(self):
        return self._level
    @level.setter
    def level(self, value):
        if value < 0:
            raise ValueError("negative")
        self._level = value
m=Meter()
m.level=7
assert m.level==7
try: m.level=-1
except ValueError: pass
else: raise AssertionError
assert m.level==7

Exemples

class Box:
    @property
    def area(self):
        return 3 * 4

box = Box()
print(box.area)
try:
    box.area = 8
except AttributeError as error:
    print(type(error).__name__)

Résultat

12
AttributeError

setter et deleter ajoutent écriture et suppression.

Sources