Python 对象 __***__ 变量含义说明

Python 对象 __***__ 变量含义说明

模块（module）

• __doc__: 文档字符串。如果模块没有文档，这个值是None。
• __name__: 始终是定义时的模块名；即使你使用import .. as 为它取了别名，或是赋值给了另一个变量名。
• __dict__: 包含了模块里可用的属性名-属性的字典；也就是可以使用模块名.属性名访问的对象。
• __file__: 包含了该模块的文件路径。需要注意的是内建的模块没有这个属性，访问它会抛出异常！

类（class）

• __doc__: 文档字符串。如果类没有文档，这个值是None。
• __name__: 始终是定义时的类名。
• __dict__: 包含了类里可用的属性名-属性的字典；也就是可以使用类名.属性名访问的对象。
• __module__: 包含该类的定义的模块名；需要注意，是字符串形式的模块名而不是模块对象。
• __bases__: 直接父类对象的元组；但不包含继承树更上层的其他类，比如父类的父类。
• __mro__: 方法解析顺序；由于 Python 支持多重继承，如果父类具有相同的方法，那么将按照该元组给出的顺序选择真正执行的函数。

实例（instance）

• __dict__: 包含了可用的属性名-属性字典。
• __class__: 该实例的类对象。对于类Cat，cat.__class__ == Cat 为 True。

内建函数和方法(built-in functions and methods)

• __doc__: 函数或方法的文档。
• __name__: 函数或方法定义时的名字。
• __self__: 仅方法可用，如果是绑定的(bound)，则指向调用该方法的类（如果是类方法）或实例（如果是实例方法），否则为None。
• __module__: 函数或方法所在的模块名。

函数(function)

• __doc__: 函数的文档；另外也可以用属性名func_doc。
• __name__: 函数定义时的函数名；另外也可以用属性名func_name。
• __module__: 包含该函数定义的模块名；同样注意，是模块名而不是模块对象。
• __dict__: 函数的可用属性；另外也可以用属性名func_dict。 
  不要忘了函数也是对象，可以使用函数.属性名访问属性（赋值时如果属性不存在将新增一个），或使用内置函数has/get/setattr()访问。不过，在函数中保存属性的意义并不大。
• func_defaults: 这个属性保存了函数的参数默认值元组；因为默认值总是靠后的参数才有，所以不使用字典的形式也是可以与参数对应上的。
• func_code: 这个属性指向一个该函数对应的code对象，code对象中定义了其他的一些特殊属性，将在下文中另外介绍。
• func_globals: 这个属性指向当前的全局命名空间而不是定义函数时的全局命名空间，用处不大，并且是只读的。
• func_closure: 这个属性仅当函数是一个闭包时有效，指向一个保存了所引用到的外部函数的变量cell的元组，如果该函数不是一个内部函数，则始终为None。这个属性也是只读的。

方法(method)

• __doc__: 与函数相同。
• __name__: 与函数相同。
• __module__: 与函数相同。
• im_func: 使用这个属性可以拿到方法里实际的函数对象的引用。另外如果是2.6以上的版本，还可以使用属性名__func__。
• im_self: 如果是绑定的(bound)，则指向调用该方法的类（如果是类方法）或实例（如果是实例方法），否则为None。如果是2.6以上的版本，还可以使用属性名__self__。
• im_class: 实际调用该方法的类，或实际调用该方法的实例的类。注意不是方法的定义所在的类，如果有继承关系的话。

生成器(generator)

• __iter__: 仅仅是一个可迭代的标记。
• gi_code: 生成器对应的code对象。
• gi_frame: 生成器对应的frame对象。
• gi_running: 生成器函数是否在执行。生成器函数在yield以后、执行yield的下一行代码前处于frozen状态，此时这个属性的值为0。
• next|close|send|throw: 这是几个可调用的方法，并不包含元数据信息，如何使用可以查看生成器的相关文档。

代码块(code)

• co_argcount: 普通参数的总数，不包括*参数和**参数。
• co_names: 所有的参数名（包括*参数和**参数）和局部变量名的元组。
• co_varnames: 所有的局部变量名的元组。
• co_filename: 源代码所在的文件名。
• co_flags:  这是一个数值，每一个二进制位都包含了特定信息。较关注的是0b100(0x4)和0b1000(0x8)，如果co_flags & 0b100 != 0，说明使用了*args参数；如果co_flags & 0b1000 != 0，说明使用了**kwargs参数。另外，如果co_flags & 0b100000(0x20) != 0，则说明这是一个生成器函数(generator function)。

