numpy的c源代码中如何使用at符号（@）？

Question

我一直在阅读一些 numpy 的源代码，我注意到很多 c 源代码都使用@variablename@ 的构造。例如，在文件“npy_math_complex.c.src”（位于here）中：

/*==========================================================
* Constants
*=========================================================*/
static const @ctype@ c_1@c@ = {1.0@C@, 0.0};
static const @ctype@ c_half@c@ = {0.5@C@, 0.0};
static const @ctype@ c_i@c@ = {0.0, 1.0@C@};
static const @ctype@ c_ihalf@c@ = {0.0, 0.5@C@};

@ctype@ 和 @c@ 是什么意思？这些是某种宏吗？我猜它们不是普通的 C 宏，因为我查看了文件中列出的相关头文件，它们似乎没有使用“@”定义任何宏。

@name@ 是 distutils 在将 c 代码编译成 python 模块时使用的某种宏吗？

我以前从未在 c 代码中看到过 @ 符号，所以我有点困惑......

Answer 1

这是因为这些文件是模板。如果我没记错的话，NumPy 使用了多个模板引擎（感谢 @user2357112 帮助我找到合适的引擎）：

• tempita (for Cython files)
• another one for C files
• another one for FORTRAN files

第二个实际上负责将这些转换为“常规”C 文件 - 在编译之前。

基本上，这些函数会被克隆很多次，并且对于每个函数，都会在 % 之间插入一个特殊的占位符。

例如in this case it begins with:

/**begin repeat
 * #type = npy_float, npy_double, npy_longdouble#
 * #ctype = npy_cfloat,npy_cdouble,npy_clongdouble#
 * #c = f, , l#
 * #C = F, , L#
 * ....
 */

所以在第一次迭代中，@ctype@ 将替换为 npy_cfloat，@c@ 替换为 f，@C@ 替换为 F：

static const npy_cfloat c_1f = {1.0F, 0.0};
static const npy_cfloat c_halff = {0.5F, 0.0};
static const npy_cfloat c_if = {0.0, 1.0F};
static const npy_cfloat c_ihalff = {0.0, 0.5F};

在下一次迭代中是@ctype@ npy_cdouble, ...

static const npy_cdouble c_1 = {1.0, 0.0};
static const npy_cdouble c_half = {0.5, 0.0};
static const npy_cdouble c_i = {0.0, 1.0};
static const npy_cdouble c_ihalf = {0.0, 0.5};

在第三次迭代中：

static const npy_clongdouble c_1l = {1.0L, 0.0};
static const npy_clongdouble c_halfl = {0.5L, 0.0};
static const npy_clongdouble c_il = {0.0, 1.0L};
static const npy_clongdouble c_ihalfl = {0.0, 0.5L};

然后将它们编译为普通的 C 文件。