泛型选择

提供一种基于控制表达式的类型，在编译时选择数个表达式之一的方法。

语法

其中 关联列表 是逗号分隔的关联列表，每个关联拥有语法：

其中

关联列表 中的任意二个 类型名 不能指定兼容类型。使用关键词 default 的关联只能有一个。若不使用 default ，且无一 类型名 与控制表达式类型兼容，则程序无法编译。

解释

首先， 控制表达式 的类型经历左值转换。只在类型域中进行转换：它舍弃顶层 cvr 限定符和原子属性，并应用数组到指针/函数到指针变换到控制表达式的类型，而不实例化任何副效应或计算任何值。

将转换后的类型与来自关联列表中的 类型名 比较。

若其类型与关联之一的 类型名 兼容，则泛型选择的类型、值及值类别就是出现于该 类型名 冒号后的表达式的类型、值及值类别。

若无一 类型名 的类型与 控制表达式 兼容，且提供了 default 关联，则泛型的类型、值及值类别就是出现于 default : 标号后的表达式的类型、值及值类别。

注解

决不求值 控制表达式 和未被选择的选项中的 表达式 。

因为左值转换， "abc" 匹配 char* 而非 char[4] ， (int const){0} 匹配 int 而非 const int 。这是由 C17 DR481 指定的（回溯应用到 C11 ）。

泛型选择中的 表达式 允许任何值类别，含函数指代器及 void 表达式，而且若它受到选择，则泛型选择自身拥有相同的值类别。

C99 中引入的来自 <tgmath.h> 的泛型数学宏，曾是通过编译器限定的行为实现的。 C11 所引入的泛型选择，给予程序员写相似的类型依赖代码的能力。

泛型选择类似 C++ 中的重载（在编译时基于参数类型选择数个函数之一）。除了它在任意表达式之间选择。

关键词

_Generic, default

示例

#include <stdio.h>
#include <math.h>
 
// tgmath.h 宏 cbrt 的可能实现
#define cbrt(X) _Generic((X), \
              long double: cbrtl, \
                  default: cbrt,  \
                    float: cbrtf  \
)(X)
 
int main(void)
{
    double x = 8.0;
    const float y = 3.375;
    printf("cbrt(8.0) = %f\n", cbrt(x)); // 选择默认的 cbrt
    printf("cbrtf(3.375) = %f\n", cbrt(y)); // 将 const float 转换成 float，
                                            // 然后选择 cbrtf
}

cbrt(8.0) = 2.000000
cbrtf(3.375) = 1.500000

引用