查看“︁c/language/enum”︁的源代码

因为以下原因，您没有权限编辑该页面：

您请求的操作仅限属于这些用户组的用户执行：用户、管理员

您可以查看和复制此页面的源代码。

{{title|枚举}}
{{c/language/declarations/navbar}}

''枚举类型''{{sep}}是独立的{{rlp|types|类型}}，其值为包含所有其显示命名的常量（''枚举常量''）的''底层类型''{{sep}}的值。

===语法===
枚举类型在{{rlp|declarations|声明文法}}中以跟随的''枚举说明符''{{sep}}作为{{spar sep|类型说明符}}声明：

{{sdsc begin}}
{{sdsc|num=1|{{ttb|enum}} {{spar optional|属性声明符序列}} {{spar optional|标识符}} {{ttb|{}} {{spar|枚举项列表}} {{ttb|}<!---->}}}}
{{sdsc|num=2|notes={{mark since c23}}|{{ttb|enum}} {{spar optional|属性声明符序列}} {{spar optional|标识符}} {{ttb|:}} {{spar|类型}} {{ttb|{}} {{spar|枚举项列表}} {{ttb|}<!---->}}}}
{{sdsc end}}
@1@ 声明没有固定底层类型的枚举。
@2@ 声明固定底层类型为{{spar sep|类型}}的枚举。

其中{{spar sep|枚举项列表}}是{{spar sep|枚举项}}的逗号分隔列表{{rev inl|since=c99|（允许尾随的逗号）}}，每个{{spar sep|枚举项}}拥有形式：
{{sdsc begin}}
{{sdsc |num=1| {{spar|枚举常量}} {{spar optional|属性声明符序列}} }}
{{sdsc |num=2| {{spar|枚举常量}} {{spar optional|属性声明符序列}} {{ttb|1==}} {{spar|常量表达式}} }}
{{sdsc end}}
其中
{{par begin}}
{{par|{{spar|标识符}}, {{spar|枚举常量}}| 由此声明引入的标识符}}
{{par|{{spar|常量表达式}}| {{rlp|constant expression|整数常量表达式}}，{{rev inl|until=c23|其值可以以 {{c/core|int}} 类型的值表示。}}{{rev inl|since=c23|若枚举具有固定底层类型，则其可以表示为{{spar sep|类型}}的值}}}}
{{par|{{spar|属性声明符序列}}| {{mark c23}}可选的{{rlp|attributes|属性列表}}，
* 若出现在 {{ttb|enum}} 后则应用到整个枚举，
* 若出现在{{spar sep|枚举常量}} 后则应用到{{spar sep|枚举项}}}}
{{par end}}

与{{rlp|struct|结构体}}或{{rlp|union|联合体}}一样，引入枚举类型和一或多个枚举常量的声明亦可声明一或多个该类型的对象，或从该类型派生的类型的对象。
{{source|1=
enum color_t {RED, GREEN, BLUE} c = RED, *cp = &c;
// 引入类型 enum color_t
// 整数常量 RED 、 GREEN 、 BLUE 
// 对象 c 拥有类型 enum color_t
// 对象 cp 的类型为指向 enum color_t 的指针
}}

===解释===
每个出现于枚举说明符体中的{{spar sep|枚举常量}}会成为{{rev inl|until=c23| {{c/core|int}} 类型的}}{{rlp|constant expression|整数常量}}，并处于包围它的作用域中，而且在凡要求整数常量处可用（例如，作为 case 标号或非 VLA 数组大小）。

{{rrev|since=c23|
在处理枚举项列表中的每个枚举常量过程中，枚举常量的类型应当为：
* 之前声明的类型，若此为相同枚举常量的重声明；或者，
* 对于带有固定底层类型的枚举，则为枚举所用类型；或者，
* {{c/core|int}}，若枚举项列表中没有更早的枚举常量且没有提供定义的整数常量表达式的明确 {{=}}；或者，
* {{c/core|int}}，若给出了明确的 {{=}} 且整数常量表达式的值可以表示为 int；或者，
* 整数常量表达式的类型，若给出了明确的 {{=}} 并且整数常量表达式的值无法表示为 {{c/core|int}}；或者，
* 最后一个没寄出来的值加上 1 的值的类型。如果这种整数常量表达式对于前一个枚举常量加 1 的值会发生溢出或回绕，则其类型为以下之一：
** 适当大小的有符号整数类型（不包括位精确有符号整数类型），有能力表示前一个枚举常量加 1 的值；或者
** 适当大小的无符号整数类型（不包括位精确无符号整数类型），有能力表示前一个枚举常量加 1 的值。
当被加的前一个枚举常量为有符号整数类型时，选用有符号整数类型。当被加的前一个枚举常量为无符号整数类型时，选用无符号整数类型。如果不存在前述可以表示新值的合适的有符号整数类型，则该枚举没有有能力表示其所有值的类型。
}}

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

