28.1. sys —系统特定的参数和Function

该模块提供对解释器使用或维护的某些变量以及与解释器强烈交互的Function的访问。它始终可用。

sys. argv
- 传递给 Python 脚本的命令行参数列表。 argv[0]是脚本名称(是否为完整路径名取决于 os)。如果使用解释器的-c命令行选项执行了命令，则argv[0]设置为字符串'-c'。如果没有脚本名称传递给 Python 解释器，则argv[0]是空字符串。

要遍历标准 Importing 或命令行上给出的文件列表，请参阅fileinput模块。

sys. byteorder
- 本机字节 Sequences 的指示符。在 big-endian(最高有效字节在前)平台上，该值将为'big'，在 little-endian(最低有效字节在前)平台上的值为'little'。

2.0 版中的新Function。

sys. builtin_module_names
- 字符串的 Tuples，给出了编译到此 Python 解释器中的所有模块的名称。 (此信息无法pass其他任何方式获得，modules.keys()仅列出了导入的模块.)
sys. call_tracing(* func ， args *)
- 启用跟踪时，请致电func(*args)。跟踪状态已保存，然后恢复。它旨在从检查点的调试器中调用，以递归方式调试其他一些代码。
sys. copyright
- 一个字符串，其中包含与 Python 解释器有关的版权。
sys. _clear_type_cache ( )
- 清除内部类型缓存。类型缓存用于加速属性和方法的查找。使用* only *函数在引用泄漏调试期间删除不必要的引用。

此Function应仅用于内部和专用目的。

2.6 版的新Function。

sys. _current_frames ( )
- 返回一个字典，该字典将每个线程的标识符 Map 到调用该函数时该线程中当前活动的最顶层堆栈帧。请注意，traceback模块中的函数可以在给定这样的框架的情况下构建调用堆栈。

这对于调试死锁最有用：此函数不需要死锁线程的配合，并且只要这些线程的调用堆栈保持死锁状态，它们就会被冻结。在调用代码检查帧时，为非死锁线程返回的框架可能与该线程的当前活动没有任何关系。

此Function应仅用于内部和专用目的。

2.5 版的新Function。

sys. dllhandle
- 指定 Python DLL 句柄的整数。可用性：Windows。
sys. displayhook(* value *)
- 如果* value *不是None，则此函数将其打印到sys.stdout，并将其保存在__builtin__._中。

评估在交互式 Python 会话中 Importing 的expression的结果将调用sys.displayhook。这些值的显示可以pass向sys.displayhook分配另一个单参数函数来定制。

sys. dont_write_bytecode
- 如果是这样，Python 将不会try在导入源模块时写入.pyc或.pyo文件。根据-B命令行选项和 PYTHONDONTWRITEBYTECODE环境变量，此值最初设置为True或False，但是您可以自己设置以控制字节码文件的生成。

2.6 版的新Function。

sys. excepthook(* type ， value ， traceback *)
- 此函数将给定的 traceback 和异常打印到sys.stderr。

当引发并捕获异常时，解释器将调用带有三个参数的sys.excepthook，异常类，异常实例和回溯对象。在交互式会话中，这恰好在控制权返回到提示之前发生。在 Python 程序中，这恰好在程序退出之前发生。可以pass为sys.excepthook分配另一个三参数函数来定制此类顶级异常的处理。

sys. __displayhook__
sys. __excepthook__
- 这些对象在程序开始时包含displayhook和excepthook的原始值。将它们保存起来，以便在碰巧被损坏的对象替换时可以恢复displayhook和excepthook。
sys. exc_info ( )
- 此函数返回三个值的 Tuples，它们给出有关当前正在处理的异常的信息。返回的信息特定于当前线程和当前堆栈帧。如果当前堆栈帧未处理异常，则从调用堆栈帧或其调用者等获取信息，依此类推，直到找到处理异常的堆栈帧为止。这里，“处理异常”被定义为“执行或已经执行了 except 子句”。对于任何堆栈帧，只能访问有关最近处理的异常的信息。

