寻求C头文件函数封装工具：自动生成带错误检查的包装头文件

针对你的需求，这里有几个实用的工具/方案可以帮你自动生成带错误检查包装宏的头文件，按易用性和可靠性排序推荐：

如果你的头文件函数格式比较规整（像示例里的那样），用Python写个小脚本是最快的方式。核心思路是用正则匹配函数原型，提取函数名和参数列表，然后生成对应的宏定义。

示例脚本：

import re
import sys

# 匹配函数原型的正则（可根据你的头文件格式调整）
pattern = re.compile(r'MQ_EXTERN enum MqErrorE MQ_DECL (\w+) \((.*?)\);')

def generate_wrapper(header_path, output_path):
    with open(header_path, 'r') as f:
        content = f.read()
    
    matches = pattern.findall(content)
    with open(output_path, 'w') as f:
        f.write("// 自动生成的错误检查包装宏\n")
        for func_name, args in matches:
            # 生成宏定义：函数名加E，参数和原函数一致
            macro = f"#define {func_name}E({args}) \\\n    MqErrorCheck({func_name}({args}))\n"
            f.write(macro + '\n')

if __name__ == "__main__":
    if len(sys.argv) != 3:
        print("用法: python generate_wrappers.py <原头文件路径> <输出头文件路径>")
        sys.exit(1)
    generate_wrapper(sys.argv[1], sys.argv[2])

使用说明：

• 调整正则表达式以匹配你头文件里的函数格式（比如如果有的函数返回值不是enum MqErrorE，可以修改正则的返回值部分）
• 运行脚本后，会在输出路径生成包含所有包装宏的头文件

优缺点：

• 优点：编写快，易修改，不需要额外依赖（除了Python）
• 缺点：正则表达式可能无法处理复杂的C语法（比如参数里有带逗号的宏、嵌套结构体声明等）

如果你的头文件包含复杂的C语法（比如复杂类型、宏参数里的逗号），正则就不够用了。这时候可以用Clang的LibTooling来解析头文件的AST（抽象语法树），准确提取函数信息。

核心思路是写一个C++程序，使用Clang的LibTooling API，遍历AST中的函数声明，筛选返回值为enum MqErrorE的函数，提取函数名和参数列表后生成宏定义。

示例代码片段（简化版）：

#include "clang/AST/ASTConsumer.h"
#include "clang/AST/RecursiveASTVisitor.h"
#include "clang/Frontend/CompilerInstance.h"
#include "clang/Frontend/FrontendAction.h"
#include "clang/Tooling/Tooling.h"
#include <fstream>

using namespace clang;
using namespace clang::tooling;

class FuncVisitor : public RecursiveASTVisitor<FuncVisitor> {
public:
    explicit FuncVisitor(ASTContext *Context, std::ofstream &Output) : Context(Context), Output(Output) {}

    bool VisitFunctionDecl(FunctionDecl *FD) {
        // 检查返回值是否为enum MqErrorE
        QualType RetType = FD->getReturnType();
        const EnumType *ET = RetType->getAs<EnumType>();
        if (!ET) return true;
        EnumDecl *ED = ET->getDecl();
        if (ED->getNameAsString() != "MqErrorE") return true;

        // 提取函数名和参数
        std::string FuncName = FD->getNameAsString();
        std::string Args;
        for (auto *Param : FD->parameters()) {
            if (!Args.empty()) Args += ", ";
            Args += Param->getNameAsString();
        }

        // 生成宏定义
        Output << "#define " << FuncName << "E(" << Args << ") \\\n";
        Output << "    MqErrorCheck(" << FuncName << "(" << Args << "))\n\n";
        return true;
    }

private:
    ASTContext *Context;
    std::ofstream &Output;
};

class FuncConsumer : public ASTConsumer {
public:
    explicit FuncConsumer(ASTContext *Context, std::ofstream &Output) : Visitor(Context, Output) {}

    void HandleTranslationUnit(ASTContext &Context) override {
        Visitor.TraverseDecl(Context.getTranslationUnitDecl());
    }

private:
    FuncVisitor Visitor;
};

class FuncAction : public ASTFrontendAction {
public:
    FuncAction(std::string OutputPath) : OutputPath(std::move(OutputPath)) {}

    std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI, StringRef File) override {
        Output.open(OutputPath);
        Output << "// 自动生成的错误检查包装宏\n";
        return std::make_unique<FuncConsumer>(&CI.getASTContext(), Output);
    }

private:
    std::string OutputPath;
    std::ofstream Output;
};

int main(int argc, const char **argv) {
    if (argc != 3) {
        llvm::errs() << "用法: clang-wrapper-gen <原头文件路径> <输出头文件路径>\n";
        return 1;
    }

    CommonOptionsParser OptionsParser(argc, argv);
    ClangTool Tool(OptionsParser.getCompilations(), OptionsParser.getSourcePathList());
    return Tool.run(newFrontendActionFactory<FuncAction>(argv[2]).get());
}

使用说明：

• 需要安装Clang开发库（比如libclang-dev），编译这个程序
• 运行时传入原头文件和输出文件路径，它会准确解析所有符合条件的函数

优缺点：

• 优点：能处理所有合法的C语法，完全可靠，适合大型项目
• 缺点：学习成本较高，需要熟悉Clang的API，编译和配置稍复杂

如果你的函数格式非常固定，没有复杂的参数结构，可以用Awk或者Sed来快速处理，不需要写复杂的程序。

示例Awk脚本：

#!/usr/bin/awk -f

# 匹配目标函数行
/MQ_EXTERN enum MqErrorE MQ_DECL/ {
    # 提取函数名：第四个字段（假设格式固定）
    func_name = $4
    # 提取参数部分：从括号开始到分号结束
    match($0, /\((.*)\);/, args)
    args_list = args[1]
    # 生成宏定义
    printf "#define %sE(%s) \\\n    MqErrorCheck(%s(%s))\n\n", func_name, args_list, func_name, args_list
}

使用说明：

• 保存为generate_wrappers.awk，运行awk -f generate_wrappers.awk original.h > wrappers.h
• 如果函数格式有变化，需要调整字段索引和匹配规则

优缺点：

• 优点：运行极快，依赖系统自带工具，不需要额外安装
• 缺点：对格式变化非常敏感，无法处理复杂的C语法

根据你的项目规模和头文件复杂度选择合适的方案就好！

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