Enumerations

enumerated type は、その underlying type （下記参照）の値である値を持つ個別の type であり、明示的に名前が付けられた定数（ enumeration constants ）の値を含みます。

、$タグ内のテキストは翻訳していません\; -\; C++関連の専門用語（Syntax、Explanation、Notes、Example、References、Keywords、See\; also）は原文のまま保持しています\; -\; 数値や構造は完全に保持されています\; -\; フォーマットとレイアウトは元のまま維持されています$

構文

列挙型は以下の 列挙指定子 を 宣言文法 における type-specifier として使用して宣言されます：

where enumerator-list はカンマ区切りのリスト (末尾のカンマが許可される) (C99以降) であり、各要素は以下の形式を持ちます:

ここで

struct や union と同様に、列挙型と1つ以上の列挙定数を導入する宣言は、その型またはその型から派生した型の1つ以上のオブジェクトも宣言することができます。

enum color { RED, GREEN, BLUE } c = RED, *cp = &c;
// enum color型を導入
// 整数定数RED, GREEN, BLUE
// enum color型のオブジェクトc
// enum colorへのポインタ型のオブジェクトcp

説明

列挙指定子の本体に現れる各 enumeration-constant は、囲んでいるスコープで 整数定数 となり、その型は int (C23まで) です。これは整数定数が必要な場面（例えば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;
}

enumeration-constant の直後に = constant-expression が続く場合、その値はその定数式の値となります。 enumeration-constant の直後に = constant-expression が続かない場合、その値は同じ列挙型内の前の列挙子の値より1大きい値となります。最初の列挙子の値（ = constant-expression を使用しない場合）はゼロです。

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

identifier 自体が使用される場合、それはタグ name space 内の列挙型の名前となり、enumキーワードの使用を必要とします（typedefによって通常のname spaceに移されない限り）。

enum color { RED, GREEN, BLUE };
enum color r = RED; // OK
// color x = GREEN; // エラー: colorは通常の名前空間に存在しない
typedef enum color color_t;
color_t x = GREEN; // OK

固定された基底型を持たない列挙型 固定された基底型を持たない (C23以降) は、以下のいずれかと 互換 である： char 、符号付き整数型、または符号なし整数型 ( bool およびビット精度整数型を除く) (C23以降) 。どの型が特定の列挙型と互換であるかは実装定義であるが、どの型であってもその列挙のすべての列挙子の値を表現できなければならない。 固定された基底型を持つすべての列挙型について、列挙型はその列挙の基底型と互換である。 (C23以降)

列挙型は整数型であり、したがって他の整数型が使用できる場所であればどこでも使用できます。これには 暗黙的変換 および 算術演算子 も含まれます。

enum { ONE = 1, TWO } e;
long n = ONE; // プロモーション
double d = ONE; // 変換
e = 1.2; // 変換、eは現在ONE
e = e + 1; // eは現在TWO

注記

C言語では、 struct や union とは異なり、前方宣言された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; }; // こちらも有効

C23以降、 constexpr が同じ目的で使用できます：

constexpr int TEN = 10;
struct S { int x : TEN; }; // こちらも有効

さらに、C言語では struct または union はスコープを確立しないため、列挙型とその列挙定数は前者のメンバー指定内で導入することができ、それらのスコープは前者と同じになります。

struct Element
{
    int z;
    enum State { SOLID, LIQUID, GAS, PLASMA } state;
} oxygen = { 8, GAS };
// 列挙型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

参考文献

キーワード

enum

関連項目