文件对象¶
这些 API 是对 Python 2 C API 中内置文件对象的最小模拟，该 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 流有自己的缓冲层，将其与 OS 级文件描述符混合使用可能会产生各种问题（例如数据顺序意外）。
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*)¶