6.3. dir() 函数

内置函数 dir() 用于查找模块定义的名称。 它返回一个排序过的字符串列表:

  1. >>> import fibo, sys
  2. >>> dir(fibo)
  3. ['__name__', 'fib', 'fib2']
  4. >>> dir(sys)
  5. ['__breakpointhook__', '__displayhook__', '__doc__', '__excepthook__',
  6. '__interactivehook__', '__loader__', '__name__', '__package__', '__spec__',
  7. '__stderr__', '__stdin__', '__stdout__', '__unraisablehook__',
  8. '_clear_type_cache', '_current_frames', '_debugmallocstats', '_framework',
  9. '_getframe', '_git', '_home', '_xoptions', 'abiflags', 'addaudithook',
  10. 'api_version', 'argv', 'audit', 'base_exec_prefix', 'base_prefix',
  11. 'breakpointhook', 'builtin_module_names', 'byteorder', 'call_tracing',
  12. 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info',
  13. 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info',
  14. 'float_repr_style', 'get_asyncgen_hooks', 'get_coroutine_origin_tracking_depth',
  15. 'getallocatedblocks', 'getdefaultencoding', 'getdlopenflags',
  16. 'getfilesystemencodeerrors', 'getfilesystemencoding', 'getprofile',
  17. 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval',
  18. 'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info',
  19. 'intern', 'is_finalizing', 'last_traceback', 'last_type', 'last_value',
  20. 'maxsize', 'maxunicode', 'meta_path', 'modules', 'path', 'path_hooks',
  21. 'path_importer_cache', 'platform', 'prefix', 'ps1', 'ps2', 'pycache_prefix',
  22. 'set_asyncgen_hooks', 'set_coroutine_origin_tracking_depth', 'setdlopenflags',
  23. 'setprofile', 'setrecursionlimit', 'setswitchinterval', 'settrace', 'stderr',
  24. 'stdin', 'stdout', 'thread_info', 'unraisablehook', 'version', 'version_info',
  25. 'warnoptions']

如果没有参数,dir() 会列出你当前定义的名称:

  1. >>> a = [1, 2, 3, 4, 5]
  2. >>> import fibo
  3. >>> fib = fibo.fib
  4. >>> dir()
  5. ['__builtins__', '__name__', 'a', 'fib', 'fibo', 'sys']

注意:它列出所有类型的名称:变量,模块,函数,等等。

dir() 不会列出内置函数和变量的名称。如果你想要这些,它们的定义是在标准模块 builtins 中:

  1. >>> import builtins
  2. >>> dir(builtins)
  3. ['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException',
  4. 'BlockingIOError', 'BrokenPipeError', 'BufferError', 'BytesWarning',
  5. 'ChildProcessError', 'ConnectionAbortedError', 'ConnectionError',
  6. 'ConnectionRefusedError', 'ConnectionResetError', 'DeprecationWarning',
  7. 'EOFError', 'Ellipsis', 'EnvironmentError', 'Exception', 'False',
  8. 'FileExistsError', 'FileNotFoundError', 'FloatingPointError',
  9. 'FutureWarning', 'GeneratorExit', 'IOError', 'ImportError',
  10. 'ImportWarning', 'IndentationError', 'IndexError', 'InterruptedError',
  11. 'IsADirectoryError', 'KeyError', 'KeyboardInterrupt', 'LookupError',
  12. 'MemoryError', 'NameError', 'None', 'NotADirectoryError', 'NotImplemented',
  13. 'NotImplementedError', 'OSError', 'OverflowError',
  14. 'PendingDeprecationWarning', 'PermissionError', 'ProcessLookupError',
  15. 'ReferenceError', 'ResourceWarning', 'RuntimeError', 'RuntimeWarning',
  16. 'StopIteration', 'SyntaxError', 'SyntaxWarning', 'SystemError',
  17. 'SystemExit', 'TabError', 'TimeoutError', 'True', 'TypeError',
  18. 'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError',
  19. 'UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning',
  20. 'ValueError', 'Warning', 'ZeroDivisionError', '_', '__build_class__',
  21. '__debug__', '__doc__', '__import__', '__name__', '__package__', 'abs',
  22. 'all', 'any', 'ascii', 'bin', 'bool', 'bytearray', 'bytes', 'callable',
  23. 'chr', 'classmethod', 'compile', 'complex', 'copyright', 'credits',
  24. 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'exec', 'exit',
  25. 'filter', 'float', 'format', 'frozenset', 'getattr', 'globals', 'hasattr',
  26. 'hash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass',
  27. 'iter', 'len', 'license', 'list', 'locals', 'map', 'max', 'memoryview',
  28. 'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'print', 'property',
  29. 'quit', 'range', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice',
  30. 'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'vars',
  31. 'zip']