c - 在 C 的公共(public) API 函数中使用枚举参数是个好主意吗？

Question

我正在设计一个 C API，除其他外，它必须提供一种设置一些双值选项的方法。为了识别我使用以下枚举的选项:

typedef enum
{
    OptionA,
    OptionB,
    ...
} Option;

在公共(public) API 函数中使用 Option 作为参数类型是否是个好主意:

int set_option(Option opt, double value);

还是改用 int 更好:

int set_option(int opt, double value);

考虑到我将来可能需要添加更多选项？

现有 API 是否有任何很好的示例可以证明这两种方法？

Answer 1

通过使用 enum，您可以有效地帮助函数的用户了解可用的有效值。当然，缺点是无论何时添加新选项，您都需要修改 header ，因此用户可能需要重新编译他的代码，而如果它是 int，他可能不必这样做。