如何将LLVM IR中定义的函数暴露给Clang并在C++中调用？

当然有靠谱的实现方式！核心要点就是让LLVM IR的函数签名和C++的函数声明严格遵循相同的ABI（应用二进制接口），这样Clang就能正确生成调用代码，LLVM也能正确处理参数传递和返回值。针对你举的divrem例子，我给你拆解具体的实现步骤：

1. 对齐LLVM IR与C++的类型映射 #

你提到的LLVM IR中的{i64, i64}结构体，和C++里的struct ret { long div, rem; };是天然匹配的——在绝大多数64位平台上，long类型的长度就是64位，正好对应LLVM的i64类型。只要保持这种类型对应关系，参数和返回值的传递就能符合平台ABI要求。

2. 正确编写C++的外部函数声明 #

你写的extern "LLVM IR"是无效的语法，我们需要用extern "C"来指定C语言链接约定——这能避免C的名字修饰（name mangling）问题，让Clang生成的代码直接查找divrem这个原始符号，和LLVM IR中的函数名保持一致。修正后的C声明应该是：

struct ret { long div, rem; };
// 用extern "C"避免名字修饰，确保符号匹配
extern "C" ret divrem(long a, long b);

// 调用示例
int main() {
    auto dr = divrem(30, 11);
    // 输出应该是div=2，rem=8
    return 0;
}

3. 实现或声明LLVM IR函数 #

如果只是声明函数（像你例子里的declare），那你需要确保最终链接时能找到该函数的定义。如果要自己实现这个divrem函数，示例LLVM IR代码如下：

; 定义返回{i64,i64}结构体的divrem函数
define { i64, i64 } @divrem(i64 %a, i64 %b) {
    ; 计算除法和余数
    %div = sdiv i64 %a, %b
    %rem = srem i64 %a, %b
    ; 将结果插入到结构体中
    %ret_struct = insertvalue { i64, i64 } undef, i64 %div, 0
    %final_ret = insertvalue { i64, i64 } %ret_struct, i64 %rem, 1
    ; 返回结构体
    ret { i64, i64 } %final_ret
}

4. 编译与链接流程 #

完成代码编写后，按以下步骤编译链接：

• 将LLVM IR编译为目标文件：

  llc -filetype=obj divrem.ll -o divrem.o
  

• 编译C++代码为目标文件：

  clang++ -c main.cpp -o main.o
  

• 链接两个目标文件生成可执行程序：

  clang++ main.o divrem.o -o main
  

运行./main就能正常调用LLVM IR实现的divrem函数了。

额外注意事项 #

• 平台ABI差异：不同CPU架构（比如x86-64、ARM）的结构体返回规则可能略有不同，但LLVM和Clang都会自动遵循目标平台的ABI，只要类型对应正确就无需额外处理。
• 名字修饰问题：如果忘记加extern "C"，C++编译器会把divrem修饰成类似_Z6divremll的符号，导致链接时找不到LLVM IR中的divrem符号，触发链接错误。
• 动态生成函数场景：如果是在LLVM Pass中动态生成函数，只需将函数添加到LLVM模块中，最终将模块编译为目标文件后，和C++代码编译的目标文件链接即可；如果用JIT方式，也可以直接在运行时获取函数指针并调用（这属于更进阶的场景）。

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