Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

property()

A leitura de box.area chama a função de leitura com a instância self e dá 3 · 4 = 12.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

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

A leitura de box.area chama a função de leitura com a instância self e dá 3 · 4 = 12.

Como descritor de dados, a propriedade prevalece sobre o dicionário da instância. Sem setter atribuir 8 gera AttributeError.

setter e deleter acrescentam escrita e remoção.

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

property.setter

@level.setter chama property.setter e cria uma nova propriedade com escrita. Reutilizar o nome level mantém leitura e escrita no mesmo descritor exposto. m.level=7 altera _level e rejeitar -1 conserva 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

Exemplos

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

Resultado

12
AttributeError

setter e deleter acrescentam escrita e remoção.

Fontes