除了 __doc__,函数对象还有很多属性。使用 dir 函数可以探知 factorial 具有下述属性:
>>> dir(factorial) ['__annotations__', '__call__', '__class__', '__closure__', '__code__', '__defaults__', '__delattr__', '__dict__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__get__', '__getattribute__', '__globals__', '__gt__', '__hash__', '__init__', '__kwdefaults__', '__le__', '__lt__', '__module__', '__name__', '__ne__', '__new__', '__qualname__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__'] >>>
其中大多数属性是 Python 对象共有的。本节讨论与把函数视作对象相关的几个属性,先从 __dict__ 开始。
与用户定义的常规类一样,函数使用 __dict__ 属性存储赋予它的用户属性。这相当于一种基本形式的注解。一般来说,为函数随意赋予属性不是很常见的做法,但是 Django 框架这么做了。参见“The Django admin site”文档(https://docs.djangoproject.com/en/1.10/ref/contrib/admin/)中对 short_description、boolean 和 allow_tags 属性的说明。这篇 Django 文档中举了下述示例,把 short_description 属性赋予一个方法,Django 管理后台使用这个方法时,在记录列表中会出现指定的描述文本:
def upper_case_name(obj):
return ("%s %s" % (obj.first_name, obj.last_name)).upper()
upper_case_name.short_description = 'Customer name'
下面重点说明函数专有而用户定义的一般对象没有的属性。计算两个属性集合的差集便能得到函数专有属性列表(见示例 5-9)。
示例 5-9 列出常规对象没有而函数有的属性
>>> class C: pass # ➊ >>> obj = C() # ➋ >>> def func(): pass # ➌ >>> sorted(set(dir(func)) - set(dir(obj))) # ➍ ['__annotations__', '__call__', '__closure__', '__code__', '__defaults__', '__get__', '__globals__', '__kwdefaults__', '__name__', '__qualname__'] >>>
➊ 创建一个空的用户定义的类。
➋ 创建一个实例。
➌ 创建一个空函数。
➍ 计算差集,然后排序,得到类的实例没有而函数有的属性列表。
表 5-1 对示例 5-9 中列出的属性做了简要说明。
表5-1:用户定义的函数的属性
名称 |
类型 |
说明 |
|---|---|---|
|
|
参数和返回值的注解 |
|
|
实现 |
|
|
函数闭包,即自由变量的绑定(通常是 |
|
|
编译成字节码的函数元数据和函数定义体 |
|
|
形式参数的默认值 |
|
|
实现只读描述符协议(参见第 20 章) |
|
|
函数所在模块中的全局变量 |
|
|
仅限关键字形式参数的默认值 |
|
|
函数名称 |
|
|
函数的限定名称,如 |
后面几节会讨论 __defaults__、__code__ 和 __annotations__ 属性,IDE 和框架使用它们提取关于函数签名的信息。但是,为了深入了解这些属性,我们要先探讨 Python 为声明函数形参和传入实参所提供的强大句法。