sys - 系统相关功能

2023-08-31

新架构代码升级了MPY的版本，sys变更为usys。导入模块时建议使用以下方式进行导入

try:
    import usys as sys
except ImportError:
    import sys

常数说明

sys.argv

当前程序启动的可变参数列表。

sys.byteorder

字节顺序 (‘little’ - 小端， ‘big’ - 大端)。

sys.implementation

返回当前microPython版本信息。对于MicroPython，它具有以下属性：

  • name - 字符串“ micropython”

  • version - 元组（主要，次要，微型），例如（1、7、0）

  • _mpy - mpy文件的版本信息，解析方法如下，mpy_cross生成mpy时需要与此版本信息相适配

import sys
sys_mpy = sys.implementation._mpy
arch = [None, 'x86', 'x64',
    'armv6', 'armv6m', 'armv7m', 'armv7em', 'armv7emsp', 'armv7emdp',
    'xtensa', 'xtensawin'][sys_mpy >> 10]
print('mpy version:', sys_mpy & 0xff)
print('mpy sub-version:', sys_mpy >> 8 & 3)
print('mpy flags:', end='')
if arch:
    print(' -march=' + arch, end='')
print()

建议使用此对象来将MicroPython与其他Python实现区分开。

sys.maxsize

本机整数类型可以在当前平台上保留的最大值，如果它小于平台最大值，则为MicroPython整数类型表示的最大值（对于不支持长整型的MicroPython端口就是这种情况）。

sys.modules

以字典形式返回当前Python环境中已经导入的模块。

sys.platform

MicroPython运行的平台。

sys.stdin

标准输入（默认是USB虚拟串口，可选其他串口）。

sys.stdout

标准输出（默认是USB虚拟串口，可选其他串口）。

sys.version

MicroPython 版本，字符串格式。

sys.version_info

MicroPython 版本，整数元组格式。

方法

sys.exit

sys.exit(retval=0)

使用给定的参数退出当前程序。

参数描述

  • retval，int型，退出参数

返回值描述

该函数会引发 SystemExit退出。如果给定了参数，则将其值作为参数赋值给 SystemExit。

sys.print_exception

sys.print_exception(exc, file=sys.stdout)

打印异常到文件对象，默认是 sys.stdout，即输出异常信息的标准输出。

参数描述

  • exc，exception对象

  • file，指定输出文件，默认为sys.stdout