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.

uint32_t Py_PACK_VERSION(int major, int minor)
属于 稳定 ABI 自 3.14 版起.

等价于 Py_PACK_FULL_VERSION(major, minor, 0, 0, 0)。 其结果不与任何 Python 发布版对应,但在数字比较中很有用处。

Added in version 3.14.