如果堆栈上的任何地方都没有异常处理，则返回包含三个None值的 Tuples。否则，返回的值为(type, value, traceback)。它们的含义是：* type 获取正在处理的异常的异常类型(一个类对象)； * value 获取异常参数(其关联值或raise的第二个参数，如果异常类型为类对象，则该参数始终为类实例)； * traceback *获取一个回溯对象(请参见参考手册)，该对象在最初发生异常的位置封装了调用堆栈。

如果调用exc_clear()，则此函数将返回三个None值，直到在当前线程中引发另一个异常或执行堆栈返回到正在处理另一个异常的帧为止。

Warning

在处理异常的函数中将* traceback *返回值分配给局部变量将导致循环引用。这将防止垃圾回收由同一函数中的局部变量或回溯引用的任何内容。由于大多数函数不需要访问 traceback，因此最好的解决方案是使用exctype, value = sys.exc_info()[:2]之类的东西来仅提取异常类型和值。如果确实需要回溯，请确保在使用后将其删除(最好使用try…finally语句完成)或在本身不处理异常的函数中调用exc_info()。

Note

从 Python 2.2 开始，启用垃圾回收并且无法访问时，会自动回收此类循环，但是避免创建循环仍然更加有效。

sys. exc_clear ( )
- 该函数清除与当前线程中发生的当前或最后一个异常有关的所有信息。调用此函数后，exc_info()将返回三个None值，直到当前线程中引发另一个异常，或者执行堆栈返回到正在处理另一个异常的帧。

仅在少数情况下才需要此Function。这些包括日志记录和错误处理系统，这些系统报告有关上一个或当前异常的信息。此Function也可用于try释放资源并触发对象完成，尽管无法保证将释放哪些对象(如果有)。

2.3 版的新Function。

sys. exc_type
sys. exc_value
sys. exc_traceback
- 从版本 1.5 开始不推荐使用：改为使用exc_info()。

由于它们是全局变量，因此它们并非特定于当前线程，因此在多线程程序中使用它们并不安全。如果未处理任何异常，则将exc_type设置为None，而其他两个则未定义。

sys. exec_prefix
- 一个字符串，提供特定于站点的目录前缀，在其中安装了与平台相关的 Python 文件；默认情况下，它也是'/usr/local'。可以在构建时使用 configure 脚本的--exec-prefix参数进行设置。具体来说，所有配置文件(例如pyconfig.h头文件)都安装在目录exec_prefix/lib/pythonX.Y/config中，共享库模块安装在exec_prefix/lib/pythonX.Y/lib-dynload中，其中* X.Y *是 Python 的版本号，例如2.7。
sys. executable
- 一个字符串，给出有意义的系统上 Python 解释器的可执行二进制文件的绝对路径。如果 Python 无法检索其可执行文件的真实路径，则sys.executable将为空字符串或None。
sys. exit([* arg *])
- 从 Python 退出。这是pass引发SystemExit异常来实现的，因此可以接受try语句的 finally 子句指定的清除操作，并且有可能在外部级别拦截 Export try。

可选参数* arg *可以是给出退出状态的整数(默认为零)，也可以是其他类型的对象。如果它是整数，则 Shell 等将零视为“成功终止”，而将任何非零值视为“异常终止”。大多数系统要求它的范围是 0–127，否则会产生不确定的结果。某些系统具有为特定的退出代码分配特定含义的约定，但是这些通常不完善。 Unix 程序通常将 2 用于命令行语法错误，将 1 用于所有其他类型的错误。如果传递了另一种类型的对象，则None等效于传递零，并且将任何其他对象输出到stderr并导致退出代码为 1.特别是，sys.exit("some error message")是发生错误时退出程序的快速方法。

由于exit()finally“仅”引发异常，因此它仅在从主线程调用时才退出进程，并且不会拦截该异常。

sys. exitfunc
- 该值实际上不是由模块定义的，但是可以由用户(或由程序)设置以在程序退出时指定清除操作。设置后，它应该是无参数函数。解释器退出时将调用此函数。这样只能安装一个Function。要允许在终止时调用多种Function，请使用atexit模块。

Note

当程序被 signal 杀死，检测到 Python 致命内部错误或调用os._exit()时，不会调用 exit 函数。

从版本 2.4 开始不推荐使用：改为使用atexit。

