如何为C编写可内联的C++函数包装器？（静态库场景）

我想要为C编写可供C调用的内联函数包装器。网上的方案均指出，库中的内联函数需将定义放在头文件中，但由于包装器包含仅能通过C编译的代码，该方案无法直接适用。以下为场景示例代码：

// box_c.cpp
#include "box.h"

extern "C" Square *new_Square(int width, int height){
    return new Square(width, height);
}

// box_c.h
void *new_Square(int width, int height);

// main.c
#include "box_c.h"

int main(void){
    void *s = new_Square(5, 5);
}

请问在此静态库包装器的场景下，能否将new_Square设置为内联函数？

不能直接将这个new_Square设为可被C代码调用的内联函数，核心限制和可行替代方案如下：

核心限制 #

1. 内联头文件要求与C编译的冲突：
   内联函数需要把定义放在头文件中，才能让编译器在调用点展开代码。但你的new_Square内部包含C专属语法（new Square、返回Square*类指针），C编译器处理头文件时会直接报错——C语言不支持类、new运算符这些C特性。

2. extern "C"与内联的兼容性问题：
   即使在C代码中标记inline extern "C"，当C代码包含头文件时，C编译器无法识别extern "C"（这是C专属语法），且C标准中的inline规则与C++存在差异，无法直接兼容这种跨语言的内联声明。

可行替代方案 #

方案1：区分C/C++环境的双版本实现 #

通过条件编译，让C++调用者使用内联版本获得性能，C调用者使用静态库中的非内联桥接函数：

修改box_c.h：

#ifdef __cplusplus
extern "C" {
#endif

#ifdef __cplusplus
// C++环境下直接提供内联包装函数
inline Square* new_Square(int width, int height) {
    return new Square(width, height);
}
// 给C环境声明桥接函数
void* new_Square_c(int width, int height);
#else
// C环境下映射到桥接函数
#define new_Square new_Square_c
void* new_Square_c(int width, int height);
#endif

#ifdef __cplusplus
}
#endif

在box_c.cpp中实现C桥接函数：

#include "box_c.h"
#include "box.h"

extern "C" void* new_Square_c(int width, int height) {
    return new Square(width, height);
}

这种方式下，C++代码调用new_Square会直接内联展开，C代码通过宏映射调用静态库中的非内联函数，既满足性能需求，又避免跨编译报错。

方案2：不推荐的宏封装（慎用） #

如果强行要让C++环境下的调用获得内联效果，可以将逻辑用宏封装，但这种方式完全不做类型检查，极易引发bug，仅作为极端场景的备选：

// box_c.h
#ifdef __cplusplus
#define new_Square(w, h) (static_cast<void*>(new Square(w, h)))
#else
// C环境下仍需调用静态库函数
void* new_Square(int width, int height);
#endif

注意：该方式仅能在C++编译环境下使用宏展开，C代码依旧只能调用非内联函数，且宏的安全性极低，不建议在生产代码中使用。

内容的提问来源于stack exchange，提问作者user20300474