枚举

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

C 语言

基本概念

关键词

预处理器

语句

表达式

初始化

声明

函数

杂项

C 的历史

技术规范

 

声明

指针

数组

enum

struct

union

位域

原子类型 (C11)

const

volatile

restrict (C99)

_Alignas (C11)

存储期与链接

外部及试探性定义

typedef

_Static_assert (C11)

属性 (C23)

 

枚举类型是独立的类型，其值为包含所有其显示命名的常量（枚举常量）的底层类型的值。

语法

枚举类型在声明文法中以跟随的枚举说明符作为 类型说明符 声明：

enum 属性声明符序列(可选) 标识符(可选) { 枚举项列表 }

其中 枚举项列表 是 枚举项 的逗号分隔列表（允许尾随的逗号） (C99 起)，每个 枚举项 拥有形式：

枚举常量 属性声明符序列(可选)	(1)
枚举常量 属性声明符序列(可选) = 常量表达式	(2)

其中

标识符, 枚举常量	-	由此声明引入的标识符
常量表达式	-	整数常量表达式，其值可以以 int 类型的值表示
属性声明符序列	-	(C23)可选的属性列表， 若出现在 enum 后则应用到整个枚举， 若出现在 枚举常量 后则应用到 枚举项

与结构体或联合体一样，引入枚举类型和一或多个枚举常量的声明亦可声明一或多个该类型的对象，或从该类型派生的类型的对象。

enum color_t {RED, GREEN, BLUE} c = RED, *cp = &c;
// 引入类型 enum color_t
// 整数常量 RED 、 GREEN 、 BLUE 
// 对象 c 拥有类型 enum color_t
// 对象 cp 的类型为指向 enum color_t 的指针

解释

每个出现于枚举说明符体中的 枚举常量 会成为 int 类型的整数常量，并处于包围它的作用域中，而且在凡要求整数常量处可用（例如，作为 case 标号或非 VLA 数组大小）。

enum color { RED, GREEN, BLUE } r = RED;
switch(r) {
case RED:
    puts("red");
    break;
case GREEN:
    puts("green");
    break;
case BLUE:
    puts("blue");
    break;
}

若 枚举常量 后随 = 常量表达式 ，则其值为该常量表达式的值。若 枚举常量 没有后随 = 常量表达式 ，则其值是比同一枚举中前一枚举项的值大一的值。首个枚举项（若它不用 = 常量表达式 ）的值是零。

enum Foo { A, B, C=10, D, E=1, F, G=F+C};
// A=0, B=1, C=10, D=11, E=1, F=2, G=12

若使用 标识符 ，则其自身成为标签命名空间中枚举类型的名称，且需要使用关键词 enum （除非 typedef 到通常命名空间）。

enum color { RED, GREEN, BLUE };
enum color r = RED; // OK
// color x = GREEN: // 错误： color 不在通常命名空间中
typedef enum color color_t;
color_t x = GREEN; // OK

每个枚举类型与如下之一兼容： char 、有符号整数类型或无符号整数类型。对于任何枚举类型，哪一个类型是兼容的是实现定义的，但无论是那种类型，都必须有足以表示该枚举中所有枚举项的值。

枚举类型是整数类型，从而可以用于任何其他整数类型能用之处，包括隐式转换和算术运算符。

enum { ONE = 1, TWO } e;
long n = ONE; // 提升
double d = ONE; // 转换
e = 1.2; // 转换，e 现在是 ONE
e = e + 1; // e 现在是 TWO

注解

不同于 struct 或 union ， C 中没有 enum 的前置声明：

enum Color; // 错误：C 中无 enum 的前置声明
enum Color { RED, GREEN, BLUE };

枚举允许以比 #define 更加便利和结构化的方式生成具名常量；它们可见于调试器，遵循作用域规则，并且参与类型系统。

#define TEN 10
struct S { int x : TEN; }; // OK

或

enum { TEN = 10 };
struct S { int x : TEN; }; // 也 OK

另外，由于 C 中结构体或联合体不建立其作用域，可以在前者的成员说明中引入枚举类型及其枚举常量，而之后其作用域与前者相同。

struct Element {
    int z;
    enum State { SOLID, LIQUID, GAS, PLASMA } state;
} oxygen = { 8, GAS };
// 类型 enum State 与其枚举常量于此保持可见，例如
void foo(void) {
    enum State e = LIQUID; // OK
    printf("%d %d %d ", e, oxygen.state, PLASMA); // 打印 1 2 3
}

示例

运行此代码

#include <stdio.h>
 
int main(void)
{
    enum TV { FOX = 11, CNN = 25, ESPN = 15, HBO = 22, MAX = 30, NBC = 32 };
 
    printf("List of cable stations: \n");
    printf(" FOX: \t%2d\n", FOX);
    printf(" HBO: \t%2d\n", HBO);
    printf(" MAX: \t%2d\n", MAX);
}

输出：

List of cable stations: 
 FOX: 	11
 HBO: 	22
 MAX: 	30

引用

• C17 标准（ISO/IEC 9899:2018）：

• 6.2.5/16 Types （第 32 页）

• 6.7.2.2 Enumeration specifiers （第 84-85 页）

• C11 标准（ISO/IEC 9899:2011）：

• 6.2.5/16 Types （第 41 页）

• 6.7.2.2 Enumeration specifiers （第 117-118 页）

• C99 标准（ISO/IEC 9899:1999）：

• 6.2.5/16 Types （第 35 页）

• 6.7.2.2 Enumeration specifiers （第 105-106 页）

• C89/C90 标准（ISO/IEC 9899:1990）：

• 3.1.2.5 Types

• 3.5.2.2 Enumeration specifiers

关键词

enum