sys. flags
- 结构序列* flags *公开命令行标志的状态。这些属性是只读的。

attribute	flag
`debug`	-d
`py3k_warning`	-3
`division_warning`	-Q
`division_new`	-Qnew
inspect	-i
`interactive`	-i
`optimize`	-O或-OO
dont_write_bytecode	-B
`no_user_site`	-s
`no_site`	-S
`ignore_environment`	-E
`tabcheck`	-t或-tt
`verbose`	-v
unicode	-U
`bytes_warning`	-b
`hash_randomization`	-R

2.6 版的新Function。

版本 2.7.3 中的新Function：hash_randomization属性。

sys. float_info
- structseq 保存有关浮点类型的信息。它包含有关精度和内部表示的低级信息。这些值对应于在标准头文件float.h中为“ C”编程语言定义的各种浮点常量；有关详细信息，请参见 1999 ISO/IEC C 标准[C99]的 5.2.4.2.2 节“浮点类型的特性”。

attribute	float.h macro	explanation
`epsilon`	DBL_EPSILON	1 与可表示为浮点数的最小值之间的差(大于 1)
`dig`	DBL_DIG	浮点数中可以如实表示的最大十进制数字；见下文
`mant_dig`	DBL_MANT_DIG	浮点数精度：浮点数有效位数的基数`radix`
max	DBL_MAX	最大可表示有限浮点数
`max_exp`	DBL_MAX_EXP	使得`radix**(e-1)`是可表示的有限浮点数的最大整数 e
`max_10_exp`	DBL_MAX_10_EXP	使得`10**e`在可表示的有限浮点数范围内的最大整数 e
min	DBL_MIN	最小正归一化浮点数
`min_exp`	DBL_MIN_EXP	最小整数 e，使得`radix**(e-1)`是规范化的浮点数
`min_10_exp`	DBL_MIN_10_EXP	最小整数 e，使得`10**e`是规范化的浮点数
`radix`	FLT_RADIX	指数表示基数
`rounds`	FLT_ROUNDS	整数常数，表示用于算术运算的舍入模式。这反映了解释器启动时系统 FLT_ROUNDS 宏的值。有关可能的值及其含义的说明，请参见 C99 标准的 5.2.4.2.2 节。

属性sys.float_info.dig需要进一步说明。如果s是代表最多具有sys.float_info.dig个有效数字的十进制数字的任何字符串，则将s转换为浮点数并再次返回将恢复代表相同十进制值的字符串：

>>> import sys
>>> sys.float_info.dig
15
>>> s = '3.14159265358979'    # decimal string with 15 significant digits
>>> format(float(s), '.15g')  # convert to float and back -> same value
'3.14159265358979'

但是对于具有超过sys.float_info.dig个有效数字的字符串，并非总是如此：

>>> s = '9876543211234567'    # 16 significant digits is too many!
>>> format(float(s), '.16g')  # conversion changes value
'9876543211234568'

2.6 版的新Function。

sys. float_repr_style
- 一个字符串，指示repr()函数对浮点数的行为。如果字符串的值是'short'，那么对于有限浮点数x，repr(x)的目标是产生一个具有float(repr(x)) == x属性的短字符串。这是 Python 2.7 及更高版本中的常见行为。否则，float_repr_style的值为'legacy'，并且repr(x)的行为与 2.7 之前的 Python 版本中的行为相同。

2.7 版的新Function。

sys. getcheckinterval ( )
- 返回解释器的“检查间隔”；参见setcheckinterval()。

2.3 版的新Function。

sys. getdefaultencoding ( )
- 返回 Unicode 实现使用的当前默认字符串编码的名称。

2.0 版中的新Function。

sys. getdlopenflags ( )
- 返回用于dlopen()调用的标志的当前值。标志常量在dl和DLFCN模块中定义。可用性：Unix。

2.2 版中的新Function。

