返回资讯中心
外部精选
软件工程
#开发者实时流

C 语言指定初始化器可实现具名参数与默认值

来源标题:C's designated initializers give us named arguments

文章介绍如何用 C 语言的完整版指定初始化器配合可变参数宏,实现带具名参数和默认值的函数调用语法。示例中 ideal_volume 通过宏为 atm、moles、kelvin 预设默认值,调用时只需写出要覆盖的字段名。该写法源自 Ben Klemens 2014 年著作《21st Century C》第 226 至 228 页。

Hacker News 最新joshcsimmons2026/11/18 · 今天11 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

C 的指定初始化器让我们实现命名参数

在上一篇博文中,我谈到了 C++ 中“相对被削弱”的指定初始化器形式。这次我想展示一个用 C 全功能指定初始化器可以实现的巧妙技巧。我第一次看到这种模式是在 Ben Klemens 的书《21st Century C》(2014 年)第 226–228 页。(Godbolt。)

struct IdealVolumeArgs {
 double atm; // P
 double moles; // n
 double kelvin; // T
};
#define ideal_volume(...) ideal_volume_impl( \
 (struct IdealVolumeArgs){ \
 .atm=1, .moles=1, .kelvin=273.15, __VA_ARGS__ \
 })
double ideal_volume_impl(struct IdealVolumeArgs args) {
 // The ideal gas law: PV = nRT
 return args.moles * 0.082057366 * args.kelvin / args.atm;
int main() {
 printf("1 mole of gas at STP occupies %g L\n",
 ideal_volume());
 printf("1 mole of gas at 100°C occupies %g L\n",
 ideal_volume(.kelvin = 373.15));
 printf("2 moles of gas at 100°C occupies %g L\n",
 ideal_volume(.kelvin = 373.15, .moles = 2));
 printf("2 moles of gas at 0°C and 2 atm occupies %g L\n",
 ideal_volume(.moles = 2, .atm = 2));

这种惯用法为我们提供了带名字、可设默认值的参数,并且调用语法自然。它依赖于 C 的指定初始化器的两个特性,而 C++20 没有采纳这两个特性:

它们可以以任意顺序出现:(struct IdealVolumeArgs){ .atm=1, .moles=2 } 与 (struct IdealVolumeArgs){ .moles=2, .atm=1 } 含义相同。

同一个指示符可以出现多次,只有最后一个“生效”:(struct IdealVolumeArgs){ .atm=1, .moles=2, .atm=3 } 与 (struct IdealVolumeArgs){ .atm=3, .moles=2 } 含义相同。

第二条意味着我们依赖的东西如果不是有意为之,就会是不好的风格。Clang 默认会发出 -Winitializer-overrides 诊断。GCC(在我看来更合理)只在 -Wextra 下发出 -Woverride-init。

一旦某个函数使用了这种惯用法,向函数定义中添加新的命名参数就不再是 API 破坏性变更了!例如,我们可能决定让调用者自己提供理想气体常数 R 的值。我们只需在 Args 结构体中添加一个新字段。所有旧的调用点仍然可以正常编译,并且行为相同。(这不是 API 破坏,但确实是 ABI 破坏:调用者不需要重写,但确实需要针对新的头文件重新编译。)

struct IdealVolumeArgs {
 double atm; // P
 double moles; // n
 double R; // R -- this new field changes ABI
 double kelvin; // T
};
#define ideal_volume(...) ideal_volume_impl((struct IdealVolumeArgs){ \
 .atm=1, .moles=1, .R = 0.082057366, .kelvin=273.15, __VA_ARGS__ \
})
double ideal_volume_impl(struct IdealVolumeArgs args) {
 return args.moles * args.R * args.kelvin / args.atm;

如果你正在编写一系列相关函数,可以让整个函数族共享同一个 Args 结构体;例如,我们可以给结构体添加一个 .liters 字段,将其重命名为 IdealGasArgs,然后用这袋关键字参数定义一整个函数族:

#define ideal_pressure(...) ideal_pressure_impl((struct IdealGasArgs){ \
 .atm=NAN, .moles=1, .kelvin=273.15, .liters=1, __VA_ARGS__ })
#define ideal_amount(...) ideal_amount_impl((struct IdealGasArgs){ \
 .atm=1, .moles=NAN, .kelvin=273.15, .liters=1, __VA_ARGS__ })
#define ideal_temperature(...) ideal_temperature_impl((struct IdealGasArgs){ \
 .atm=1, .moles=1, .kelvin=NAN, .liters=1, __VA_ARGS__ })

你还可以在前面加上任意数量的非关键字参数:

typedef struct { int cx, cy, r; } CircleArgs;
void sc_circle_impl(ScreenContext *, int opcode, CircleArgs);
#define sc_erase_circle(sc, ...) sc_circle_impl(sc, 0, (CircleArgs){__VA_ARGS__})
#define sc_draw_circle(sc, ...) sc_circle_impl(sc, 1, (CircleArgs){__VA_ARGS__})
#define sc_fill_circle(sc, ...) sc_circle_impl(sc, 2, (CircleArgs){__VA_ARGS__})

现实中的使用

你是否应该把所有的普通 C 代码都换成这种模式?绝对不要。与直接写一个普通的、没有命名参数的函数相比,它重量级且“取巧”,比如:

double ideal_volume(double atm, double moles, double kelvin) {
 return moles * 0.082057366 * kelvin / atm;

这几乎总是你所需要的全部。不过,在 GitHub 上快速做一次正则搜索,还是能找到一些看起来真实使用这种模式的地方。我找到的第一个值得分享的用法是在 gab462/hof-flecs-raylib 中,它用这种模式写出了这样的调用:

send_message(&globals.send_buf, msg, .from_id = globals.name);

我发现使用这种模式的最知名项目是 EpicGames/raddebugger:

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →