文件对象¶
这些 API 是对 Python 2 C API 中内置文件对象的最小化模拟，这些文件对象过去依赖于 C 标准库的缓冲 I/O (FILE*) 支持。在 Python 3 中，文件和流使用新的 io 模块，该模块定义了操作系统底层无缓冲 I/O 的多个层。下面描述的函数是这些新 API 的便捷 C 包装器，主要用于解释器中的内部错误报告；建议第三方代码访问 io API。
-
PyObject *PyFile_FromFd(int fd, const char *name, const char *mode, int buffering, const char *encoding, const char *errors, const char *newline, int closefd)¶
- 返回值：新引用。属于 稳定 ABI 的一部分。
从已打开的文件 fd 的文件描述符创建一个 Python 文件对象。参数 name、encoding、errors 和 newline 可以是
NULL以使用默认值；buffering 可以是 -1 以使用默认值。name 被忽略并保留以实现向后兼容性。失败时返回NULL。有关参数的更全面描述，请参阅io.open()函数文档。警告
由于 Python 流有自己的缓冲层，将它们与操作系统级文件描述符混合使用可能会产生各种问题（例如意外的数据排序）。
在 3.2 版本中更改: 忽略 name 属性。
-
int PyObject_AsFileDescriptor(PyObject *p)¶
- 属于 稳定 ABI 的一部分。
将与 p 关联的文件描述符作为 int 返回。如果对象是一个整数，则返回其值。如果不是，则调用该对象的
fileno()方法（如果存在）；该方法必须返回一个整数，该整数将作为文件描述符值返回。如果失败，则设置异常并返回-1。
-
PyObject *PyFile_GetLine(PyObject *p, int n)¶
- 返回值：新引用。属于 稳定 ABI 的一部分。
等效于
p.readline([n])，此函数从对象 p 读取一行。p 可以是一个文件对象或任何具有readline()方法的对象。如果 n 是0，则无论该行的长度如何，都将精确读取一行。如果 n 大于0，则从文件中读取的字节数不会超过 n；可能会返回部分行。在这两种情况下，如果立即到达文件末尾，则返回一个空字符串。但是，如果 n 小于0，则无论长度如何都读取一行，但如果立即到达文件末尾，则会引发EOFError。
-
int PyFile_SetOpenCodeHook(Py_OpenCodeHookFunction handler)¶
覆盖
io.open_code()的正常行为，以将其参数传递给提供的处理程序。handler 是以下类型的函数
-
typedef PyObject *(*Py_OpenCodeHookFunction)(PyObject*, void*)¶
等效于 PyObject *(*)(PyObject *path, void *userData)，其中 path 保证为
PyUnicodeObject。
userData 指针被传递到钩子函数中。由于钩子函数可能会从不同的运行时调用，因此此指针不应直接引用 Python 状态。
由于此钩子在导入期间被有意使用，因此请避免在其执行期间导入新模块，除非已知它们被冻结或在
sys.modules中可用。设置钩子后，将无法删除或替换它，并且以后对
PyFile_SetOpenCodeHook()的调用将失败。如果失败，则该函数返回 -1，并在解释器已初始化时设置一个异常。此函数可以在
Py_Initialize()之前安全地调用。引发 审计事件
setopencodehook，不带任何参数。在 3.8 版本中添加。
-
typedef PyObject *(*Py_OpenCodeHookFunction)(PyObject*, void*)¶