若{{spar sep|枚举常量}}后随{{spar sep|{{=}} 常量表达式}}，则其值为该常量表达式的值。若{{spar sep|枚举常量}}没有后随{{spar sep|{{=}}常量表达式}} ，则其值是比同一枚举中前一枚举项的值大一的值。首个枚举项（若它不用 {{spar|{{=}} 常量表达式}} ）的值是零。
{{source|1=
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}}

若使用{{spar sep|标识符}}，则其自身成为标签{{rlp|name space|命名空间}}中枚举类型的名称，且需要使用关键词 enum （除非 typedef 到通常命名空间）。
{{source|1=
enum color { RED, GREEN, BLUE };
enum color r = RED; // OK
// color x = GREEN; // 错误： color 不在通常命名空间中
typedef enum color color_t;
color_t x = GREEN; // OK
}}

每个{{rev inl|since=c23|无固定底层类型的}}枚举类型与如下之一{{rlp|types#兼容类型|兼容}}：{{c/core|char}}、有符号整数类型或无符号整数类型{{rev inl|since=c23|（不包括 {{c/core|bool}} 和位精确整数类型）}}。对于任何枚举类型，哪一个类型是兼容的是实现定义的，但无论是那种类型，都必须有足以表示该枚举中所有枚举项的值。{{rev inl|since=c23|对于所有具有固定底层类型的枚举，枚举的类型均与枚举的底层类型兼容。}}

{{rev begin}}
{{rev|since=c23|
没有固定底层类型的枚举类型，在其完成处枚举成员的类型为：
* 如果枚举的所有值均可表示为一个 {{c/core|int}} 则为 {{c/core|int}}；否则，
* 所枚举的类型。
}}

{{rev|since=c23|所有枚举均有底层类型。可以通过用 {{spar|enum-类型说明符}} 显式指定底层类型，并作为其固定底层类型。如果未显示指定，则其底层类型为枚举的兼容类型，它为有符号或无符号的整数类型或 {{c/core|char}}。
}}
{{rev end}}

枚举类型是整数类型，从而可以用于任何其他整数类型能用之处，包括{{rlp|conversion|隐式转换}}和{{rlp|operator arithmetic|算术运算符}}。
{{source|1=
enum { ONE = 1, TWO } e;
long n = ONE; // 提升
double d = ONE; // 转换
e = 1.2; // 转换，e 现在是 ONE
e = e + 1; // e 现在是 TWO
}}

===注解===
不同于 {{rlp|struct}} 或 {{rlp|union}} ， C 中没有 enum 的前置声明：
{{source|1=
enum Color; // 错误：C 中无 enum 的前置声明
enum Color { RED, GREEN, BLUE };
}}

枚举允许以比 {{c|#define}} 更加便利和结构化的方式生成具名常量；它们可见于调试器，遵循作用域规则，并且参与类型系统。
{{source|1=
#define TEN 10
struct S { int x : TEN; }; // OK
}}
或
{{source|1=
enum { TEN = 10 };
struct S { int x : TEN; }; // 也 OK
}}

自 C23 起也可用 {{rlp|constexpr}} 来达成相同目的：
{{source|1=
constexpr int TEN = 10;
struct S { int x : TEN; }; // 也 OK
}}

另外，由于 C 中{{rlp|struct|结构体}}或{{rlp|union|联合体}}不建立其作用域，可以在前者的成员说明中引入枚举类型及其枚举常量，而之后其作用域与前者相同。
{{source|1=
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
}
}}

===示例===
{{example
|code=
#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);
}
|output=
List of cable stations:
  FOX:   11
  HBO:   22
  MAX:   30
}}

===引用===
{{ref std c23}}
{{ref std | section=6.2.5/21 | title=Types | p=39}}
{{ref std | section=6.7.2.2 | title=Enumeration specifiers | p=107-112}}
{{ref std end}}
{{ref std c17}}
{{ref std | section=6.2.5/16 | title=Types | p=32}}
{{ref std | section=6.7.2.2 | title=Enumeration specifiers | p=84-85}}
{{ref std end}}
{{ref std c11}}
{{ref std | section=6.2.5/16 | title=Types | p=41}}
{{ref std | section=6.7.2.2 | title=Enumeration specifiers | p=117-118}}
{{ref std end}}
{{ref std c99}}
{{ref std | section=6.2.5/16 | title=Types | p=35}}
{{ref std | section=6.7.2.2 | title=Enumeration specifiers | p=105-106}}
{{ref std end}}
{{ref std c89}}
{{ref std | section=3.1.2.5 | title=Types}}
{{ref std | section=3.5.2.2 | title=Enumeration specifiers}}
{{ref std end}}

===关键词===
{{ltt|c/keyword/enum}}

===参阅===
{{dsc begin}}
{{dsc see cpp | cpp/language/enum |枚举声明|nomono=true}}
{{dsc end}}

{{langlinks|ar|cs|de|en|es|fr|it|ja|ko|pl|pt|ru|tr}}

该页面使用的模板：

Template:!（查看源代码）
Template:=（查看源代码）
Template:c（查看源代码）
Template:c/core（查看源代码）
Template:c/language/declarations/navbar（查看源代码）
Template:c/language/declarations/navbar content（查看源代码）
Template:c/language/declarations/navbar heading（查看源代码）
Template:c/language/navbar content（查看源代码）
Template:c/language/navbar heading（查看源代码）
Template:c/navbar content（查看源代码）
Template:c/navbar heading（查看源代码）
Template:dsc（查看源代码）
Template:dsc begin（查看源代码）
Template:dsc editlink（查看源代码）
Template:dsc end（查看源代码）
Template:dsc guard（查看源代码）
Template:dsc see cpp（查看源代码）
Template:example（查看源代码）
Template:get lang（查看源代码）
Template:langlinks（查看源代码）
Template:langlinks/one（查看源代码）
Template:lines（查看源代码）
Template:list guard（查看源代码）
Template:ltt（查看源代码）
Template:ltt/core（查看源代码）
Template:mark（查看源代码）
Template:mark c11（查看源代码）
Template:mark c23（查看源代码）
Template:mark c99（查看源代码）
Template:mark optional（查看源代码）
Template:mark rev（查看源代码）
Template:mark since c23（查看源代码）
Template:mark since c99（查看源代码）
Template:mark until c23（查看源代码）
Template:navbar（查看源代码）
Template:navbar editlink（查看源代码）
Template:nv（查看源代码）
Template:nv begin（查看源代码）
Template:nv end（查看源代码）
Template:nv h2（查看源代码）
Template:nv ln（查看源代码）
Template:par（查看源代码）
Template:par begin（查看源代码）
Template:par end（查看源代码）
Template:ref std（查看源代码）
Template:ref std c11（查看源代码）
Template:ref std c17（查看源代码）
Template:ref std c23（查看源代码）
Template:ref std c89（查看源代码）
Template:ref std c99（查看源代码）
Template:ref std end（查看源代码）
Template:rev（查看源代码）
Template:rev begin（查看源代码）
Template:rev end（查看源代码）
Template:rev inl（查看源代码）
Template:rlp（查看源代码）
Template:rrev（查看源代码）
Template:sdsc（查看源代码）
Template:sdsc begin（查看源代码）
Template:sdsc end（查看源代码）
Template:sdsc sep（查看源代码）
Template:sep（查看源代码）
Template:source（查看源代码）
Template:spar（查看源代码）
Template:spar optional（查看源代码）
Template:spar sep（查看源代码）
Template:title（查看源代码）（受保护）
Template:trim（查看源代码）
Template:ttb（查看源代码）

返回c/language/enum。

cppreference.com

搜索

命名空间

语言变体

查看

操作

查看“︁c/language/enum”︁的源代码

导航

工具