`usys` -- システム固有関数¶

このモジュールは、該当する :term:`CPython` モジュールのサブセットを実装しています。詳しくはオリジナルの CPython ドキュメンテーションを参照してください: sys.

関数¶

usys.exit(retval=0, /)¶: 与えた終了コードで現在のプログラムを終了します。基本的に、この関数は SystemExit 例外を起こします。引数を与えた場合、その値は SystemExit に引数として与えられます。

usys.atexit(func)¶: 終了時に呼び出す関数 func を登録します。 func は、引数の無い呼出し可能オブジェクトである必要があります。呼出しを無効にするには func に None を指定します。この atexit 関数は、この関数で以前に設定した値を返します。初回の呼び出しでは None を返します。

CPython との違い

この関数は、CPython の atexit モジュールと似た機能を提供することを目的とした MicroPython の拡張機能です。

usys.print_exception(exc, file=usys.stdout, /)¶: 例外をトレースバック付きでファイルライクなオブジェクト file (またはデフォルトの sys.stdout)に出力します。

CPython との違い

これは CPython の traceback モジュールにある関数の簡略版です。traceback.print_exception() とは異なり、この関数は例外型、例外値、トレースバックオブジェクトの代わりに例外値だけをとります。 file 引数は位置パラメータでなければなりません。この他の引数はサポートされていません。CPython 互換の traceback モジュールは micropython-lib にあります。

定数¶

usys.argv¶: 現在のプログラム開始時の引数の変更可能なリスト。

usys.byteorder¶: システムのバイト順("little" または "big")。

usys.implementation¶

現在の Python 処理系に関する情報を持つオブジェクト。MicroPython では次の属性を持ちます:

name - 文字列 "micropython"
version - タプル (major, minor, micro)。例: (1, 7, 0)

このオブジェクトは、MicroPython を他の Python 実装と区別する推奨手段です(しかし、最小限のポートには存在しないことに注意してください)。

CPython との違い

CPython ではこのオブジェクトにもっと多くの属性がありますが、MicroPython では実際に有用となる最低限のものだけを実装しています。

usys.maxsize¶

現在のプラットフォームでネイティブ整数型が保持できる最大値、またはプラットフォームの最大値より小さい場合は MicroPython 整数型で表現可能な最大値(MicroPython ポートで長整数をサポートしないとした場合)。

この属性は、プラットフォームの「ビット数」(32ビットか64ビットかなど)を検出するのに便利です。この属性をある値と直接比較するのよりも、その属性のビット数をカウントすることをお勧めします。

bits = 0
v = usys.maxsize
while v:
    bits += 1
    v >>= 1
if bits > 32:
    # 64ビット(以上)のプラットフォーム
    ...
else:
    # 32ビット(以下)のプラットフォーム
    # 32ビットプラットフォームでは、上記の特性によってビットの値が32未満
    # (たとえば31)になる可能性があるので、 "> 16", "> 32", "> 64" の
    # の比較スタイルを使用してください。

usys.modules¶: 読み込まれたモジュールの辞書。一部のポートでは、組込みモジュールが含まれていない可能性があります。

usys.path¶: import するモジュールを検索するディレクトリの変更可能なリスト。

usys.platform¶: MicroPython が実行されているプラットフォーム。OS/RTOS ポートの場合、これは通常 "linux" など OS の識別子となります。ベアメタルポートの場合はボードの識別子となります。オリジナルの MicroPython リファレンスボードでは "pyboard" となります。したがって、これはあるボードを別のボードと区別するために使用できます。あなたのプログラムが MicroPython 上で実行されているのか(それとも他の Python 実装で動いているのか)を確認する必要がある場合は代わりに sys.implementation を使ってください。

usys.stderr¶: 標準エラーの stream 。

usys.stdin¶: 標準入力の stream 。

usys.stdout¶: 標準出力の stream 。

usys.version¶: この処理系が準拠する Python 言語バージョンを表す文字列。

usys.version_info¶: この実装が準拠している Python 言語バージョンを表す int のタプル。

CPython との違い

最初の3つのバージョン番号 (major, minor, micro) のみがサポートされ、インデックスでのみ参照でき、名前では参照できません。