python - Python C API 中的 PyCompilerFlags 是什么？

Question

如果您检查了 Python C-API documentation关于通过 C 调用运行 python 代码，您总是会发现提到了 PyCompilerFlags，但除了文档的最后一部分之外，没有任何内容真正描述它是什么，也没有说明它的可能值及其对执行的影响。

Answer 1

PyCompilerFlags 是 C API，相当于传递给 compile 和 Python 中相关函数的 flags 参数。如果您在查看 CPython C-API 文档之前还不了解 Python 文档，那么这可能一点都不明显。

来自 compile :

The optional arguments flags and dont_inherit control which future statements affect the compilation of source. If neither is present (or both are zero) the code is compiled with those future statements that are in effect in the code that is calling compile(). If the flags argument is given and dont_inherit is not (or is zero) then the future statements specified by the flags argument are used in addition to those that would be used anyway. If dont_inherit is a non-zero integer then the flags argument is it – the future statements in effect around the call to compile are ignored.

Future statements are specified by bits which can be bitwise ORed together to specify multiple statements. The bitfield required to specify a given feature can be found as the compiler_flag attribute on the _Feature instance in the __future__ module.

点击链接到 future statements提供了有关它们如何工作的更多详细信息，以及指向 __future__ 的链接有一个图表显示可用的 future 报表列表。

---

另一件可能不明显的事情:每个 future 的功能标志对应于一个标志，该标志最终出现在 code 对象的 co_flags 属性中。所以:

code = compile('1 <> 2', '', 'eval', flags=__future__.barry_as_FLUFL.compiler_flag)
assert code.co_flags & CO_FUTURE_BARRY_AS_BDFL

在 C 中，如果您传递 struct PyCompilerFlags flags = { CO_FUTURE_BARRY_AS_BDFL } 以获得相同的效果。

如果您想查看这些标志的实际数值，您必须查找相应的 CO_* C 源代码或 __future__ 中的常量来源。

---

C API 在某些方面略有不同。

• 而不是同时传递 flags 和 dont_inherit，您只传递 flags，它是您想要的所有 future 语句的完整集合在 PyRun_* 或 PyCompile_* 调用期间生效。
• 大多数函数采用 PyCompile_Flags 结构来保存一个 int，而不是原始 int。这只是为了类型检查的目的；在内存中，保存 int 的结构的存储方式与 int 相同。
• 许多函数通过指针获取它们的标志，因此您可以在运行代码后检索可能更新的标志集。

---

让我们看一个完整的例子。我将使用 Python 2.7，即使我已经链接到 3.7 文档，只是因为使用 print 的示例比使用前向注释的示例更简单。

此代码打印一个空元组:

print()

但如果您使用 PyRun_SimpleStringFlags 运行第一个，将 CO_FUTURE_PRINT_FUNCTION (0x10000) 作为 flags` 传递，它将打印一个空行，一个 Python 3。

如果你运行这段代码:

from __future__ import print_function
print()

…那么无论你传入0还是CO_FUTURE_PRINT_FUNCTION，它都会打印一个空行。在调用之后，如果您查看通过引用传入的 flags，它将具有 CO_FUTURE_PRINT_FUNCTION 或放在上面。因此，如果您一次编译和运行一个 block ，您可以将相同的值传递给下一个字符串，它将继承该 future 标志。 (很像当你在交互式解释器中写一个 future 语句时，它会影响你之后解释的所有语句。)