C 参考手册

位置：首页 > C 参考手册 >C 语言 > 枚举

枚举

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

语法

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

enum 标识符(可选) { 枚举项列表 }

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

枚举常量 (1)
枚举常量 = 常量表达式 (2)

其中

标识符, 枚举常量 - 由此声明引入的标识符
常量表达式 - 整数常量表达式，其值可以以 int 类型的值表示

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

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

示例

运行此代码
#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

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 6.2.5/16 Types (p: 41)
  • 6.7.2.2 Enumeration specifiers (p: 117-118)
  • C99 standard (ISO/IEC 9899:1999):
  • 6.2.5/16 Types (p: 35)
  • 6.7.2.2 Enumeration specifiers (p: 105-106)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 3.1.2.5 Types
  • 3.5.2.2 Enumeration specifiers

关键词

enum

参阅