sys. getfilesystemencoding ( )
- 返回用于将 Unicode 文件名转换为系统文件名的编码的名称；如果使用系统默认编码，则返回None。结果值取决于 os：
在 Mac OS X 上，编码为'utf-8'。
在 Unix 上，根据 nl_langinfo(CODESET)的结果，编码是用户的首选项；如果nl_langinfo(CODESET)失败，则编码为None。
在 Windows NT 上，文件名本地为 Unicode，因此不执行任何转换。 getfilesystemencoding()仍返回'mbcs'，因为这是应用程序在明确希望将 Unicode 字符串转换为与用作文件名时等效的字节字符串时应使用的编码。
在 Windows 9x 上，编码为'mbcs'。

2.3 版的新Function。

sys. getrefcount(* object *)
- 返回* object *的引用计数。返回的计数通常比您预期的高一，因为它包含(临时)引用作为getrefcount()的参数。
sys. getrecursionlimit ( )
- 返回递归限制的当前值，即 Python 解释器堆栈的最大深度。此限制可防止无限递归导致 C 堆栈溢出和 Python 崩溃。可以由setrecursionlimit()设置。
sys. getsizeof(* object * [，* default *])
- 返回对象的大小(以字节为单位)。该对象可以是任何类型的对象。所有内置对象都将返回正确的结果，但是对于第三方扩展，这不一定成立，因为它是特定于实现的。

如果给定，如果对象不提供检索大小的方法，则将返回* default *。否则将引发TypeError。

getsizeof()调用对象的__sizeof__方法，如果该对象由垃圾收集器 Management，则会增加额外的垃圾收集器开销。

2.6 版的新Function。

sys. _getframe([深度])
- 从调用堆栈返回一个框架对象。如果给定了可选的整数* depth *，则返回在堆栈顶部下方多次调用的帧对象。如果那比调用堆栈深，则引发ValueError。 * depth *的默认值为零，返回调用堆栈顶部的帧。

CPython 实现细节： 此函数应仅用于内部和专用目的。不能保证它在所有 Python 实现中都存在。

sys. getprofile ( )
- 获取setprofile()设置的探查器Function。

2.6 版的新Function。

sys. gettrace ( )
- 获取settrace()设置的跟踪Function。

CPython 实现细节： gettrace()函数仅用于实现调试器，事件探查器，覆盖率工具等。它的行为是实现平台的一部分，而不是语言定义的一部分，因此可能并非在所有 Python 实现中都可用。

2.6 版的新Function。

sys. getwindowsversion ( )
- 返回描述当前运行的 Windows 版本的命名 Tuples。命名元素为* major ， minor ， build ， platform ， service_pack ， service_pack_minor ， service_pack_major ， suite_mask 和 product_type *。 * service_pack *包含一个字符串，而所有其他值都是整数。也可以pass名称访问组件，因此sys.getwindowsversion()[0]等效于sys.getwindowsversion().major。为了与以前的版本兼容，只能pass索引检索前 5 个元素。

platform *可能是以下值之一：

Constant	Platform
`0 (VER_PLATFORM_WIN32s)`	Windows 3.1 上的 Win32s
`1 (VER_PLATFORM_WIN32_WINDOWS)`	Windows 95/98/ME
`2 (VER_PLATFORM_WIN32_NT)`	Windows NT/2000/XP/x64
`3 (VER_PLATFORM_WIN32_CE)`	Windows CE

product_type *可能是以下值之一：

Constant	Meaning
`1 (VER_NT_WORKSTATION)`	该系统是工作站。
`2 (VER_NT_DOMAIN_CONTROLLER)`	该系统是域控制器。
`3 (VER_NT_SERVER)`	系统是服务器，而不是域控制器。

此函数包装 Win32 GetVersionEx()函数；有关这些字段的更多信息，请参见OSVERSIONINFOEX()上的 Microsoft 文档。

Availability: Windows.

2.3 版的新Function。

在 2.7 版中进行了更改：更改为命名 Tuples，并添加了* service_pack_minor ， service_pack_major ， suite_mask 和 product_type *。

sys. hexversion
- 版本号编码为单个整数。保证每个版本都会增加，包括对非生产版本的适当支持。例如，要测试 Python 解释器的版本至少为 1.5.2，请使用：

if sys.hexversion >= 0x010502F0:
    # use some advanced feature
    ...
else:
    # use an alternative implementation or warn the user
    ...

