API 和 ABI 版本管理¶
构建时版本常量¶
CPython 在下列宏中公开其版本号。 请注意这对应于 构建 所用的版本代码。 请查看 Py_Version
获取在 运行时 所用的版本。
请参阅 C API 的稳定性 查看跨版本的 API 和 ABI 稳定情。
-
PY_MAJOR_VERSION¶
3
(3.4.1a2
中的第一段)。
-
PY_MINOR_VERSION¶
4
(3.4.1a2
中的第二段)。
-
PY_MICRO_VERSION¶
1
(3.4.1a2
中第三段的数字)。
-
PY_RELEASE_LEVEL¶
a
(3.4.1a2
中第3段的字母)。 可能为0xA
即 alpha,0xB
即 beta,0xC
即 release candidate 或0xF
即 final。
-
PY_RELEASE_SERIAL¶
2
(3.4.1a2
中的末尾数字)。 零代表最终发布版。
-
PY_VERSION_HEX¶
Python 版本号被编码为一个整数。 请查看
Py_PACK_FULL_VERSION()
了解编码细节。可将其用于数字比较,例如
#if PY_VERSION_HEX >= ...
。
运行时版本¶
-
const unsigned long Py_Version¶
- 属于 稳定 ABI 自 3.11 版起.
Python 运行时版本号被编码为一个整数常量。 请查看
Py_PACK_FULL_VERSION()
了解编码细节。 这包含了在运行时使用的 Python 版本。可将其用于数字比较,例如
if (Py_Version >= ...)
。Added in version 3.11.
比特位打包宏¶
-
uint32_t Py_PACK_FULL_VERSION(int major, int minor, int micro, int release_level, int release_serial)¶
- 属于 稳定 ABI 自 3.14 版起.
返回给定的版本,编码为一个具有如下结构的 32 位整数:
参数
位编号
位掩码
位移
示例值
3.4.1a2
3.10.0
major
8
0xFF000000
24
0x03
0x03
minor
8
0x00FF0000
16
0x04
0x0A
micro
8
0x0000FF00
8
0x01
0x00
release_level
4
0x000000F0
4
0xA
0xF
release_serial
4
0x0000000F
0
0x2
0x0
例如:
版本
Py_PACK_FULL_VERSION
参数已编码版本
3.4.1a2
(3, 4, 1, 0xA, 2)
0x030401a2
3.10.0
(3, 10, 0, 0xF, 0)
0x030a00f0
参数中超范围的比特位将被忽略。 也就是说,该宏可以被定义为:
#ifndef Py_PACK_FULL_VERSION #define Py_PACK_FULL_VERSION(X, Y, Z, LEVEL, SERIAL) ( \ (((X) & 0xff) << 24) | \ (((Y) & 0xff) << 16) | \ (((Z) & 0xff) << 8) | \ (((LEVEL) & 0xf) << 4) | \ (((SERIAL) & 0xf) << 0)) #endif
Py_PACK_FULL_VERSION
本质上是一个宏,主要在#if
指令中使用,但也可作为导出的函数使用。Added in version 3.14.