非常高级的层 — Python 文档

非常高级的层

本章中的函数将允许您执行文件或缓冲区中给出的 Python 源代码，但它们不会让您以更详细的方式与解释器进行交互。

其中一些函数接受语法中的开始符号作为参数。 可用的起始符号为 Py_eval_input、Py_file_input 和 Py_single_input。 这些在接受它们作为参数的函数之后进行描述。

另请注意，其中一些函数采用 FILE* 参数。 需要小心处理的一个特殊问题是不同 C 库的 FILE 结构可能不同且不兼容。 在 Windows 下（至少），动态链接的扩展实际上可以使用不同的库，因此应注意 FILE* 参数仅在确定它们是由相同的函数创建时才传递给这些函数Python 运行时正在使用的库。

int Py_Main(int argc, char **argv)

标准解释器的主程序。 这可用于嵌入 Python 的程序。 argc 和 argv 参数应与传递给 C 程序的 main() 函数的参数完全相同。 需要注意的是，参数列表可能会被修改（但参数列表指向的字符串的内容不会）。 解释器正常退出（即无异常）返回值为0，异常退出返回值为1，参数列表为2不代表有效的 Python 命令行。

请注意，如果引发了其他未处理的 SystemExit，只要未设置 Py_InspectFlag，该函数将不会返回 1，而是退出进程。

int PyRun_AnyFile(FILE *fp, const char *filename)

这是下面 PyRun_AnyFileExFlags() 的简化接口，将 closeit 设置为 0 并将 flags 设置为 NULL .

int PyRun_AnyFileFlags(FILE *fp, const char *filename, PyCompilerFlags *flags)

这是下面 PyRun_AnyFileExFlags() 的简化接口，将 closeit 参数设置为 0。

int PyRun_AnyFileEx(FILE *fp, const char *filename, int closeit)

这是下面 PyRun_AnyFileExFlags() 的简化接口，将 flags 参数设置为 NULL。

int PyRun_AnyFileExFlags(FILE *fp, const char *filename, int closeit, PyCompilerFlags *flags)

如果 fp 引用与交互设备（控制台或终端输入或 Unix 伪终端）关联的文件，则返回 PyRun_InteractiveLoop() 的值，否则返回 的结果]PyRun_SimpleFile()。 如果 filename 是 NULL，该函数使用 "???" 作为文件名。

int PyRun_SimpleString(const char *command)

这是下面 PyRun_SimpleStringFlags() 的简化接口，将 PyCompilerFlags* 参数设置为 NULL。

int PyRun_SimpleStringFlags(const char *command, PyCompilerFlags *flags)

根据 flags 参数从 __main__ 模块中的 command 执行 Python 源代码。 如果 __main__ 不存在，则创建它。 成功时返回 0，如果引发异常则返回 -1。 如果出现错误，则无法获取异常信息。 flags的含义见下文。

请注意，如果引发了其他未处理的 SystemExit，只要未设置 Py_InspectFlag，该函数将不会返回 -1，而是退出进程。

int PyRun_SimpleFile(FILE *fp, const char *filename)

这是下面 PyRun_SimpleFileExFlags() 的简化接口，将 closeit 设置为 0 并将 flags 设置为 NULL .

int PyRun_SimpleFileFlags(FILE *fp, const char *filename, PyCompilerFlags *flags)

这是下面 PyRun_SimpleFileExFlags() 的简化接口，将 closeit 设置为 0。

int PyRun_SimpleFileEx(FILE *fp, const char *filename, int closeit)

这是下面 PyRun_SimpleFileExFlags() 的简化接口，将 flags 设置为 NULL。

int PyRun_SimpleFileExFlags(FILE *fp, const char *filename, int closeit, PyCompilerFlags *flags)

与 PyRun_SimpleStringFlags() 类似，但 Python 源代码是从 fp 而不是内存中的字符串读取的。 filename 应该是文件名。 如果 closeit 为真，则在 PyRun_SimpleFileExFlags 返回之前关闭文件。

int PyRun_InteractiveOne(FILE *fp, const char *filename)

这是下面 PyRun_InteractiveOneFlags() 的简化接口，将 flags 设置为 NULL。

int PyRun_InteractiveOneFlags(FILE *fp, const char *filename, PyCompilerFlags *flags)

根据 flags 参数从与交互设备关联的文件中读取并执行单个语句。 将使用 sys.ps1 和 sys.ps2 提示用户。 成功执行输入时返回 0，如果有异常则返回 -1，如果有解析，则返回作为 Python 一部分分发的 errcode.h 包含文件中的错误代码错误。 （注意 errcode.h 不包含在 Python.h 中，因此如果需要，必须特别包含。）

int PyRun_InteractiveLoop(FILE *fp, const char *filename)

这是下面 PyRun_InteractiveLoopFlags() 的简化接口，将 flags 设置为 NULL。

int PyRun_InteractiveLoopFlags(FILE *fp, const char *filename, PyCompilerFlags *flags)

从与交互式设备关联的文件中读取和执行语句，直到达到 EOF。 将使用 sys.ps1 和 sys.ps2 提示用户。 在 EOF 处返回 0。

struct _node *PyParser_SimpleParseString(const char *str, int start)

这是下面 PyParser_SimpleParseStringFlagsFilename() 的简化接口，将 filename 设置为 NULL 并将 flags 设置为 .

struct _node *PyParser_SimpleParseStringFlags(const char *str, int start, int flags)

这是下面 PyParser_SimpleParseStringFlagsFilename() 的简化接口，将 filename 设置为 NULL。