之所以称为hexversion，是因为将其传递给内置的hex()函数时，它看起来才有意义。 version_info值可用于更友好的相同信息编码。

hexversion是具有以下布局的 32 位数字：

位(大端 Sequences)	Meaning
`1-8`	`PY_MAJOR_VERSION`(`2.1.0a3`中的`2`)
`9-16`	`PY_MINOR_VERSION`(`2.1.0a3`中的`1`)
`17-24`	`PY_MICRO_VERSION`(`2.1.0a3`中的`0`)
`25-28`	`PY_RELEASE_LEVEL`(对于 alpha 来说是`0xA`，对于 Beta 来说是`0xB`，对于候选发布者来说是`0xC`，对于finally版本来说是`0xF`)
`29-32`	`PY_RELEASE_SERIAL`(`2.1.0a3`中的`3`，finally版本为零)

因此2.1.0a3是 hexversion 0x020100a3。

版本 1.5.2 中的新Function。

sys. long_info
- 一个结构序列，包含有关 Python 内部整数表示形式的信息。这些属性是只读的。

Attribute	Explanation
`bits_per_digit`	每个数字中保留的位数。 Python 整数内部存储在基本`2**long_info.bits_per_digit`中
`sizeof_digit`	用于表示数字的 C 类型的字节大小

2.7 版的新Function。

sys. last_type
sys. last_value
sys. last_traceback
- 这三个变量并非总是定义的。当未处理异常且解释器打印错误消息和堆栈回溯时，将设置它们。它们的预期用途是允许交互式用户导入调试器模块并进行事后调试，而不必重新执行导致错误的命令。 (通常使用import pdb; pdb.pm()进入验尸调试器；有关更多信息，请参见第pdb — Python 调试器章。)

变量的含义与上面exc_info()的返回值相同。 (由于只有一个交互线程，因此与exc_type等不同，这些变量与线程安全无关)

sys. maxint
- Python 的常规整数类型支持的最大正整数。这至少是 2 ** 31-1.最大的负整数是-maxint-1-不对称性是由于使用 2 的补码二进制算法引起的。
sys. maxsize
- 平台的 Py_ssize_t 类型支持的最大正整数，因此列表，字符串，字典和许多其他容器可以具有的最大大小。
sys. maxunicode
- 一个整数，为 Unicode 字符提供最大的支持代码点。此值取决于配置选项，该选项指定将 Unicode 字符存储为 UCS-2 还是 UCS-4.
sys. meta_path
- 调用了find_module()方法的finder个对象的列表，以查看其中一个对象是否可以找到要导入的模块。至少使用要导入的模块的绝对名称调用find_module()方法。如果要导入的模块包含在包中，则将父包的__path__属性作为第二个参数传递。如果找不到模块，则该方法返回None，否则返回loader。

在任何隐式默认查找器或sys.path之前搜索sys.meta_path。

有关原始规范，请参见 PEP 302。

sys. modules
- 这是将模块名称 Map 到已经加载的模块的字典。可以对其进行操作以强制重新加载模块和其他技巧。请注意，从此词典中删除模块与在相应模块对象上调用reload()是不同的。

sys. path
- 字符串列表，用于指定模块的搜索路径。从环境变量 PYTHONPATH初始化，再加上一个依赖于安装的默认值。

在程序启动时初始化，此列表的第一项path[0]是包含用于调用 Python 解释器的脚本的目录。如果脚本目录不可用(例如，如果交互式调用解释器或从标准 Importing 中读取脚本)，则path[0]为空字符串，它将引导 Python 首先搜索当前目录中的模块。请注意，脚本目录是在 PYTHONPATH结果插入的条目之前*插入的。

程序可以出于自己的目的随意修改此列表。

在版本 2.3 中更改：不再忽略 Unicode 字符串。

System	platform value
Linux(2.x 和 3.x)	`'linux2'`
Windows	`'win32'`
Windows/Cygwin	`'cygwin'`
Mac OS X	`'darwin'`
OS/2	`'os2'`
OS/2 EMX	`'os2emx'`
RiscOS	`'riscos'`
AtheOS	`'atheos'`

Python 中文文档

28.1. sys —系统特定的参数和Function