如何取消stdlib中calloc()定义以使用自定义calloc函数？

问题背景 #

我有一个头文件calloc.h，里面用stdlib的malloc()实现了自定义的calloc()函数，但编译时出现multiple definition of 'calloc'错误。

calloc.h的内容如下：

#include <stdbool.h>
#include <stdlib.h>
#include <string.h>

void *calloc(size_t num, size_t size)
{
    /* num * size unsigned integer wrapping check */
    if ((num >= MUL_NO_OVERFLOW || size >= MUL_NO_OVERFLOW) && num > 0 && SIZE_MAX / num < size)
    {
        return NULL;
    }

    size_t total_size = num * size;
    void *ptr = malloc(total_size);

    if (ptr)
    {
        memset(ptr, 0, total_size);
    }

    return ptr;
}

为了规避冲突，我尝试过以下代码：

#define calloc _calloc_

#include <stdbool.h>
#include <stdlib.h>
#include <string.h>

#undef calloc

但又出现新错误：

cstdlib:144:11: error: 'calloc' has not been declared in '::'
stdlib.h:59:12: error: 'calloc' has not been declared in 'std'

错误原因 #

• 重复定义问题：头文件中直接写函数定义（而非声明），当多个源文件包含该头文件时，每个源文件都会生成一份calloc的定义，链接阶段就会触发重复定义错误。
• 宏替换副作用：用#define calloc _calloc_后包含stdlib.h，会把标准库中calloc的声明也替换成_calloc_，后续#undef后，代码找不到标准calloc的声明，因此报未定义错误。

可行解决方案 #

方案一：拆分声明与定义（最规范） #

1. 修改calloc.h，仅保留函数声明，并添加头文件保护防止重复包含：

#ifndef CALLOC_H
#define CALLOC_H

#include <stdlib.h>

void *calloc(size_t num, size_t size);

#endif // CALLOC_H

2. 创建calloc.c文件，存放函数的具体实现：

#include "calloc.h"
#include <string.h>

void *calloc(size_t num, size_t size)
{
    /* num * size unsigned integer wrapping check */
    if ((num >= MUL_NO_OVERFLOW || size >= MUL_NO_OVERFLOW) && num > 0 && SIZE_MAX / num < size)
    {
        return NULL;
    }

    size_t total_size = num * size;
    void *ptr = malloc(total_size);

    if (ptr)
    {
        memset(ptr, 0, total_size);
    }

    return ptr;
}

3. 编译时将calloc.c与其他源文件一起参与编译链接，这样整个程序只会存在一份calloc的定义，解决重复定义问题。

方案二：用static限定函数作用域（不推荐） #

如果不想拆分文件，可以在头文件的函数定义前添加static关键字：

#include <stdbool.h>
#include <stdlib.h>
#include <string.h>

static void *calloc(size_t num, size_t size)
{
    /* 原函数实现不变 */
}

但这种方式会让每个包含该头文件的源文件都生成独立的calloc副本，增加可执行文件体积，且不同源文件的calloc是不同实例，不适合需要全局统一逻辑的场景。

方案三：重命名自定义函数（推荐） #

直接将自定义的calloc改名为safe_calloc这类独特名称，彻底避免与标准库函数冲突：
头文件calloc.h：

#ifndef CALLOC_H
#define CALLOC_H

#include <stdlib.h>

void *safe_calloc(size_t num, size_t size);

#endif // CALLOC_H

源文件calloc.c：

#include "calloc.h"
#include <string.h>

void *safe_calloc(size_t num, size_t size)
{
    /* 原逻辑保持不变 */
    if ((num >= MUL_NO_OVERFLOW || size >= MUL_NO_OVERFLOW) && num > 0 && SIZE_MAX / num < size)
    {
        return NULL;
    }

    size_t total_size = num * size;
    void *ptr = malloc(total_size);

    if (ptr)
    {
        memset(ptr, 0, total_size);
    }

    return ptr;
}

这种方式完全规避命名冲突，代码可读性更强，不会和标准库函数混淆。

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