platform --- 對底層平臺識別資料的存取

原始碼:Lib/platform.py


備註

特定平臺清單為按字母順序排列,Linux 包括在 Unix 小節之中。

跨平台

platform.architecture(executable=sys.executable, bits='', linkage='')

查詢給定的可執行檔案(預設為 Python 直譯器二進位制檔案)來取得各種架構資訊。

回傳一個 tuple(元組) (bits, linkage),其中包含可執行檔案所使用的位元架構和連結格式資訊。這兩個值均以字串形式回傳。

無法確定的值將回傳參數所給定之預先設置值。如果給定的位元為 '',則會使用 sizeof(pointer)(或者當 Python 版本 < 1.5.2 時為 sizeof(long))作為所支援指標大小的指示器 (indicator)。

此函式依賴於系統的 file 命令來執行實際的操作。這在幾乎所有 Unix 平臺和某些非 Unix 平臺上,只有當可執行檔案指向 Python 直譯器時才可使用。當以上要求不滿足時將會使用合理的預設值。

備註

在 macOS(也許還有其他平臺)上,可執行檔案可能是包含多種架構的通用檔案。

要取得目前直譯器的 "64 位元性 (64-bitness)",更可靠的做法是查詢 sys.maxsize 屬性:

is_64bits = sys.maxsize > 2**32
platform.machine()

回傳機器種類,例如 'AMD64'。如果該值無法確定則會回傳一個空字串。

The output is platform-dependent and may differ in casing and naming conventions.

platform.node()

回傳電腦的網路名稱(可能不是完整名稱!)。如果該值無法確定則會回傳一個空字串。

platform.platform(aliased=False, terse=False)

會儘可能附帶有用資訊地回傳一個標識底層平臺的字串。

輸出應為人類易讀的 (human readable),而非機器易剖析的 (machine parseable)。它在不同平臺上看起來可能不一致,這是有意為之的。

如果 aliased 為真值,此函式將使用各種不同於平臺通用名稱的別名來回報系統名稱,例如 SunOS 將被回報為 Solaris。system_alias() 函式被用於實作此功能。

terse 設為真值將導致此函式只回傳標識平臺所需的最小量資訊。

在 3.8 版的變更: 在 macOS 上,如果 mac_ver() 回傳的釋出版字串非空字串,此函式現在會使用它以取得 macOS 版本而非 darwin 版本。

platform.processor()

回傳(真實的)處理器名稱,例如 'amdk6'

如果該值無法確定則將回傳空字串。請注意,許多平臺都不提供此資訊或是簡單地回傳與 machine() 相同的值。NetBSD 則會提供此資訊。

platform.python_build()

回傳一個 tuple (buildno, builddate),表示字串形式的 Python 建置編號和日期。

platform.python_compiler()

回傳一個標識用於編譯 Python 的編譯器的字串。

platform.python_branch()

回傳一個標識 Python 實作 SCM 分支的字串。

platform.python_implementation()

回傳一個標識 Python 實作的字串。可能的回傳值有:'CPython'、'IronPython'、'Jython'、'PyPy'。

platform.python_revision()

回傳一個標識 Python 實作 SCM 修訂版的字串。

platform.python_version()

將 Python 版本以字串 'major.minor.patchlevel' 形式回傳。

請注意此回傳值不同於 Python sys.version,它總是會包括 patchlevel(預設為 '0')。

platform.python_version_tuple()

將 Python 版本以字串 tuple (major, minor, patchlevel) 形式回傳。

請注意此回傳值不同於 Python sys.version,它總是會包括 patchlevel(預設為 '0')。

platform.release()

回傳系統的釋出版本,例如 '2.2.0''NT',如果該值無法確定則將回傳一個空字串。

platform.system()

回傳系統/OS 的名稱,例如 'Linux''Darwin''Java''Windows'。如果該值無法確定則回傳一個空字串。

On iOS and Android, this returns the user-facing OS name (i.e, 'iOS, 'iPadOS' or 'Android'). To obtain the kernel name ('Darwin' or 'Linux'), use os.uname().

platform.