property函数接受的参数:property([fget[,fset[,fdel[,doc]]]])
property函数的作用是在新式类中返回属性值。fget是一个获取属性值的函数,fset是一个设置属性值的函数而fdel是用于del属性值的函数,property函数典型的用法就是定义一个可控属性值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.")
如果给定doc参数,其将成为这个属性值的docstring,否则property函数就会复制fget函数的docstring(如果有的话)。
将property函数用作装饰器可以很方便的创建只读属性:
class Parrot(object):
def __init__(self):
self._voltage = 100000
@property
def voltage(self):
"""Get the current voltage."""
return self._voltage
上面的代码将voltage()方法转化成同名只读属性的”getter”方法:
>>> p = Parrot()
>>> print p.voltage
100000
>>> p.voltage=555
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
AttributeError: can't set attribute
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下的一样,例如这里的x。