sys
– 系统特定功能¶
sys模块中提供了与MicroPython运行环境有关的函数和变量。
这个模块实现了相应 CPython 模块的一个子集,如下所述。有关更多信息,请参阅原始CPython文档: sys
Functions¶
-
sys.
exit
(retval=0)¶ 使用给定的退出代码终止当前程序。在此基础上,此功能提升为
SystemExit
。如果给出一个参数,则将其值作为参数给出SystemExit
。
-
sys.
print_exception
(exc, file=sys.stdout)¶ 通过回溯到类文件对象文件(或
sys.stdout
默认情况下)来打印异常。
与CPython的区别
这是 traceback
CPython模块中出现的函数的简化版本。与 traceback.print_exception()
此不同,此函数仅使用异常值而不是异常类型,异常值和回溯对象; file参数应该是位置的; 不支持其他参数。
traceback
可以找到CPython兼容 模块 micropython-lib
。
常量¶
-
sys.
argv
¶ 当前程序启动的可变参数列表。
-
sys.
byteorder
¶ 系统的字节顺序(
little
或big
)。
-
sys.
implementation
¶ 包含有关当前Python实现的信息的对象。对于MicroPython,它具有以下属性:
name - 字符串 “micropython”
version - 元组 (主要,次要,微), e.g. (1, 7, 0)
这个方法推荐用来识别不同平台的MicroPython。
示例:
>>> print(sys.implementation) (name='micropython', version=(1, 9, 1))
-
sys.
maxsize
¶ 本机整数类型可以在当前平台上保存的最大值,或MicroPython整数类型可表示的最大值,如果它小于平台最大值 (对于没有长int支持的MicroPython端口的情况)。
此属性对于检测平台的“位数”(32位与64位等)非常有用。建议不要直接将此属性与某个值进行比较,而是计算其中的位数:
bits = 0 v = sys.maxsize while v: bits += 1 v >>= 1 if bits > 32: # 64-bit (or more) platform ... else: # 32-bit (or less) platform # Note that on 32-bit platform, value of bits may be less than 32 # (e.g. 31) due to peculiarities described above, so use "> 16", # "> 32", "> 64" style of comparisons.
-
sys.
modules
¶ 已载入模块字典。在某些移植版中,它可能不包含在内建模块中。
-
sys.
path
¶ 用于搜索导入模块的可变目录列表。
-
sys.
platform
¶ 获取MicroPython运行的平台。
-
sys.
stderr
¶ 标准错误
stream
-
sys.
stdin
¶ 标准输入
stream
-
sys.
stdout
¶ 标准输出
stream
-
sys.
version
¶ 返回 MicroPython 语言版本,字符串
-
sys.
version_info
¶ 返回 MicroPython 语言版本,整形元组