泛型选择 (C11 起)

来自cppreference.com
< c‎ | language


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

语法

_Generic ( 控制表达式 , 关联列表 ) (C11 起)

其中 关联列表 是关联的逗号分隔列表,每项关联的语法为:

类型名 : 表达式
default : 表达式

其中

类型名 - 任何并非可变修改的完整对象类型(即既非 VLA 亦非指向 VLA 的指针)。
控制表达式 - 任何表达式(除了逗号运算符),若不使用 default 关联,则其类型必须与 类型名 之一兼容,
表达式 - 任何类型和值类别的表达式(除了逗号运算符

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

解释

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

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

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

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

注解

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

因为左值转换,"abc" 匹配 char* 而非 char[4](int const){0} 匹配 int 而非 const int

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

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

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

关键词

_Generic, default

示例

#include <math.h>
#include <stdio.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

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C 标准。

缺陷报告 应用于 出版时的行为 正确行为
DR 481 C11 未指定控制表达式是否经历左值转换 经历

引用

  • C23 标准(ISO/IEC 9899:2024):
  • 6.5.1.1 Generic selection (第 TBD 页)
  • C17 标准(ISO/IEC 9899:2018):
  • 6.5.1.1 Generic selection (第 56-57 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 6.5.1.1 Generic selection (第 78-79 页)

参阅