c++ - "%include"和 "#include"之间的区别

Question

在 SWIG 中，“%include”指令与标准 C“#include”有什么区别？

例如，在所有教程中，为什么它们通常看起来像这样:

%module my_module

%{
#include "MyHeader.h"
%}

%include "MyHeader.h"

这对我来说似乎是多余的。也许有知识的人可以澄清一下。

是否有包含 C++ 代码的首选方法？

Answer 1

%{ ... %}里面的东西直接传到输出；它本身并不由 SWIG 解释。所以 #include 是为了确保生成的 C/C++ 代码包含该 header 。

相比之下，

%include 是一个 SWIG 指令。它告诉 SWIG 在继续之前处理该头文件。这样 SWIG 将了解(并为其生成包装器)在该头文件中声明的类型和函数。

如果 header 非常复杂，它可能会混淆 SWIG 或导致非常大的输出(因为 SWIG 尝试为其中的所有内容生成包装器)。在这种情况下，最好只手动声明需要 SWIG 处理的 header 部分，并省略 %include。但是您仍然可能需要 #include 以编译生成的 C++。

[更新]

至于“首选”，SWIG 更多的是关于什么是有效的，而不是什么是“首选”......如果你有一个非常干净的头文件为单个类声明一个很好的接口(interface)，你可以只 %include 它并让 SWIG 自动生成包装器。如果您的头文件非常复杂(例如 iostream)，您应该手动告诉 SWIG 要包装什么。但没有硬性规定。