### 导航
- [索引](../genindex.xhtml "总目录")
- [模块](../py-modindex.xhtml "Python 模块索引") |
- [下一页](conversion.xhtml "字符串转换与格式化") |
- [上一页](marshal.xhtml "Data marshalling support") |
- ![](https://box.kancloud.cn/a721fc7ec672275e257bbbfde49a4d4e_16x16.png)
- [Python](https://www.python.org/) »
- zh\_CN 3.7.3 [文档](../index.xhtml) »
- [Python/C API 参考手册](index.xhtml) »
- [工具](utilities.xhtml) »
- $('.inline-search').show(0); |
# 语句解释及变量编译
这些函数在创建你自己的函数时帮助很大。更多说明以及实例可参考说明文档中的 [扩展和嵌入 Python 解释器](../extending/index.xhtml#extending-index) 小节。
这些函数描述的前三个,[`PyArg_ParseTuple()`](#c.PyArg_ParseTuple "PyArg_ParseTuple"),[`PyArg_ParseTupleAndKeywords()`](#c.PyArg_ParseTupleAndKeywords "PyArg_ParseTupleAndKeywords"),以及 [`PyArg_Parse()`](#c.PyArg_Parse "PyArg_Parse"),它们都使用 *格式化字符串* 来将函数期待的参数告知函数。这些函数都使用相同语法规则的格式化字符串。
## 解析参数
一个格式化字符串包含0或者更多的格式单元。一个格式单元用来描述一个Python对象;它通常是一个字符或者由括号括起来的格式单元序列。除了少数例外,一个非括号序列的格式单元通常对应这些函数的具有单一地址的参数。在接下来的描述中,双引号内的表达式是格式单元;圆括号()内的是对应这个格式单元的Python对象类型;方括号\[\]内的是传递的C变量(变量集)类型。
### 字符串和缓存区
这些格式允许将对象按照连续的内存块形式进行访问。你没必要提供返回的unicode字符或者字节区的原始数据存储。
一般的,当一个表达式设置一个指针指向一个缓冲区,这个缓冲区可以被相应的Python对象管理,并且这个缓冲区共享这个对象的生存周期。你不需要人为的释放任何内存空间。除了这些 `es`, `es#`, `et` and `et#`.
然而,当一个 [`Py_buffer`](buffer.xhtml#c.Py_buffer "Py_buffer") 结构被赋值,其包含的缓冲区被锁住,所以调用者在随后使用这个缓冲区,即使在 [`Py_BEGIN_ALLOW_THREADS`](init.xhtml#c.Py_BEGIN_ALLOW_THREADS "Py_BEGIN_ALLOW_THREADS") 块中,可以避免可变数据因为调整大小或者被销毁所带来的风险。因此,**你不得不调用** [`PyBuffer_Release()`](buffer.xhtml#c.PyBuffer_Release "PyBuffer_Release") 在你结束数据的处理时(或者在之前任何中断事件中)
除非另有说明,缓冲区是不会以空终止的。
有些格式要求一个只读的 [bytes-like object](../glossary.xhtml#term-bytes-like-object),并且设置一个指针以取代一个缓存区结构。它们通过检查对象的 [`PyBufferProcs.bf_releasebuffer`](typeobj.xhtml#c.PyBufferProcs.bf_releasebuffer "PyBufferProcs.bf_releasebuffer") 字段是 *NULL* 来工作,它们不允许诸如 [`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray") 这种可变的对象。
注解
所有 `#` 表达式的变式(`s#`,`y#`,等等),长度参数的类型(整型或者 `Py_ssize_t`)在包含 `Python.h` 头文件之前由 `PY_SSIZE_T_CLEAN` 宏的定义控制。如果这个宏被定义,长度是一个 `Py_ssize_t` Python元大小类型而不是一个 `int` 整型。在未来的Python版本中将会改变,只支持 `Py_ssize_t` 而放弃支持 `int` 整型。最好一直定义 `PY_SSIZE_T_CLEAN` 这个宏。
`s` ([`str`](../library/stdtypes.xhtml#str "str")) \[const char \*\]将一个Unicode对象转换成一个指向字符串的C指针。一个指针指向一个已经存在的字符串,这个字符串存储的是传如的字符指针变量。C字符串是已空结束的。Python字符串不能包含嵌入的无效的代码点;如果由,一个 [`ValueError`](../library/exceptions.xhtml#ValueError "ValueError") 异常会被引发。Unicode对象被转化成 `'utf-8'` 编码的C字符串。如果转换失败,一个 [`UnicodeError`](../library/exceptions.xhtml#UnicodeError "UnicodeError") 异常被引发。
注解
这个表达式不接受 [bytes-like objects](../glossary.xhtml#term-bytes-like-object)。如果你想接受文件系统路径并将它们转化成C字符串,建议使用 `O&` 表达式配合 [`PyUnicode_FSConverter()`](unicode.xhtml#c.PyUnicode_FSConverter "PyUnicode_FSConverter") 作为 *转化函数*。
在 3.5 版更改: 以前,当Python字符串中遇到了嵌入的null代码点会引发 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError") 。
`s*` ([`str`](../library/stdtypes.xhtml#str "str") or [bytes-like object](../glossary.xhtml#term-bytes-like-object)) \[Py\_buffer\]这个表达式既接受Unicode对象也接受类字节类型对象。它为由调用者提供的 [`Py_buffer`](buffer.xhtml#c.Py_buffer "Py_buffer") 结构赋值。这里结果的C字符串可能包含嵌入的NUL字节。Unicode对象通过 `'utf-8'` 编码转化成C字符串。
`s#` ([`str`](../library/stdtypes.xhtml#str "str"), 只读 [bytes-like object](../glossary.xhtml#term-bytes-like-object)) \[const char \*, int or `Py_ssize_t`\]像 `s*`,除了它不接受易变的对象。结果存储在两个C 变量中,第一个是指向C字符串的指针,第二个是它的长度。字符串可能包含嵌入的null字节。Unicode对象都被通过 `'utf-8'` 编码转化成C字符串。
`z` ([`str`](../library/stdtypes.xhtml#str "str") or `None`) \[const char \*\]像 `s`,但是这个Python对象也有可能是 `None`,那么对应的C指针指向 *NULL*。
`z*` ([`str`](../library/stdtypes.xhtml#str "str"), [bytes-like object](../glossary.xhtml#term-bytes-like-object) or `None`) \[Py\_buffer\]像 `s*`,但是这个Python对象也有可能是 `None`,那么对应的 [`Py_buffer`](buffer.xhtml#c.Py_buffer "Py_buffer") 结构中的 `buf` 指向 *NULL*。
`z#` ([`str`](../library/stdtypes.xhtml#str "str"), 只读 [bytes-like object](../glossary.xhtml#term-bytes-like-object) or `None`) \[const char \*, int\]像 `s#`,但是这个Python对象也有可能是 `None`,那么对应的C指针指向 *NULL*。
`y` (read-only [bytes-like object](../glossary.xhtml#term-bytes-like-object)) \[const char \*\]这个表达式将一个类字节类型对象转化成一个指向字符串的C指针;它不接受Unicode对象。字节缓存区必须不包含嵌入的null字节;如果包含了null字节,会引发一个 [`ValueError`](../library/exceptions.xhtml#ValueError "ValueError") 异常。
在 3.5 版更改: 以前,当字节缓冲区中遇到了嵌入的null字节会引发 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError") 。
`y*` ([bytes-like object](../glossary.xhtml#term-bytes-like-object)) \[Py\_buffer\]`s*` 的变式,不接受Unicode对象,只接受类字节类型变量。**这是接受二进制数据的推荐方法**。
`y#` (read-only [bytes-like object](../glossary.xhtml#term-bytes-like-object)) \[const char \*, int\]This variant on `s#` doesn't accept Unicode objects, only bytes-like objects.
`S` ([`bytes`](../library/stdtypes.xhtml#bytes "bytes")) \[PyBytesObject \*\]要求Python对象是一个 [`bytes`](../library/stdtypes.xhtml#bytes "bytes") 类型对象,没有尝试任何的转换。如果不是一个字节类型对象会引发 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError") 异常。C变量也可能声明为 [`PyObject*`](structures.xhtml#c.PyObject "PyObject") 类型。
`Y` ([`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray")) \[PyByteArrayObject \*\]要求Python对象是一个 [`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray") 类型对象,没有尝试任何的转换。如果不是一个 [`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray") 类型对象会引发 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError") 异常。C变量也可能声明为 [`PyObject*`](structures.xhtml#c.PyObject "PyObject") 类型。
`u` ([`str`](../library/stdtypes.xhtml#str "str")) \[const Py\_UNICODE \*\]将一个Python Unicode对象转化成指向一个以空终止的Unicode字符缓冲区的指针。你必须传入一个 [`Py_UNICODE`](unicode.xhtml#c.Py_UNICODE "Py_UNICODE") 指针变量的地址,存储了一个指向已经存在的Unicode缓冲区的指针。请注意一个 [`Py_UNICODE`](unicode.xhtml#c.Py_UNICODE "Py_UNICODE") 类型的字符宽度取决于编译选项(16位或者32位)。Python字符串必须不能包含嵌入的null代码点;如果有,引发一个 [`ValueError`](../library/exceptions.xhtml#ValueError "ValueError") 异常。
在 3.5 版更改: 以前,当Python字符串中遇到了嵌入的null代码点会引发 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError") 。
Deprecated since version 3.3, will be removed in version 4.0: 这是旧版样式 [`Py_UNICODE`](unicode.xhtml#c.Py_UNICODE "Py_UNICODE") API; 请迁移至 [`PyUnicode_AsWideCharString()`](unicode.xhtml#c.PyUnicode_AsWideCharString "PyUnicode_AsWideCharString").
`u#` ([`str`](../library/stdtypes.xhtml#str "str")) \[const Py\_UNICODE \*, int\]`u` 的变式,存储两个C变量,第一个指针指向一个Unicode数据缓存区,第二个是它的长度。它允许null代码点。
Deprecated since version 3.3, will be removed in version 4.0: 这是旧版样式 [`Py_UNICODE`](unicode.xhtml#c.Py_UNICODE "Py_UNICODE") API; 请迁移至 [`PyUnicode_AsWideCharString()`](unicode.xhtml#c.PyUnicode_AsWideCharString "PyUnicode_AsWideCharString").
`Z` ([`str`](../library/stdtypes.xhtml#str "str") 或 `None`) \[const Py\_UNICODE \*\]像 `u`,但是这个Python对象也有可能是 `None`,那么对应的 [`Py_UNICODE`](unicode.xhtml#c.Py_UNICODE "Py_UNICODE") 指针指向 *NULL*。
Deprecated since version 3.3, will be removed in version 4.0: 这是旧版样式 [`Py_UNICODE`](unicode.xhtml#c.Py_UNICODE "Py_UNICODE") API; 请迁移至 [`PyUnicode_AsWideCharString()`](unicode.xhtml#c.PyUnicode_AsWideCharString "PyUnicode_AsWideCharString").
`Z#` ([`str`](../library/stdtypes.xhtml#str "str") 或 `None`) \[const Py\_UNICODE \*, int\]像 `u#`,但是这个Python对象也有可能是 `None`,那么对应的 [`Py_UNICODE`](unicode.xhtml#c.Py_UNICODE "Py_UNICODE") 指针指向 *NULL*。
Deprecated since version 3.3, will be removed in version 4.0: 这是旧版样式 [`Py_UNICODE`](unicode.xhtml#c.Py_UNICODE "Py_UNICODE") API; 请迁移至 [`PyUnicode_AsWideCharString()`](unicode.xhtml#c.PyUnicode_AsWideCharString "PyUnicode_AsWideCharString").
`U` ([`str`](../library/stdtypes.xhtml#str "str")) \[PyObject \*\]要求Python对象是一个Unicode对象,没有尝试任何的转换。如果不是一个Unicode对象会引发 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError") 异常。C变量也可能声明为 [`PyObject*`](structures.xhtml#c.PyObject "PyObject") 类型。
`w*` (可读写 [bytes-like object](../glossary.xhtml#term-bytes-like-object)) \[Py\_buffer\]这个表达式接受任何实现可读写缓存区接口的对象。它为调用者提供的 [`Py_buffer`](buffer.xhtml#c.Py_buffer "Py_buffer") 结构赋值。缓冲区可能存在嵌入的null字节。当缓冲区使用完后调用者需要调用 [`PyBuffer_Release()`](buffer.xhtml#c.PyBuffer_Release "PyBuffer_Release")。
`es` ([`str`](../library/stdtypes.xhtml#str "str")) \[const char \*encoding, char \*\*buffer\]`s` 的变式,它将编码后的Unicode字符存入字符缓冲区。它只处理没有嵌入NUL字节的已编码数据
这个表达式需要两个参数。第一个仅用于传入,并且必须是一个 `const char*` 指向一个 `'utf-8'` 编码的以空终止或者 *NULL* 的字符串名称。如果Python不识别名字的编码方式会引发一个异常。第二个参数必须是一个 `char**`;指针指向一个包含了参数文本内容的缓存区。文本将被第一个参数指定的编码格式编码。
[`PyArg_ParseTuple()`](#c.PyArg_ParseTuple "PyArg_ParseTuple") 会分配一个足够大小的缓冲区,将编码后的数据拷贝进这个缓冲区并且设置 *\*buffer* 引用这个新分配的内存空间。调用者有责任在使用后调用 [`PyMem_Free()`](memory.xhtml#c.PyMem_Free "PyMem_Free") 去释放已经分配的缓冲区。
`et` ([`str`](../library/stdtypes.xhtml#str "str"), [`bytes`](../library/stdtypes.xhtml#bytes "bytes") or [`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray")) \[const char \*encoding, char \*\*buffer\]和 `es` 相同,除了不用重编码传入的字符串对象。相反,它假设传入的参数是编码后的字符串类型。
`es#` ([`str`](../library/stdtypes.xhtml#str "str")) \[const char \*encoding, char \*\*buffer, int \*buffer\_length\]`s#` 的变式,它将已编码的Unicode字符存入字符缓冲区。不像 `es` 表达式,它允许传入的数据包含NUL字符。
它需要三个参数。第一个仅用于传入,并且必须是一个 `const char*` 指向一个 `'utf-8'` 编码的以空终止或者 *NULL* 的字符串名称。如果Python不识别名字的编码方式会引发一个异常。第二个参数必须是一个 `char**`;指针指向一个包含了参数文本内容的缓存区。文本将被第一个参数指定的编码格式编码。第三个参数必须是一个整型指针;指针引用的值用来设定输出缓冲区的字节数量。
有两种操作方式:
如果 *\*buffer* 指向 *NULL*,这个函数会分配一个足够大小的缓冲区,将编码后的数据拷贝进这个缓冲区并且设置 *\*buffer* 引用这个新分配的内存空间。调用者有责任在使用后调用 [`PyMem_Free()`](memory.xhtml#c.PyMem_Free "PyMem_Free") 去释放已经分配的缓冲区。
如果 *\*buffer* 指向一个非 *NULL* 的指针(一个已经分配内存的缓冲区), [`PyArg_ParseTuple()`](#c.PyArg_ParseTuple "PyArg_ParseTuple") 将使用这个地址作为缓冲区并且将 *\*buffer\_length* 初始化的值理解为缓冲区的大小。然后它将编码后的数据拷贝到缓冲区并以空终止。如果这个缓冲区并不是足够大,一个 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError") 会被设置。
在这两个例子中,*\*buffer\_length* 被设置为编码后结尾不为NUL的数据的长度。
`et#` ([`str`](../library/stdtypes.xhtml#str "str"), [`bytes`](../library/stdtypes.xhtml#bytes "bytes") or [`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray")) \[const char \*encoding, char \*\*buffer, int \*buffer\_length\]和 `es#` 相同,除了不用重编码传入的字符串对象。相反,它假设传入的参数是编码后的字符串类型。
### 数字
`b` ([`int`](../library/functions.xhtml#int "int")) \[unsigned char\]将一个非负的Python整型转化成一个无符号的微整型,存储在一个C `unsigned char` 类型中。
`B` ([`int`](../library/functions.xhtml#int "int")) \[unsigned char\]将一个Python整型转化成一个微整型并不检查溢出问题,存储在一个C `unsigned char` 类型中。
`h` ([`int`](../library/functions.xhtml#int "int")) \[short int\]将一个Python整型转化成一个C `short int` 短整型。
`H` ([`int`](../library/functions.xhtml#int "int")) \[unsigned short int\]将一个Python整型转化成一个C `unsigned short int` 无符号短整型,并不检查溢出问题。
`i` ([`int`](../library/functions.xhtml#int "int")) \[int\]将一个Python整型转化成一个C `int` 整型。
`I` ([`int`](../library/functions.xhtml#int "int")) \[unsigned int\]将一个Python整型转化成一个C `unsigned int` 无符号整型,并不检查溢出问题。
`l` ([`int`](../library/functions.xhtml#int "int")) \[long int\]将一个Python整型转化成一个C `long int` 长整型。
`k` ([`int`](../library/functions.xhtml#int "int")) \[unsigned long\]将一个Python整型转化成一个C `unsigned long int` 无符号长整型,并不检查溢出问题。
`L` ([`int`](../library/functions.xhtml#int "int")) \[long long\]将一个Python整型转化成一个C `long long` 长长整型。
`K` ([`int`](../library/functions.xhtml#int "int")) \[unsigned long long\]将一个Python整型转化成一个C `unsigned long long` 无符号长长整型,并不检查溢出问题。
`n` ([`int`](../library/functions.xhtml#int "int")) \[Py\_ssize\_t\]将一个Python整型转化成一个C `Py_ssize_t` Python元大小类型。
`c` ([`bytes`](../library/stdtypes.xhtml#bytes "bytes") 或者 [`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray") 长度为1) \[char\]将一个Python字节类型,如一个长度为1的 [`bytes`](../library/stdtypes.xhtml#bytes "bytes") 或者 [`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray") 对象,转化成一个C `char` 字符类型。
在 3.3 版更改: 允许 [`bytearray`](../library/stdtypes.xhtml#bytearray "bytearray") 类型的对象。
`C` ([`str`](../library/stdtypes.xhtml#str "str") 长度为1) \[int\]将一个Python字符,如一个长度为1的 [`str`](../library/stdtypes.xhtml#str "str") 字符串对象,转化成一个C `int` 整型类型。
`f` ([`float`](../library/functions.xhtml#float "float")) \[float\]将一个Python浮点数转化成一个C `float` 浮点数。
`d` ([`float`](../library/functions.xhtml#float "float")) \[double\]将一个Python浮点数转化成一个C `double` 双精度浮点数。
`D` ([`complex`](../library/functions.xhtml#complex "complex")) \[Py\_complex\]将一个Python复数类型转化成一个C [`Py_complex`](complex.xhtml#c.Py_complex "Py_complex") Python复数类型。
### 其他对象
`O` (object) \[PyObject \*\]用一个C的对象指针存储一个Python对象(没有任何格式转换)。这样传递给C程序的是实际的对象。这个对象的引用计数不会增加。这个指针存储的不是 *NULL*。
`O!` (object) \[*typeobject*, PyObject \*\]将一个Python对象存入一个C指针。和 `O` 类似,但是需要两个C参数:第一个是Python类型对象的地址,第二个是存储对象指针的C变量( [`PyObject*`](structures.xhtml#c.PyObject "PyObject") 变量)的地址。如果Python对象类型不对,会抛出 [`TypeError`](../library/exceptions.xhtml#TypeError "TypeError") 异常。
`O&` (object) \[*converter*, *anything*\]通过一个 *converter* 函数将一个Python对象转换成一个C变量。这需要两个参数:第一个是一个函数,第二个是一个C变量的地址(任意类型的),转化为 `void *` 类型。*converter* 函数像这样被调用:
```
status = converter(object, address);
```
*object\*是待转化的Python对象并且 \*address* 是传入 [`PyArg_Parse*()`](#c.PyArg_Parse "PyArg_Parse") 函数的 `void*` 类型参数。返回的 *status* 是1代表转换成功,0代表转换失败。当转换失败,*converter\*函数会引发一个异常并且不会修改 \*address* 的内容。
如果 *converter* 返回 `Py_CLEANUP_SUPPORTED`,如果参数解析最后失败了它会被第二次调用,给转换函数一个机会区释放它已经分配的内存。在第二次调用中, *object* 参数会是NULL; *address* 会保持第一次调用时的值。
在 3.1 版更改: `Py_CLEANUP_SUPPORTED` 被添加。
`p` ([`bool`](../library/functions.xhtml#bool "bool")) \[int\]测试传入的值是否为真(一个布尔判断)并且将结果转化为相对应的C true/false整型值。如果表达式为真置``1``,假则置``0``。它接受任何合法的Python值。参见 [逻辑值检测](../library/stdtypes.xhtml#truth) 获取更多关于Python如何测试值为真的信息。
3\.3 新版功能.
`(items)` ([`tuple`](../library/stdtypes.xhtml#tuple "tuple")) \[*matching-items*\]对象必须是Python序列,它的长度是 *items* 中格式单元的数量。C参数必须对应 *items* 中每一个独立的格式单元。序列中的格式单元可能有嵌套。
传递 “长”整型(整型的值超过了平台的 `LONG_MAX` 限制)是可能的,然而没有进行适当的范围检测——当接收字段太小而接收不到值时,最重要的位被静默地截断(实际上,C语言会在语义继承的基础上强制类型转换——期望的值可能会发生变化)。
格式化字符串中还有一些其他的字符具有特殊的涵义。这些可能并不嵌套在圆括号中。它们是:
`|`表明在Python参数列表中剩下的参数都是可选的。C变量对应的可选参数需要初始化为默认值——当一个可选参数没有指定时, [`PyArg_ParseTuple()`](#c.PyArg_ParseTuple "PyArg_ParseTuple") 不能访问相应的C变量(变量集)的内容。
`$`[`PyArg_ParseTupleAndKeywords()`](#c.PyArg_ParseTupleAndKeywords "PyArg_ParseTupleAndKeywords") only:表明在Python参数列表中剩下的参数都是强制关键字参数。当前,所有强制关键字参数都必须也是可选参数,所以格式化字符串中 `|` 必须一直在 `$` 前面。
3\.3 新版功能.
`:`格式单元的列表结束标志;冒号后的字符串被用来作为错误消息中的函数名([`PyArg_ParseTuple()`](#c.PyArg_ParseTuple "PyArg_ParseTuple") 函数引发的“关联值”异常)。
`;`格式单元的列表结束标志;分号后的字符串被用来作为错误消息取代默认的错误消息。 `:` 和 `;` 相互排斥。
注意任何由调用者提供的Python对象引用是 *借来的* 引用;不要递减它们的引用计数!
传递给这些函数的附加参数必须是由格式化字符串确定的变量的地址;这些都是用来存储输入元组的值。有一些情况,如上面的格式单元列表中所描述的,这些参数作为输入值使用;在这种情况下,它们应该匹配指定的相应的格式单元。
为了转换成功,*arg* 对象必须匹配格式并且格式必须用尽。成功的话,[`PyArg_Parse*()`](#c.PyArg_Parse "PyArg_Parse") 函数返回true,反之它们返回false并且引发一个合适的异常。当 [`PyArg_Parse*()`](#c.PyArg_Parse "PyArg_Parse") 函数因为某一个格式单元转化失败而失败时,对应的以及后续的格式单元地址内的变量都不会被使用。
### API 函数
int `PyArg_ParseTuple`([PyObject](structures.xhtml#c.PyObject "PyObject") *\*args*, const char *\*format*, ...)解析一个函数的参数,表达式中的参数按参数位置顺序存入局部变量中。成功返回true;失败返回false并且引发相应的异常。
int `PyArg_VaParse`([PyObject](structures.xhtml#c.PyObject "PyObject") *\*args*, const char *\*format*, va\_list *vargs*)和 [`PyArg_ParseTuple()`](#c.PyArg_ParseTuple "PyArg_ParseTuple") 相同,然而它接受一个va\_list类型的参数而不是可变数量的参数集。
int `PyArg_ParseTupleAndKeywords`([PyObject](structures.xhtml#c.PyObject "PyObject") *\*args*, [PyObject](structures.xhtml#c.PyObject "PyObject") *\*kw*, const char *\*format*, char *\*keywords\[\]*, ...)解析一个函数的参数,关键字参数和表达式中的参数按参数位置顺序存入局部变量中。其中\*keywords\*参数是一个以空结束的数组,存放关键字参数的名称。空的名称表示为 [positional-only parameters](../glossary.xhtml#positional-only-parameter) 。成功返回true;失败返回false并且引发相应的异常。
在 3.6 版更改: 添加了 [positional-only parameters](../glossary.xhtml#positional-only-parameter) 的支持。
int `PyArg_VaParseTupleAndKeywords`([PyObject](structures.xhtml#c.PyObject "PyObject") *\*args*, [PyObject](structures.xhtml#c.PyObject "PyObject") *\*kw*, const char *\*format*, char *\*keywords\[\]*, va\_list *vargs*)和 [`PyArg_ParseTupleAndKeywords()`](#c.PyArg_ParseTupleAndKeywords "PyArg_ParseTupleAndKeywords") 相同,然而它接受一个va\_list类型的参数而不是可变数量的参数集。
int `PyArg_ValidateKeywordArguments`([PyObject](structures.xhtml#c.PyObject "PyObject") *\**)确保字典中的关键字参数都是字符串。这个函数只被使用于 [`PyArg_ParseTupleAndKeywords()`](#c.PyArg_ParseTupleAndKeywords "PyArg_ParseTupleAndKeywords") 不被使用的情况下,后者已经不再做这样的检查。
3\.2 新版功能.
int `PyArg_Parse`([PyObject](structures.xhtml#c.PyObject "PyObject") *\*args*, const char *\*format*, ...)函数被用来析构“旧类型”函数的参数列表——这些函数使用的 `METH_OLDARGS` 参数解析方法已从Python 3中移除。这不被推荐用于新代码的参数解析,并且在标准解释器中的大多数代码已被修改,已不再用于该目的。它仍然方便于分解其他元组,然而可能因为这个目的被继续使用。
int `PyArg_UnpackTuple`([PyObject](structures.xhtml#c.PyObject "PyObject") *\*args*, const char *\*name*, Py\_ssize\_t *min*, Py\_ssize\_t *max*, ...)一个不使用格式化字符串指定参数类型的简单形式的参数检索。使用这种方法来检索参数的函数应该在函数或者方法表中声明 [`METH_VARARGS`](structures.xhtml#METH_VARARGS "METH_VARARGS")。包含实际参数的元组应该以 *args* 形式被传入;它必须是一个实际的元组。元组的长度必须至少是 *min* 并且不超过 *max*; *min* 和 *max* 可能相同。额外的参数必须传递给函数,每一个参数必须是一个指向 [`PyObject*`](structures.xhtml#c.PyObject "PyObject") 类型变量的指针;它们将被赋值为 *args* 的值;它们将包含借来的引用。不在 *args* 里面的可选参数不会被赋值;由调用者完成初始化。函数成功则返回true并且如果 *args* 不是元组或者包含错误数量的元素则返回false;如果失败了会引发一个异常。
这是一个使用此函数的示例,取自 `_weakref` 帮助模块用来弱化引用的源代码:
```
static PyObject *
weakref_ref(PyObject *self, PyObject *args)
{
PyObject *object;
PyObject *callback = NULL;
PyObject *result = NULL;
if (PyArg_UnpackTuple(args, "ref", 1, 2, &object, &callback)) {
result = PyWeakref_NewRef(object, callback);
}
return result;
}
```
这个例子中调用 [`PyArg_UnpackTuple()`](#c.PyArg_UnpackTuple "PyArg_UnpackTuple") 完全等价于调用 [`PyArg_ParseTuple()`](#c.PyArg_ParseTuple "PyArg_ParseTuple"):
```
PyArg_ParseTuple(args, "O|O:ref", &object, &callback)
```
## 创建变量
[PyObject](structures.xhtml#c.PyObject "PyObject")\* `Py_BuildValue`(const char *\*format*, ...)*Return value: New reference.*基于格式化字符串创建一个新的值和那些 [`PyArg_Parse*()`](#c.PyArg_Parse "PyArg_Parse") 函数族接受的函数及一系列值类似。返回这个值或者一旦出错返回 *NULL*;如果返回的是 *NULL* 会引发一个异常。
[`Py_BuildValue()`](#c.Py_BuildValue "Py_BuildValue") 并不一直创建一个元组。只有当它的格式化字符串包含两个或更多的格式单元才会创建一个元组。如果格式化字符串是空,它返回 `None`;如果它包含一个格式单元,它返回由格式单元描述的的任一对象。用圆括号包裹格式化字符串可以强制它返回一个大小为0或者1的元组
当内存缓存区的数据以参数形式传递用来构建对象时,如 `s` 和 `s#` 格式单元,会拷贝需要的数据。调用者提供的缓冲区从来都不会被由 [`Py_BuildValue()`](#c.Py_BuildValue "Py_BuildValue") 创建的对象来引用。换句话说,如果你的代码调用 `malloc()` 并且将分配的内存空间传递给 [`Py_BuildValue()`](#c.Py_BuildValue "Py_BuildValue"),你的代码就有责任在 [`Py_BuildValue()`](#c.Py_BuildValue "Py_BuildValue") 返回时调用 `free()` 。
在下面的描述中,双引号的表达式使格式单元;圆括号()内的是格式单元将要返回的Python对象类型;方括号\[\]内的是传递的C变量(变量集)的类型
字符例如空格,制表符,冒号和逗号在格式化字符串中会被忽略(但是不包括格式单元,如 `s#`)。这可以使很长的格式化字符串具有更好的可读性。
`s` ([`str`](../library/stdtypes.xhtml#str "str") 或 `None`) \[const char \*\]使用 `'utf-8'` 编码将一个C以空结束的字符串转化成Python [`str`](../library/stdtypes.xhtml#str "str") 字符串对象。如果这个C字符串指针是 *NULL* ,返回 `None` 。
`s#` ([`str`](../library/stdtypes.xhtml#str "str") 或 `None`) \[const char \*, int\]使用 `'utf-8'` 编码将一个C字符串和其长度转化成Python [`str`](../library/stdtypes.xhtml#str "str") 字符串对象。如果这个C字符串指针是 *NULL* ,长度会被忽略并且返回 `None` 。
`y` ([`bytes`](../library/stdtypes.xhtml#bytes "bytes")) \[const char \*\]它将一个C字符串和其长度转化成一个Python [`bytes`](../library/stdtypes.xhtml#bytes "bytes") 字节类型对象。如果这个C字符串指针是 *NULL*,返回``None``
`y#` ([`bytes`](../library/stdtypes.xhtml#bytes "bytes")) \[const char \*, int\]它将一个C字符串和其长度转化成一个Python对象。如果这个C字符串指针是 *NULL*,返回``None``。
`z` ([`str`](../library/stdtypes.xhtml#str "str") or `None`) \[const char \*\]和``s``一样。
`z#` ([`str`](../library/stdtypes.xhtml#str "str") 或 `None`) \[const char \*, int\]和``s#``一样。
`u` ([`str`](../library/stdtypes.xhtml#str "str")) \[const wchar\_t \*\]将一个以 null 结束的 `wchar_t` Unicode (UTF-16 或 UCS-4) 数据缓冲区转换为一个 Python Unicode 对象。如果 Unicode 缓冲区指针为 *NULL* 则返回 `None`。
`u#` ([`str`](../library/stdtypes.xhtml#str "str")) \[const wchar\_t \*, int\]将一个 Unicode (UTF-16 或 UCS-4) 数据缓冲区及其长度转换为一个 Python Unicode 对象。如果 Unicode 缓冲区指针为 *NULL* 则忽略长度并返回 `None`。
`U` ([`str`](../library/stdtypes.xhtml#str "str") 或 `None`) \[const char \*\]和``s``一样。
`U#` ([`str`](../library/stdtypes.xhtml#str "str") 或 `None`) \[const char \*, int\]和``s#``一样。
`i` ([`int`](../library/functions.xhtml#int "int")) \[int\]将一个C `int` 整型转化成Python整型对象。
`b` ([`int`](../library/functions.xhtml#int "int")) \[char\]将一个C `char` 字符型转化成Python整型对象。
`h` ([`int`](../library/functions.xhtml#int "int")) \[short int\]将一个C `short int` 短整型转化成Python整型对象。
`l` ([`int`](../library/functions.xhtml#int "int")) \[long int\]将一个C `long int` 长整型转化成Python整型对象。
`B` ([`int`](../library/functions.xhtml#int "int")) \[unsigned char\]将一个C `unsigned char` 无符号字符型转化成Python整型对象。
`H` ([`int`](../library/functions.xhtml#int "int")) \[unsigned short int\]将一个C `unsigned long` 无符号短整型转化成Python整型对象。
`I` ([`int`](../library/functions.xhtml#int "int")) \[unsigned int\]将一个C `unsigned long` 无符号整型转化成Python整型对象。
`k` ([`int`](../library/functions.xhtml#int "int")) \[unsigned long\]将一个C `unsigned long` 无符号长整型转化成Python整型对象。
`L` ([`int`](../library/functions.xhtml#int "int")) \[long long\]将一个C `long long` 长长整形转化成Python整形对象。
`K` ([`int`](../library/functions.xhtml#int "int")) \[unsigned long long\]将一个C `unsigned long long` 无符号长长整型转化成Python整型对象。
`n` ([`int`](../library/functions.xhtml#int "int")) \[Py\_ssize\_t\]将一个C `Py_ssize_t` 类型转化为Python整型。
`c` ([`bytes`](../library/stdtypes.xhtml#bytes "bytes") 长度为1 ) \[char\]将一个C `int` 整型代表的字符转化为Python [`bytes`](../library/stdtypes.xhtml#bytes "bytes") 长度为1的字节对象。
`C` ([`str`](../library/stdtypes.xhtml#str "str") 长度为1) \[int\]将一个C `int` 整型代表的字符转化为Python [`str`](../library/stdtypes.xhtml#str "str") 长度为1的字符串对象。
`d` ([`float`](../library/functions.xhtml#float "float")) \[double\]将一个C `double` 双精度浮点数转化为Python浮点数类型数字。
`f` ([`float`](../library/functions.xhtml#float "float")) \[float\]将一个C `float` 单精度浮点数转化为Python浮点数类型数字。
`D` (`复数`) \[Py\_complex \*\]将一个C [`Py_complex`](complex.xhtml#c.Py_complex "Py_complex") 类型的结构转化为Python复数类型。
`O` (object) \[PyObject \*\]接受一个不变的Python对象(除了它的引用计数,引用计数会递增1)。如果传入的对象是一个 *NULL* 指针,会假设这是因为调用传递了错误的参数并且抛出异常。因此 [`Py_BuildValue()`](#c.Py_BuildValue "Py_BuildValue") 会返回 *NULL* 但是不会引发异常。如果没有引发异常,[`SystemError`](../library/exceptions.xhtml#SystemError "SystemError") 会被设置。
`S` (object) \[PyObject \*\]和``O``相同。
`N` (object) \[PyObject \*\]和``O``相同,然而它并不增加对象的引用计数。当通过调用参数列表中的对象构造器创建对象时很实用。
`O&` (object) \[*converter*, *anything*\]通过 *converter* 函数将 *任何类型的变量\*转化为一个Python对象。这个函数调用 \*任何类型的变量* (这个类型可以被 `void *` 兼容) 作为它的参数,并且应该返回一个"新的"Python对象,或者 *NULL* 如果有错误产生。
`(items)` ([`tuple`](../library/stdtypes.xhtml#tuple "tuple")) \[*matching-items*\]将一个C变量序列转换成Python元组并保持相同的元素数量
`[items]` ([`list`](../library/stdtypes.xhtml#list "list")) \[*相关的元素*\]将一个C变量序列转换成Python列表并保持相同的元素数量
`{items}` ([`dict`](../library/stdtypes.xhtml#dict "dict")) \[*相关的元素*\]将一个C变量序列转换成Python字典。每一对连续的C变量对作为一个元素插入字典中,分别作为关键字和值。
如果格式化字符串中有一个错误,异常 [`SystemError`](../library/exceptions.xhtml#SystemError "SystemError") 会被设置并且返回 *NULL* 。
[PyObject](structures.xhtml#c.PyObject "PyObject")\* `Py_VaBuildValue`(const char *\*format*, va\_list *vargs*)*Return value: New reference.*和 [`Py_BuildValue()`](#c.Py_BuildValue "Py_BuildValue") 相同,然而它接受一个va\_list类型的参数而不是可变数量的参数集。
### 导航
- [索引](../genindex.xhtml "总目录")
- [模块](../py-modindex.xhtml "Python 模块索引") |
- [下一页](conversion.xhtml "字符串转换与格式化") |
- [上一页](marshal.xhtml "Data marshalling support") |
- ![](https://box.kancloud.cn/a721fc7ec672275e257bbbfde49a4d4e_16x16.png)
- [Python](https://www.python.org/) »
- zh\_CN 3.7.3 [文档](../index.xhtml) »
- [Python/C API 参考手册](index.xhtml) »
- [工具](utilities.xhtml) »
- $('.inline-search').show(0); |
© [版权所有](../copyright.xhtml) 2001-2019, Python Software Foundation.
Python 软件基金会是一个非盈利组织。 [请捐助。](https://www.python.org/psf/donations/)
最后更新于 5月 21, 2019. [发现了问题](../bugs.xhtml)?
使用[Sphinx](http://sphinx.pocoo.org/)1.8.4 创建。
- Python文档内容
- Python 有什么新变化?
- Python 3.7 有什么新变化
- 摘要 - 发布重点
- 新的特性
- 其他语言特性修改
- 新增模块
- 改进的模块
- C API 的改变
- 构建的改变
- 性能优化
- 其他 CPython 实现的改变
- 已弃用的 Python 行为
- 已弃用的 Python 模块、函数和方法
- 已弃用的 C API 函数和类型
- 平台支持的移除
- API 与特性的移除
- 移除的模块
- Windows 专属的改变
- 移植到 Python 3.7
- Python 3.7.1 中的重要变化
- Python 3.7.2 中的重要变化
- Python 3.6 有什么新变化A
- 摘要 - 发布重点
- 新的特性
- 其他语言特性修改
- 新增模块
- 改进的模块
- 性能优化
- Build and C API Changes
- 其他改进
- 弃用
- 移除
- 移植到Python 3.6
- Python 3.6.2 中的重要变化
- Python 3.6.4 中的重要变化
- Python 3.6.5 中的重要变化
- Python 3.6.7 中的重要变化
- Python 3.5 有什么新变化
- 摘要 - 发布重点
- 新的特性
- 其他语言特性修改
- 新增模块
- 改进的模块
- Other module-level changes
- 性能优化
- Build and C API Changes
- 弃用
- 移除
- Porting to Python 3.5
- Notable changes in Python 3.5.4
- What's New In Python 3.4
- 摘要 - 发布重点
- 新的特性
- 新增模块
- 改进的模块
- CPython Implementation Changes
- 弃用
- 移除
- Porting to Python 3.4
- Changed in 3.4.3
- What's New In Python 3.3
- 摘要 - 发布重点
- PEP 405: Virtual Environments
- PEP 420: Implicit Namespace Packages
- PEP 3118: New memoryview implementation and buffer protocol documentation
- PEP 393: Flexible String Representation
- PEP 397: Python Launcher for Windows
- PEP 3151: Reworking the OS and IO exception hierarchy
- PEP 380: Syntax for Delegating to a Subgenerator
- PEP 409: Suppressing exception context
- PEP 414: Explicit Unicode literals
- PEP 3155: Qualified name for classes and functions
- PEP 412: Key-Sharing Dictionary
- PEP 362: Function Signature Object
- PEP 421: Adding sys.implementation
- Using importlib as the Implementation of Import
- 其他语言特性修改
- A Finer-Grained Import Lock
- Builtin functions and types
- 新增模块
- 改进的模块
- 性能优化
- Build and C API Changes
- 弃用
- Porting to Python 3.3
- What's New In Python 3.2
- PEP 384: Defining a Stable ABI
- PEP 389: Argparse Command Line Parsing Module
- PEP 391: Dictionary Based Configuration for Logging
- PEP 3148: The concurrent.futures module
- PEP 3147: PYC Repository Directories
- PEP 3149: ABI Version Tagged .so Files
- PEP 3333: Python Web Server Gateway Interface v1.0.1
- 其他语言特性修改
- New, Improved, and Deprecated Modules
- 多线程
- 性能优化
- Unicode
- Codecs
- 文档
- IDLE
- Code Repository
- Build and C API Changes
- Porting to Python 3.2
- What's New In Python 3.1
- PEP 372: Ordered Dictionaries
- PEP 378: Format Specifier for Thousands Separator
- 其他语言特性修改
- New, Improved, and Deprecated Modules
- 性能优化
- IDLE
- Build and C API Changes
- Porting to Python 3.1
- What's New In Python 3.0
- Common Stumbling Blocks
- Overview Of Syntax Changes
- Changes Already Present In Python 2.6
- Library Changes
- PEP 3101: A New Approach To String Formatting
- Changes To Exceptions
- Miscellaneous Other Changes
- Build and C API Changes
- 性能
- Porting To Python 3.0
- What's New in Python 2.7
- The Future for Python 2.x
- Changes to the Handling of Deprecation Warnings
- Python 3.1 Features
- PEP 372: Adding an Ordered Dictionary to collections
- PEP 378: Format Specifier for Thousands Separator
- PEP 389: The argparse Module for Parsing Command Lines
- PEP 391: Dictionary-Based Configuration For Logging
- PEP 3106: Dictionary Views
- PEP 3137: The memoryview Object
- 其他语言特性修改
- New and Improved Modules
- Build and C API Changes
- Other Changes and Fixes
- Porting to Python 2.7
- New Features Added to Python 2.7 Maintenance Releases
- Acknowledgements
- Python 2.6 有什么新变化
- Python 3.0
- Changes to the Development Process
- PEP 343: The 'with' statement
- PEP 366: Explicit Relative Imports From a Main Module
- PEP 370: Per-user site-packages Directory
- PEP 371: The multiprocessing Package
- PEP 3101: Advanced String Formatting
- PEP 3105: print As a Function
- PEP 3110: Exception-Handling Changes
- PEP 3112: Byte Literals
- PEP 3116: New I/O Library
- PEP 3118: Revised Buffer Protocol
- PEP 3119: Abstract Base Classes
- PEP 3127: Integer Literal Support and Syntax
- PEP 3129: Class Decorators
- PEP 3141: A Type Hierarchy for Numbers
- 其他语言特性修改
- New and Improved Modules
- Deprecations and Removals
- Build and C API Changes
- Porting to Python 2.6
- Acknowledgements
- What's New in Python 2.5
- PEP 308: Conditional Expressions
- PEP 309: Partial Function Application
- PEP 314: Metadata for Python Software Packages v1.1
- PEP 328: Absolute and Relative Imports
- PEP 338: Executing Modules as Scripts
- PEP 341: Unified try/except/finally
- PEP 342: New Generator Features
- PEP 343: The 'with' statement
- PEP 352: Exceptions as New-Style Classes
- PEP 353: Using ssize_t as the index type
- PEP 357: The 'index' method
- 其他语言特性修改
- New, Improved, and Removed Modules
- Build and C API Changes
- Porting to Python 2.5
- Acknowledgements
- What's New in Python 2.4
- PEP 218: Built-In Set Objects
- PEP 237: Unifying Long Integers and Integers
- PEP 289: Generator Expressions
- PEP 292: Simpler String Substitutions
- PEP 318: Decorators for Functions and Methods
- PEP 322: Reverse Iteration
- PEP 324: New subprocess Module
- PEP 327: Decimal Data Type
- PEP 328: Multi-line Imports
- PEP 331: Locale-Independent Float/String Conversions
- 其他语言特性修改
- New, Improved, and Deprecated Modules
- Build and C API Changes
- Porting to Python 2.4
- Acknowledgements
- What's New in Python 2.3
- PEP 218: A Standard Set Datatype
- PEP 255: Simple Generators
- PEP 263: Source Code Encodings
- PEP 273: Importing Modules from ZIP Archives
- PEP 277: Unicode file name support for Windows NT
- PEP 278: Universal Newline Support
- PEP 279: enumerate()
- PEP 282: The logging Package
- PEP 285: A Boolean Type
- PEP 293: Codec Error Handling Callbacks
- PEP 301: Package Index and Metadata for Distutils
- PEP 302: New Import Hooks
- PEP 305: Comma-separated Files
- PEP 307: Pickle Enhancements
- Extended Slices
- 其他语言特性修改
- New, Improved, and Deprecated Modules
- Pymalloc: A Specialized Object Allocator
- Build and C API Changes
- Other Changes and Fixes
- Porting to Python 2.3
- Acknowledgements
- What's New in Python 2.2
- 概述
- PEPs 252 and 253: Type and Class Changes
- PEP 234: Iterators
- PEP 255: Simple Generators
- PEP 237: Unifying Long Integers and Integers
- PEP 238: Changing the Division Operator
- Unicode Changes
- PEP 227: Nested Scopes
- New and Improved Modules
- Interpreter Changes and Fixes
- Other Changes and Fixes
- Acknowledgements
- What's New in Python 2.1
- 概述
- PEP 227: Nested Scopes
- PEP 236: future Directives
- PEP 207: Rich Comparisons
- PEP 230: Warning Framework
- PEP 229: New Build System
- PEP 205: Weak References
- PEP 232: Function Attributes
- PEP 235: Importing Modules on Case-Insensitive Platforms
- PEP 217: Interactive Display Hook
- PEP 208: New Coercion Model
- PEP 241: Metadata in Python Packages
- New and Improved Modules
- Other Changes and Fixes
- Acknowledgements
- What's New in Python 2.0
- 概述
- What About Python 1.6?
- New Development Process
- Unicode
- 列表推导式
- Augmented Assignment
- 字符串的方法
- Garbage Collection of Cycles
- Other Core Changes
- Porting to 2.0
- Extending/Embedding Changes
- Distutils: Making Modules Easy to Install
- XML Modules
- Module changes
- New modules
- IDLE Improvements
- Deleted and Deprecated Modules
- Acknowledgements
- 更新日志
- Python 下一版
- Python 3.7.3 最终版
- Python 3.7.3 发布候选版 1
- Python 3.7.2 最终版
- Python 3.7.2 发布候选版 1
- Python 3.7.1 最终版
- Python 3.7.1 RC 2版本
- Python 3.7.1 发布候选版 1
- Python 3.7.0 正式版
- Python 3.7.0 release candidate 1
- Python 3.7.0 beta 5
- Python 3.7.0 beta 4
- Python 3.7.0 beta 3
- Python 3.7.0 beta 2
- Python 3.7.0 beta 1
- Python 3.7.0 alpha 4
- Python 3.7.0 alpha 3
- Python 3.7.0 alpha 2
- Python 3.7.0 alpha 1
- Python 3.6.6 final
- Python 3.6.6 RC 1
- Python 3.6.5 final
- Python 3.6.5 release candidate 1
- Python 3.6.4 final
- Python 3.6.4 release candidate 1
- Python 3.6.3 final
- Python 3.6.3 release candidate 1
- Python 3.6.2 final
- Python 3.6.2 release candidate 2
- Python 3.6.2 release candidate 1
- Python 3.6.1 final
- Python 3.6.1 release candidate 1
- Python 3.6.0 final
- Python 3.6.0 release candidate 2
- Python 3.6.0 release candidate 1
- Python 3.6.0 beta 4
- Python 3.6.0 beta 3
- Python 3.6.0 beta 2
- Python 3.6.0 beta 1
- Python 3.6.0 alpha 4
- Python 3.6.0 alpha 3
- Python 3.6.0 alpha 2
- Python 3.6.0 alpha 1
- Python 3.5.5 final
- Python 3.5.5 release candidate 1
- Python 3.5.4 final
- Python 3.5.4 release candidate 1
- Python 3.5.3 final
- Python 3.5.3 release candidate 1
- Python 3.5.2 final
- Python 3.5.2 release candidate 1
- Python 3.5.1 final
- Python 3.5.1 release candidate 1
- Python 3.5.0 final
- Python 3.5.0 release candidate 4
- Python 3.5.0 release candidate 3
- Python 3.5.0 release candidate 2
- Python 3.5.0 release candidate 1
- Python 3.5.0 beta 4
- Python 3.5.0 beta 3
- Python 3.5.0 beta 2
- Python 3.5.0 beta 1
- Python 3.5.0 alpha 4
- Python 3.5.0 alpha 3
- Python 3.5.0 alpha 2
- Python 3.5.0 alpha 1
- Python 教程
- 课前甜点
- 使用 Python 解释器
- 调用解释器
- 解释器的运行环境
- Python 的非正式介绍
- Python 作为计算器使用
- 走向编程的第一步
- 其他流程控制工具
- if 语句
- for 语句
- range() 函数
- break 和 continue 语句,以及循环中的 else 子句
- pass 语句
- 定义函数
- 函数定义的更多形式
- 小插曲:编码风格
- 数据结构
- 列表的更多特性
- del 语句
- 元组和序列
- 集合
- 字典
- 循环的技巧
- 深入条件控制
- 序列和其它类型的比较
- 模块
- 有关模块的更多信息
- 标准模块
- dir() 函数
- 包
- 输入输出
- 更漂亮的输出格式
- 读写文件
- 错误和异常
- 语法错误
- 异常
- 处理异常
- 抛出异常
- 用户自定义异常
- 定义清理操作
- 预定义的清理操作
- 类
- 名称和对象
- Python 作用域和命名空间
- 初探类
- 补充说明
- 继承
- 私有变量
- 杂项说明
- 迭代器
- 生成器
- 生成器表达式
- 标准库简介
- 操作系统接口
- 文件通配符
- 命令行参数
- 错误输出重定向和程序终止
- 字符串模式匹配
- 数学
- 互联网访问
- 日期和时间
- 数据压缩
- 性能测量
- 质量控制
- 自带电池
- 标准库简介 —— 第二部分
- 格式化输出
- 模板
- 使用二进制数据记录格式
- 多线程
- 日志
- 弱引用
- 用于操作列表的工具
- 十进制浮点运算
- 虚拟环境和包
- 概述
- 创建虚拟环境
- 使用pip管理包
- 接下来?
- 交互式编辑和编辑历史
- Tab 补全和编辑历史
- 默认交互式解释器的替代品
- 浮点算术:争议和限制
- 表示性错误
- 附录
- 交互模式
- 安装和使用 Python
- 命令行与环境
- 命令行
- 环境变量
- 在Unix平台中使用Python
- 获取最新版本的Python
- 构建Python
- 与Python相关的路径和文件
- 杂项
- 编辑器和集成开发环境
- 在Windows上使用 Python
- 完整安装程序
- Microsoft Store包
- nuget.org 安装包
- 可嵌入的包
- 替代捆绑包
- 配置Python
- 适用于Windows的Python启动器
- 查找模块
- 附加模块
- 在Windows上编译Python
- 其他平台
- 在苹果系统上使用 Python
- 获取和安装 MacPython
- IDE
- 安装额外的 Python 包
- Mac 上的图形界面编程
- 在 Mac 上分发 Python 应用程序
- 其他资源
- Python 语言参考
- 概述
- 其他实现
- 标注
- 词法分析
- 行结构
- 其他形符
- 标识符和关键字
- 字面值
- 运算符
- 分隔符
- 数据模型
- 对象、值与类型
- 标准类型层级结构
- 特殊方法名称
- 协程
- 执行模型
- 程序的结构
- 命名与绑定
- 异常
- 导入系统
- importlib
- 包
- 搜索
- 加载
- 基于路径的查找器
- 替换标准导入系统
- Package Relative Imports
- 有关 main 的特殊事项
- 开放问题项
- 参考文献
- 表达式
- 算术转换
- 原子
- 原型
- await 表达式
- 幂运算符
- 一元算术和位运算
- 二元算术运算符
- 移位运算
- 二元位运算
- 比较运算
- 布尔运算
- 条件表达式
- lambda 表达式
- 表达式列表
- 求值顺序
- 运算符优先级
- 简单语句
- 表达式语句
- 赋值语句
- assert 语句
- pass 语句
- del 语句
- return 语句
- yield 语句
- raise 语句
- break 语句
- continue 语句
- import 语句
- global 语句
- nonlocal 语句
- 复合语句
- if 语句
- while 语句
- for 语句
- try 语句
- with 语句
- 函数定义
- 类定义
- 协程
- 最高层级组件
- 完整的 Python 程序
- 文件输入
- 交互式输入
- 表达式输入
- 完整的语法规范
- Python 标准库
- 概述
- 可用性注释
- 内置函数
- 内置常量
- 由 site 模块添加的常量
- 内置类型
- 逻辑值检测
- 布尔运算 — and, or, not
- 比较
- 数字类型 — int, float, complex
- 迭代器类型
- 序列类型 — list, tuple, range
- 文本序列类型 — str
- 二进制序列类型 — bytes, bytearray, memoryview
- 集合类型 — set, frozenset
- 映射类型 — dict
- 上下文管理器类型
- 其他内置类型
- 特殊属性
- 内置异常
- 基类
- 具体异常
- 警告
- 异常层次结构
- 文本处理服务
- string — 常见的字符串操作
- re — 正则表达式操作
- 模块 difflib 是一个计算差异的助手
- textwrap — Text wrapping and filling
- unicodedata — Unicode 数据库
- stringprep — Internet String Preparation
- readline — GNU readline interface
- rlcompleter — GNU readline的完成函数
- 二进制数据服务
- struct — Interpret bytes as packed binary data
- codecs — Codec registry and base classes
- 数据类型
- datetime — 基础日期/时间数据类型
- calendar — General calendar-related functions
- collections — 容器数据类型
- collections.abc — 容器的抽象基类
- heapq — 堆队列算法
- bisect — Array bisection algorithm
- array — Efficient arrays of numeric values
- weakref — 弱引用
- types — Dynamic type creation and names for built-in types
- copy — 浅层 (shallow) 和深层 (deep) 复制操作
- pprint — 数据美化输出
- reprlib — Alternate repr() implementation
- enum — Support for enumerations
- 数字和数学模块
- numbers — 数字的抽象基类
- math — 数学函数
- cmath — Mathematical functions for complex numbers
- decimal — 十进制定点和浮点运算
- fractions — 分数
- random — 生成伪随机数
- statistics — Mathematical statistics functions
- 函数式编程模块
- itertools — 为高效循环而创建迭代器的函数
- functools — 高阶函数和可调用对象上的操作
- operator — 标准运算符替代函数
- 文件和目录访问
- pathlib — 面向对象的文件系统路径
- os.path — 常见路径操作
- fileinput — Iterate over lines from multiple input streams
- stat — Interpreting stat() results
- filecmp — File and Directory Comparisons
- tempfile — Generate temporary files and directories
- glob — Unix style pathname pattern expansion
- fnmatch — Unix filename pattern matching
- linecache — Random access to text lines
- shutil — High-level file operations
- macpath — Mac OS 9 路径操作函数
- 数据持久化
- pickle —— Python 对象序列化
- copyreg — Register pickle support functions
- shelve — Python object persistence
- marshal — Internal Python object serialization
- dbm — Interfaces to Unix “databases”
- sqlite3 — SQLite 数据库 DB-API 2.0 接口模块
- 数据压缩和存档
- zlib — 与 gzip 兼容的压缩
- gzip — 对 gzip 格式的支持
- bz2 — 对 bzip2 压缩算法的支持
- lzma — 用 LZMA 算法压缩
- zipfile — 在 ZIP 归档中工作
- tarfile — Read and write tar archive files
- 文件格式
- csv — CSV 文件读写
- configparser — Configuration file parser
- netrc — netrc file processing
- xdrlib — Encode and decode XDR data
- plistlib — Generate and parse Mac OS X .plist files
- 加密服务
- hashlib — 安全哈希与消息摘要
- hmac — 基于密钥的消息验证
- secrets — Generate secure random numbers for managing secrets
- 通用操作系统服务
- os — 操作系统接口模块
- io — 处理流的核心工具
- time — 时间的访问和转换
- argparse — 命令行选项、参数和子命令解析器
- getopt — C-style parser for command line options
- 模块 logging — Python 的日志记录工具
- logging.config — 日志记录配置
- logging.handlers — Logging handlers
- getpass — 便携式密码输入工具
- curses — 终端字符单元显示的处理
- curses.textpad — Text input widget for curses programs
- curses.ascii — Utilities for ASCII characters
- curses.panel — A panel stack extension for curses
- platform — Access to underlying platform's identifying data
- errno — Standard errno system symbols
- ctypes — Python 的外部函数库
- 并发执行
- threading — 基于线程的并行
- multiprocessing — 基于进程的并行
- concurrent 包
- concurrent.futures — 启动并行任务
- subprocess — 子进程管理
- sched — 事件调度器
- queue — 一个同步的队列类
- _thread — 底层多线程 API
- _dummy_thread — _thread 的替代模块
- dummy_threading — 可直接替代 threading 模块。
- contextvars — Context Variables
- Context Variables
- Manual Context Management
- asyncio support
- 网络和进程间通信
- asyncio — 异步 I/O
- socket — 底层网络接口
- ssl — TLS/SSL wrapper for socket objects
- select — Waiting for I/O completion
- selectors — 高级 I/O 复用库
- asyncore — 异步socket处理器
- asynchat — 异步 socket 指令/响应 处理器
- signal — Set handlers for asynchronous events
- mmap — Memory-mapped file support
- 互联网数据处理
- email — 电子邮件与 MIME 处理包
- json — JSON 编码和解码器
- mailcap — Mailcap file handling
- mailbox — Manipulate mailboxes in various formats
- mimetypes — Map filenames to MIME types
- base64 — Base16, Base32, Base64, Base85 数据编码
- binhex — 对binhex4文件进行编码和解码
- binascii — 二进制和 ASCII 码互转
- quopri — Encode and decode MIME quoted-printable data
- uu — Encode and decode uuencode files
- 结构化标记处理工具
- html — 超文本标记语言支持
- html.parser — 简单的 HTML 和 XHTML 解析器
- html.entities — HTML 一般实体的定义
- XML处理模块
- xml.etree.ElementTree — The ElementTree XML API
- xml.dom — The Document Object Model API
- xml.dom.minidom — Minimal DOM implementation
- xml.dom.pulldom — Support for building partial DOM trees
- xml.sax — Support for SAX2 parsers
- xml.sax.handler — Base classes for SAX handlers
- xml.sax.saxutils — SAX Utilities
- xml.sax.xmlreader — Interface for XML parsers
- xml.parsers.expat — Fast XML parsing using Expat
- 互联网协议和支持
- webbrowser — 方便的Web浏览器控制器
- cgi — Common Gateway Interface support
- cgitb — Traceback manager for CGI scripts
- wsgiref — WSGI Utilities and Reference Implementation
- urllib — URL 处理模块
- urllib.request — 用于打开 URL 的可扩展库
- urllib.response — Response classes used by urllib
- urllib.parse — Parse URLs into components
- urllib.error — Exception classes raised by urllib.request
- urllib.robotparser — Parser for robots.txt
- http — HTTP 模块
- http.client — HTTP协议客户端
- ftplib — FTP protocol client
- poplib — POP3 protocol client
- imaplib — IMAP4 protocol client
- nntplib — NNTP protocol client
- smtplib —SMTP协议客户端
- smtpd — SMTP Server
- telnetlib — Telnet client
- uuid — UUID objects according to RFC 4122
- socketserver — A framework for network servers
- http.server — HTTP 服务器
- http.cookies — HTTP state management
- http.cookiejar — Cookie handling for HTTP clients
- xmlrpc — XMLRPC 服务端与客户端模块
- xmlrpc.client — XML-RPC client access
- xmlrpc.server — Basic XML-RPC servers
- ipaddress — IPv4/IPv6 manipulation library
- 多媒体服务
- audioop — Manipulate raw audio data
- aifc — Read and write AIFF and AIFC files
- sunau — 读写 Sun AU 文件
- wave — 读写WAV格式文件
- chunk — Read IFF chunked data
- colorsys — Conversions between color systems
- imghdr — 推测图像类型
- sndhdr — 推测声音文件的类型
- ossaudiodev — Access to OSS-compatible audio devices
- 国际化
- gettext — 多语种国际化服务
- locale — 国际化服务
- 程序框架
- turtle — 海龟绘图
- cmd — 支持面向行的命令解释器
- shlex — Simple lexical analysis
- Tk图形用户界面(GUI)
- tkinter — Tcl/Tk的Python接口
- tkinter.ttk — Tk themed widgets
- tkinter.tix — Extension widgets for Tk
- tkinter.scrolledtext — 滚动文字控件
- IDLE
- 其他图形用户界面(GUI)包
- 开发工具
- typing — 类型标注支持
- pydoc — Documentation generator and online help system
- doctest — Test interactive Python examples
- unittest — 单元测试框架
- unittest.mock — mock object library
- unittest.mock 上手指南
- 2to3 - 自动将 Python 2 代码转为 Python 3 代码
- test — Regression tests package for Python
- test.support — Utilities for the Python test suite
- test.support.script_helper — Utilities for the Python execution tests
- 调试和分析
- bdb — Debugger framework
- faulthandler — Dump the Python traceback
- pdb — The Python Debugger
- The Python Profilers
- timeit — 测量小代码片段的执行时间
- trace — Trace or track Python statement execution
- tracemalloc — Trace memory allocations
- 软件打包和分发
- distutils — 构建和安装 Python 模块
- ensurepip — Bootstrapping the pip installer
- venv — 创建虚拟环境
- zipapp — Manage executable Python zip archives
- Python运行时服务
- sys — 系统相关的参数和函数
- sysconfig — Provide access to Python's configuration information
- builtins — 内建对象
- main — 顶层脚本环境
- warnings — Warning control
- dataclasses — 数据类
- contextlib — Utilities for with-statement contexts
- abc — 抽象基类
- atexit — 退出处理器
- traceback — Print or retrieve a stack traceback
- future — Future 语句定义
- gc — 垃圾回收器接口
- inspect — 检查对象
- site — Site-specific configuration hook
- 自定义 Python 解释器
- code — Interpreter base classes
- codeop — Compile Python code
- 导入模块
- zipimport — Import modules from Zip archives
- pkgutil — Package extension utility
- modulefinder — 查找脚本使用的模块
- runpy — Locating and executing Python modules
- importlib — The implementation of import
- Python 语言服务
- parser — Access Python parse trees
- ast — 抽象语法树
- symtable — Access to the compiler's symbol tables
- symbol — 与 Python 解析树一起使用的常量
- token — 与Python解析树一起使用的常量
- keyword — 检验Python关键字
- tokenize — Tokenizer for Python source
- tabnanny — 模糊缩进检测
- pyclbr — Python class browser support
- py_compile — Compile Python source files
- compileall — Byte-compile Python libraries
- dis — Python 字节码反汇编器
- pickletools — Tools for pickle developers
- 杂项服务
- formatter — Generic output formatting
- Windows系统相关模块
- msilib — Read and write Microsoft Installer files
- msvcrt — Useful routines from the MS VC++ runtime
- winreg — Windows 注册表访问
- winsound — Sound-playing interface for Windows
- Unix 专有服务
- posix — The most common POSIX system calls
- pwd — 用户密码数据库
- spwd — The shadow password database
- grp — The group database
- crypt — Function to check Unix passwords
- termios — POSIX style tty control
- tty — 终端控制功能
- pty — Pseudo-terminal utilities
- fcntl — The fcntl and ioctl system calls
- pipes — Interface to shell pipelines
- resource — Resource usage information
- nis — Interface to Sun's NIS (Yellow Pages)
- Unix syslog 库例程
- 被取代的模块
- optparse — Parser for command line options
- imp — Access the import internals
- 未创建文档的模块
- 平台特定模块
- 扩展和嵌入 Python 解释器
- 推荐的第三方工具
- 不使用第三方工具创建扩展
- 使用 C 或 C++ 扩展 Python
- 自定义扩展类型:教程
- 定义扩展类型:已分类主题
- 构建C/C++扩展
- 在Windows平台编译C和C++扩展
- 在更大的应用程序中嵌入 CPython 运行时
- Embedding Python in Another Application
- Python/C API 参考手册
- 概述
- 代码标准
- 包含文件
- 有用的宏
- 对象、类型和引用计数
- 异常
- 嵌入Python
- 调试构建
- 稳定的应用程序二进制接口
- The Very High Level Layer
- Reference Counting
- 异常处理
- Printing and clearing
- 抛出异常
- Issuing warnings
- Querying the error indicator
- Signal Handling
- Exception Classes
- Exception Objects
- Unicode Exception Objects
- Recursion Control
- 标准异常
- 标准警告类别
- 工具
- 操作系统实用程序
- 系统功能
- 过程控制
- 导入模块
- Data marshalling support
- 语句解释及变量编译
- 字符串转换与格式化
- 反射
- 编解码器注册与支持功能
- 抽象对象层
- Object Protocol
- 数字协议
- Sequence Protocol
- Mapping Protocol
- 迭代器协议
- 缓冲协议
- Old Buffer Protocol
- 具体的对象层
- 基本对象
- 数值对象
- 序列对象
- 容器对象
- 函数对象
- 其他对象
- Initialization, Finalization, and Threads
- 在Python初始化之前
- 全局配置变量
- Initializing and finalizing the interpreter
- Process-wide parameters
- Thread State and the Global Interpreter Lock
- Sub-interpreter support
- Asynchronous Notifications
- Profiling and Tracing
- Advanced Debugger Support
- Thread Local Storage Support
- 内存管理
- 概述
- 原始内存接口
- Memory Interface
- 对象分配器
- 默认内存分配器
- Customize Memory Allocators
- The pymalloc allocator
- tracemalloc C API
- 示例
- 对象实现支持
- 在堆中分配对象
- Common Object Structures
- Type 对象
- Number Object Structures
- Mapping Object Structures
- Sequence Object Structures
- Buffer Object Structures
- Async Object Structures
- 使对象类型支持循环垃圾回收
- API 和 ABI 版本管理
- 分发 Python 模块
- 关键术语
- 开源许可与协作
- 安装工具
- 阅读指南
- 我该如何...?
- ...为我的项目选择一个名字?
- ...创建和分发二进制扩展?
- 安装 Python 模块
- 关键术语
- 基本使用
- 我应如何 ...?
- ... 在 Python 3.4 之前的 Python 版本中安装 pip ?
- ... 只为当前用户安装软件包?
- ... 安装科学计算类 Python 软件包?
- ... 使用并行安装的多个 Python 版本?
- 常见的安装问题
- 在 Linux 的系统 Python 版本上安装
- 未安装 pip
- 安装二进制编译扩展
- Python 常用指引
- 将 Python 2 代码迁移到 Python 3
- 简要说明
- 详情
- 将扩展模块移植到 Python 3
- 条件编译
- 对象API的更改
- 模块初始化和状态
- CObject 替换为 Capsule
- 其他选项
- Curses Programming with Python
- What is curses?
- Starting and ending a curses application
- Windows and Pads
- Displaying Text
- User Input
- For More Information
- 实现描述器
- 摘要
- 定义和简介
- 描述器协议
- 发起调用描述符
- 描述符示例
- Properties
- 函数和方法
- Static Methods and Class Methods
- 函数式编程指引
- 概述
- 迭代器
- 生成器表达式和列表推导式
- 生成器
- 内置函数
- itertools 模块
- The functools module
- Small functions and the lambda expression
- Revision History and Acknowledgements
- 引用文献
- 日志 HOWTO
- 日志基础教程
- 进阶日志教程
- 日志级别
- 有用的处理程序
- 记录日志中引发的异常
- 使用任意对象作为消息
- 优化
- 日志操作手册
- 在多个模块中使用日志
- 在多线程中使用日志
- 使用多个日志处理器和多种格式化
- 在多个地方记录日志
- 日志服务器配置示例
- 处理日志处理器的阻塞
- Sending and receiving logging events across a network
- Adding contextual information to your logging output
- Logging to a single file from multiple processes
- Using file rotation
- Use of alternative formatting styles
- Customizing LogRecord
- Subclassing QueueHandler - a ZeroMQ example
- Subclassing QueueListener - a ZeroMQ example
- An example dictionary-based configuration
- Using a rotator and namer to customize log rotation processing
- A more elaborate multiprocessing example
- Inserting a BOM into messages sent to a SysLogHandler
- Implementing structured logging
- Customizing handlers with dictConfig()
- Using particular formatting styles throughout your application
- Configuring filters with dictConfig()
- Customized exception formatting
- Speaking logging messages
- Buffering logging messages and outputting them conditionally
- Formatting times using UTC (GMT) via configuration
- Using a context manager for selective logging
- 正则表达式HOWTO
- 概述
- 简单模式
- 使用正则表达式
- 更多模式能力
- 修改字符串
- 常见问题
- 反馈
- 套接字编程指南
- 套接字
- 创建套接字
- 使用一个套接字
- 断开连接
- 非阻塞的套接字
- 排序指南
- 基本排序
- 关键函数
- Operator 模块函数
- 升序和降序
- 排序稳定性和排序复杂度
- 使用装饰-排序-去装饰的旧方法
- 使用 cmp 参数的旧方法
- 其它
- Unicode 指南
- Unicode 概述
- Python's Unicode Support
- Reading and Writing Unicode Data
- Acknowledgements
- 如何使用urllib包获取网络资源
- 概述
- Fetching URLs
- 处理异常
- info and geturl
- Openers and Handlers
- Basic Authentication
- Proxies
- Sockets and Layers
- 脚注
- Argparse 教程
- 概念
- 基础
- 位置参数介绍
- Introducing Optional arguments
- Combining Positional and Optional arguments
- Getting a little more advanced
- Conclusion
- ipaddress模块介绍
- 创建 Address/Network/Interface 对象
- 审查 Address/Network/Interface 对象
- Network 作为 Address 列表
- 比较
- 将IP地址与其他模块一起使用
- 实例创建失败时获取更多详细信息
- Argument Clinic How-To
- The Goals Of Argument Clinic
- Basic Concepts And Usage
- Converting Your First Function
- Advanced Topics
- 使用 DTrace 和 SystemTap 检测CPython
- Enabling the static markers
- Static DTrace probes
- Static SystemTap markers
- Available static markers
- SystemTap Tapsets
- 示例
- Python 常见问题
- Python常见问题
- 一般信息
- 现实世界中的 Python
- 编程常见问题
- 一般问题
- 核心语言
- 数字和字符串
- 性能
- 序列(元组/列表)
- 对象
- 模块
- 设计和历史常见问题
- 为什么Python使用缩进来分组语句?
- 为什么简单的算术运算得到奇怪的结果?
- 为什么浮点计算不准确?
- 为什么Python字符串是不可变的?
- 为什么必须在方法定义和调用中显式使用“self”?
- 为什么不能在表达式中赋值?
- 为什么Python对某些功能(例如list.index())使用方法来实现,而其他功能(例如len(List))使用函数实现?
- 为什么 join()是一个字符串方法而不是列表或元组方法?
- 异常有多快?
- 为什么Python中没有switch或case语句?
- 难道不能在解释器中模拟线程,而非得依赖特定于操作系统的线程实现吗?
- 为什么lambda表达式不能包含语句?
- 可以将Python编译为机器代码,C或其他语言吗?
- Python如何管理内存?
- 为什么CPython不使用更传统的垃圾回收方案?
- CPython退出时为什么不释放所有内存?
- 为什么有单独的元组和列表数据类型?
- 列表是如何在CPython中实现的?
- 字典是如何在CPython中实现的?
- 为什么字典key必须是不可变的?
- 为什么 list.sort() 没有返回排序列表?
- 如何在Python中指定和实施接口规范?
- 为什么没有goto?
- 为什么原始字符串(r-strings)不能以反斜杠结尾?
- 为什么Python没有属性赋值的“with”语句?
- 为什么 if/while/def/class语句需要冒号?
- 为什么Python在列表和元组的末尾允许使用逗号?
- 代码库和插件 FAQ
- 通用的代码库问题
- 通用任务
- 线程相关
- 输入输出
- 网络 / Internet 编程
- 数据库
- 数学和数字
- 扩展/嵌入常见问题
- 可以使用C语言中创建自己的函数吗?
- 可以使用C++语言中创建自己的函数吗?
- C很难写,有没有其他选择?
- 如何从C执行任意Python语句?
- 如何从C中评估任意Python表达式?
- 如何从Python对象中提取C的值?
- 如何使用Py_BuildValue()创建任意长度的元组?
- 如何从C调用对象的方法?
- 如何捕获PyErr_Print()(或打印到stdout / stderr的任何内容)的输出?
- 如何从C访问用Python编写的模块?
- 如何从Python接口到C ++对象?
- 我使用Setup文件添加了一个模块,为什么make失败了?
- 如何调试扩展?
- 我想在Linux系统上编译一个Python模块,但是缺少一些文件。为什么?
- 如何区分“输入不完整”和“输入无效”?
- 如何找到未定义的g++符号__builtin_new或__pure_virtual?
- 能否创建一个对象类,其中部分方法在C中实现,而其他方法在Python中实现(例如通过继承)?
- Python在Windows上的常见问题
- 我怎样在Windows下运行一个Python程序?
- 我怎么让 Python 脚本可执行?
- 为什么有时候 Python 程序会启动缓慢?
- 我怎样使用Python脚本制作可执行文件?
- *.pyd 文件和DLL文件相同吗?
- 我怎样将Python嵌入一个Windows程序?
- 如何让编辑器不要在我的 Python 源代码中插入 tab ?
- 如何在不阻塞的情况下检查按键?
- 图形用户界面(GUI)常见问题
- 图形界面常见问题
- Python 是否有平台无关的图形界面工具包?
- 有哪些Python的GUI工具是某个平台专用的?
- 有关Tkinter的问题
- “为什么我的电脑上安装了 Python ?”
- 什么是Python?
- 为什么我的电脑上安装了 Python ?
- 我能删除 Python 吗?
- 术语对照表
- 文档说明
- Python 文档贡献者
- 解决 Bug
- 文档错误
- 使用 Python 的错误追踪系统
- 开始为 Python 贡献您的知识
- 版权
- 历史和许可证
- 软件历史
- 访问Python或以其他方式使用Python的条款和条件
- Python 3.7.3 的 PSF 许可协议
- Python 2.0 的 BeOpen.com 许可协议
- Python 1.6.1 的 CNRI 许可协议
- Python 0.9.0 至 1.2 的 CWI 许可协议
- 集成软件的许可和认可
- Mersenne Twister
- 套接字
- Asynchronous socket services
- Cookie management
- Execution tracing
- UUencode and UUdecode functions
- XML Remote Procedure Calls
- test_epoll
- Select kqueue
- SipHash24
- strtod and dtoa
- OpenSSL
- expat
- libffi
- zlib
- cfuhash
- libmpdec