struct _node *PyParser_SimpleParseStringFlagsFilename(const char *str, const char *filename, int start, int flags)

根据 flags 参数，使用开始标记 start 从 str 解析 Python 源代码。 结果可用于创建可有效评估的代码对象。 如果必须多次评估代码片段，这将非常有用。

struct _node *PyParser_SimpleParseFile(FILE *fp, const char *filename, int start)

这是下面 PyParser_SimpleParseFileFlags() 的简化接口，将 flags 设置为 0。

struct _node *PyParser_SimpleParseFileFlags(FILE *fp, const char *filename, int start, int flags)

类似于 PyParser_SimpleParseStringFlagsFilename()，但 Python 源代码是从 fp 读取的，而不是从内存中的字符串读取。

PyObject *PyRun_String(const char *str, int start, PyObject *globals, PyObject *locals)

这是下面 PyRun_StringFlags() 的简化接口，将 flags 设置为 NULL。

PyObject *PyRun_StringFlags(const char *str, int start, PyObject *globals, PyObject *locals, PyCompilerFlags *flags)

在字典 globals 和 locals 指定的上下文中，使用 flags 指定的编译器标志从 str 执行 Python 源代码。 参数 start 指定应该用于解析源代码的开始标记。

返回作为 Python 对象执行代码的结果，如果引发异常，则返回 NULL。

PyObject *PyRun_File(FILE *fp, const char *filename, int start, PyObject *globals, PyObject *locals)

这是下面 PyRun_FileExFlags() 的简化接口，将 closeit 设置为 0 并将 flags 设置为 NULL .

PyObject *PyRun_FileEx(FILE *fp, const char *filename, int start, PyObject *globals, PyObject *locals, int closeit)

这是下面 PyRun_FileExFlags() 的简化接口，将 flags 设置为 NULL。

PyObject *PyRun_FileFlags(FILE *fp, const char *filename, int start, PyObject *globals, PyObject *locals, PyCompilerFlags *flags)

这是下面 PyRun_FileExFlags() 的简化接口，将 closeit 设置为 0。

PyObject *PyRun_FileExFlags(FILE *fp, const char *filename, int start, PyObject *globals, PyObject *locals, int closeit, PyCompilerFlags *flags)

与 PyRun_StringFlags() 类似，但 Python 源代码是从 fp 而不是内存字符串读取的。 filename 应该是文件名。 如果 closeit 为真，则文件在 PyRun_FileExFlags() 返回之前关闭。

PyObject *Py_CompileString(const char *str, const char *filename, int start)

这是下面 Py_CompileStringFlags() 的简化接口，将 flags 设置为 NULL。

PyObject *Py_CompileStringFlags(const char *str, const char *filename, int start, PyCompilerFlags *flags)

解析并编译 str 中的 Python 源代码，返回生成的代码对象。 起始令牌由 start 给出； 这可以用来约束可以编译的代码，应该是 Py_eval_input、Py_file_input 或 Py_single_input。 filename 指定的文件名用于构造代码对象，并且可能出现在回溯或 SyntaxError 异常消息中。 如果无法解析或编译代码，则返回 NULL。

PyObject *PyEval_EvalCode(PyCodeObject *co, PyObject *globals, PyObject *locals)

这是 PyEval_EvalCodeEx() 的简化接口，只有代码对象，以及全局和局部变量的字典。 其他参数设置为 NULL。

PyObject *PyEval_EvalCodeEx(PyCodeObject *co, PyObject *globals, PyObject *locals, PyObject **args, int argcount, PyObject **kws, int kwcount, PyObject **defs, int defcount, PyObject *closure)

评估一个预编译的代码对象，给定一个特定的评估环境。 该环境由全局和局部变量的字典、参数数组、关键字和默认值以及单元的闭包元组组成。

PyObject *PyEval_EvalFrame(PyFrameObject *f)

评估一个执行框架。 这是 PyEval_EvalFrameEx 的简化接口，用于向后兼容。

PyObject *PyEval_EvalFrameEx(PyFrameObject *f, int throwflag)

这是 Python 解释的主要、未修饰的功能。 它实际上有 2000 行长。 与执行帧 f 关联的代码对象被执行，根据需要解释字节码并执行调用。 附加的 throwflag 参数通常可以忽略 - 如果为真，则它会立即引发异常； 这用于生成器对象的 throw() 方法。

int PyEval_MergeCompilerFlags(PyCompilerFlags *cf)

此函数更改当前评估帧的标志，成功时返回 true，失败时返回 false。

int Py_eval_input

孤立表达式的 Python 语法中的起始符号； 与 Py_CompileString() 一起使用。

int Py_file_input

从文件或其他来源读取的语句序列的 Python 语法中的开始符号； 与 Py_CompileString() 一起使用。 这是编译任意长的 Python 源代码时使用的符号。

int Py_single_input

单个语句的 Python 语法中的开始符号； 与 Py_CompileString() 一起使用。 这是用于交互式解释器循环的符号。

struct PyCompilerFlags

这是用于保存编译器标志的结构。 在代码只被编译的情况下，作为int flags传递，在代码正在执行的情况下，作为PyCompilerFlags *flags传递。 在这种情况下，from __future__ import 可以修改 flags。

当 PyCompilerFlags *flags 为 NULL 时，cf_flags 被视为等于 0，并且由于 from __future__ import 引起的任何修改都将被丢弃。

struct PyCompilerFlags {
    int cf_flags;
}

int CO_FUTURE_DIVISION

根据 PEP 238，可以在 flags 中设置该位，使除法运算符 / 被解释为“真正除法”。