Python property() 函数
Python 内置的 property() 函数用于在新式类中返回属性值
语法
class property([fget[, fset[, fdel[, doc]]]])
参数
参数 | 说明 |
---|---|
fget | 获取属性值的函数 |
fset | 设置属性值的函数 |
fdel | 删除属性值函数 |
doc | 属性描述信息 |
返回值
返回新式类属性
范例
定义一个可控属性值 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, "I'm the 'x' property.")
如果 c 是 C 的实例, 那么
- c.x 将触发 getter
- c.x = value 将触发 setter
- del c.x 触发 deleter
如果指定了 doc 参数,其将成为这个属性值的 docstring,否则 property 函数就会复制 fget 函数的 docstring ( 如果有的话 )
范例 2
将 property() 函数用作装饰器可以很方便的创建只读属性
class Parrot(object): def __init__(self): self._voltage = 100000 @property def voltage(self): """Get the current voltage.""" return self._voltage
上面的代码将 voltage() 方法转化成同名只读属性的 getter 方法
范例 3
property() 方法的 getter, setter 和 deleter 方法同样可以用作装饰器
class C(object): def __init__(self): self._x = None @property def x(self): """I'm the 'x' property.""" return self._x @x.setter def x(self, value): self._x = value @x.deleter def x(self): del self._x
这个代码的作用和第一个例子完全相同,请注意这些额外函数的名字和 property 下的一样