WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

property()

Beim Lesen von box.area läuft der Getter mit der Instanz self und liefert 3 · 4 = 12.

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

Syntax

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

Beim Lesen von box.area läuft der Getter mit der Instanz self und liefert 3 · 4 = 12.

Als Datendeskriptor hat die Eigenschaft Vorrang vor dem Instanzwörterbuch. Ohne Setter löst die Zuweisung von 8 AttributeError aus.

setter und deleter ergänzen Schreiben und Löschen.

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

property.setter

@level.setter ruft property.setter auf und erzeugt eine neue Eigenschaft mit Schreibmethode. Derselbe Name level hält Lese- und Schreibzugriff am selben Deskriptor. m.level=7 ändert _level und ein abgelehntes -1 lässt 7 bestehen.

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

Beispiele

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__)

Ergebnis

12
AttributeError

setter und deleter ergänzen Schreiben und Löschen.

Quellen