栈帧(frame)

栈帧表示程序运行时函数调用栈中的某一帧。函数没有属性可以获取它，因为它在函数调用时才会产生，而生成器则是由函数调用返回的，所以有属性指向栈帧。想要获得某个函数相关的栈帧，则必须在调用这个函数且这个函数尚未返回时获取。你可以使用sys模块的_getframe()函数、或inspect模块的currentframe()函数获取当前栈帧。这里列出来的属性全部是只读的。

• f_back: 调用栈的前一帧。
• f_code: 栈帧对应的code对象。
• f_locals: 用在当前栈帧时与内建函数locals()相同，但你可以先获取其他帧然后使用这个属性获取那个帧的locals()。
• f_globals: 用在当前栈帧时与内建函数globals()相同，但你可以先获取其他帧……。

追踪(traceback)

追踪是在出现异常时用于回溯的对象，与栈帧相反。由于异常时才会构建，而异常未捕获时会一直向外层栈帧抛出，所以需要使用try才能见到这个对象。你可以使用sys模块的exc_info()函数获得它，这个函数返回一个元组，元素分别是异常类型、异常对象、追踪。traceback的属性全部是只读的。

• tb_next: 追踪的下一个追踪对象。
• tb_frame: 当前追踪对应的栈帧。
• tb_lineno: 当前追踪的行号。

使用inspect模块

检查对象类型

• is{module|class|function|method|builtin}(obj): 
  检查对象是否为模块、类、函数、方法、内建函数或方法。
• isroutine(obj): 
  用于检查对象是否为函数、方法、内建函数或方法等等可调用类型。用这个方法会比多个is*()更方便，不过它的实现仍然是用了多个is*()。 对于实现了__call__的类实例，这个方法会返回False。如果目的是只要可以直接调用就需要是True的话，不妨使用isinstance(obj, collections.Callable)这种形式。我也不知道为什么Callable会在collections模块中，抱歉！我大概是因为collections模块中包含了很多其他的ABC(Abstract Base Class)的缘故吧：）

获取对象信息

• getmembers(object[, predicate]): 
  这个方法是dir()的扩展版，它会将dir()找到的名字对应的属性一并返回，形如[(name, value), ...]。另外，predicate是一个方法的引用，如果指定，则应当接受value作为参数并返回一个布尔值，如果为False，相应的属性将不会返回。使用is*作为第二个参数可以过滤出指定类型的属性。
• getmodule(object): 
  还在为第2节中的__module__属性只返回字符串而遗憾吗？这个方法一定可以满足你，它返回object的定义所在的模块对象。
• get{file|sourcefile}(object): 
  获取object的定义所在的模块的文件名|源代码文件名（如果没有则返回None）。用于内建的对象（内建模块、类、函数、方法）上时会抛出TypeError异常。
• get{source|sourcelines}(object): 
  获取object的定义的源代码，以字符串|字符串列表返回。代码无法访问时会抛出IOError异常。只能用于module/class/function/method/code/frame/traceack对象。
• getargspec(func): 
  仅用于方法，获取方法声明的参数，返回元组，分别是(普通参数名的列表, *参数名, **参数名, 默认值元组)。如果没有值，将是空列表和3个None。如果是2.6以上版本，将返回一个命名元组(Named Tuple)，即除了索引外还可以使用属性名访问元组中的元素。  
• getargvalues(frame): 
  仅用于栈帧，获取栈帧中保存的该次函数调用的参数值，返回元组，分别是(普通参数名的列表, *参数名, **参数名, 帧的locals())。如果是2.6以上版本，将返回一个命名元组(Named Tuple)，即除了索引外还可以使用属性名访问元组中的元素。 
• getcallargs(func[, *args][, **kwds]): 
  返回使用args和kwds调用该方法时各参数对应的值的字典。这个方法仅在2.7版本中才有。
• getmro(cls): 
  返回一个类型元组，查找类属性时按照这个元组中的顺序。如果是新式类，与cls.__mro__结果一样。但旧式类没有__mro__这个属性，直接使用这个属性会报异常，所以这个方法还是有它的价值的。 返回当前的栈帧对象。