C语言中返回对象指针的函数如何返回多类错误码？

针对你提到的struct object *object_create();需要返回多种错误码的需求，这里有几种合理且符合C语言惯例的实现方式，避免直接混用指针和错误码：

方案一：通过输出参数传递错误码（推荐） #

这是C语言中最常用的做法，既兼容原有函数的使用方式，又能传递详细错误信息。

首先定义错误码枚举：

typedef enum {
    OBJECT_ERR_NONE = 0,          // 无错误（成功）
    OBJECT_ERR_OUT_OF_MEMORY,     // 内存分配失败
    OBJECT_ERR_INVALID_CONFIG,    // 配置参数无效
    OBJECT_ERR_DEPENDENCY_FAILED, // 依赖组件初始化失败
    OBJECT_ERR_PERMISSION_DENIED, // 权限不足
    OBJECT_ERR_INVALID_TYPE,      // 类型参数非法
    OBJECT_ERR_RESOURCE_BUSY,     // 资源被占用
    OBJECT_ERR_VERSION_MISMATCH,  // 版本不兼容
    OBJECT_ERR_CORRUPT_DATA,      // 数据损坏
    OBJECT_ERR_UNKNOWN            // 未知错误
} ObjectError;

修改函数签名，添加一个输出参数用于传递错误码：

struct object *object_create(ObjectError *err_out) {
    // 初始化错误码（如果调用者传入了指针）
    if (err_out != NULL) {
        *err_out = OBJECT_ERR_NONE;
    }

    struct object *obj = malloc(sizeof(struct object));
    if (obj == NULL) {
        if (err_out != NULL) {
            *err_out = OBJECT_ERR_OUT_OF_MEMORY;
        }
        return NULL;
    }

    // 示例：假设对象初始化失败的场景
    if (obj_initialize_internal(obj) != 0) {
        free(obj);
        if (err_out != NULL) {
            *err_out = OBJECT_ERR_DEPENDENCY_FAILED;
        }
        return NULL;
    }

    // 其他可能的错误检查逻辑...

    return obj;
}

使用方式：

• 如果关心错误码：

  ObjectError err;
  struct object *obj = object_create(&err);
  if (obj == NULL) {
      switch (err) {
          case OBJECT_ERR_OUT_OF_MEMORY:
              // 处理内存不足错误
              break;
          case OBJECT_ERR_DEPENDENCY_FAILED:
              // 处理依赖失败错误
              break;
          // 其他错误分支
      }
  }
  

• 如果不关心错误码，直接传NULL，和原来的用法一致：

  struct object *obj = object_create(NULL);
  if (obj == NULL) {
      // 通用错误处理
  }
  

优点：线程安全、兼容旧代码、错误码传递清晰。

方案二：返回包含指针和错误码的结构体 #

这种方式把结果和错误信息打包成一个结构体返回，适合愿意修改原有调用逻辑的场景。

// 先定义错误码枚举（同方案一）
typedef enum {
    OBJECT_ERR_NONE = 0,
    OBJECT_ERR_OUT_OF_MEMORY,
    // ... 其他错误码
} ObjectError;

// 定义返回结果结构体
typedef struct {
    struct object *instance;
    ObjectError error;
} ObjectCreateResult;

ObjectCreateResult object_create() {
    ObjectCreateResult result = {.instance = NULL, .error = OBJECT_ERR_NONE};

    result.instance = malloc(sizeof(struct object));
    if (result.instance == NULL) {
        result.error = OBJECT_ERR_OUT_OF_MEMORY;
        return result;
    }

    if (obj_initialize_internal(result.instance) != 0) {
        free(result.instance);
        result.instance = NULL;
        result.error = OBJECT_ERR_DEPENDENCY_FAILED;
        return result;
    }

    return result;
}

使用方式：

ObjectCreateResult res = object_create();
if (res.error != OBJECT_ERR_NONE) {
    // 根据res.error处理对应错误
} else {
    // 使用res.instance对象
}

优点：错误码和结果绑定，逻辑更直观；缺点：需要修改所有原有调用代码，兼容性差。

方案三：使用全局错误变量（不推荐） #

这种方式不需要修改函数签名，但存在线程安全问题，仅适合单线程场景。

// 定义错误码枚举（同方案一）
typedef enum {
    OBJECT_ERR_NONE = 0,
    OBJECT_ERR_OUT_OF_MEMORY,
    // ... 其他错误码
} ObjectError;

// 静态全局变量存储最后一次错误
static ObjectError g_last_object_error = OBJECT_ERR_NONE;

struct object *object_create() {
    g_last_object_error = OBJECT_ERR_NONE;

    struct object *obj = malloc(sizeof(struct object));
    if (obj == NULL) {
        g_last_object_error = OBJECT_ERR_OUT_OF_MEMORY;
        return NULL;
    }

    if (obj_initialize_internal(obj) != 0) {
        free(obj);
        g_last_object_error = OBJECT_ERR_DEPENDENCY_FAILED;
        return NULL;
    }

    return obj;
}

// 提供获取错误码的接口
ObjectError object_get_last_error() {
    return g_last_object_error;
}

使用方式：

struct object *obj = object_create();
if (obj == NULL) {
    ObjectError err = object_get_last_error();
    // 处理错误
}

缺点：多线程环境下，全局变量可能被其他线程修改，导致错误码不准确，不推荐在多线程程序中使用。

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