enum クラス (C++ コンポーネント拡張)

  • [アーティクル]

列挙型を宣言します。列挙型とは、列挙子と呼ばれる一連の名前付き定数で構成されるユーザー定義型です。

All Runtimes

解説

C++/CX および C++/CLI は、public enum class と private enum class をサポートします。これは標準の C++ 列挙型クラスと似ていますが、アクセシビリティ指定子が追加されている点が異なります。C++ の従来の標準キーワードである enum の詳細については、「C++ の列挙の宣言」を参照してください。

Windows ランタイム

Syntax

access enum class enumeration-identifier [:underlying-type] { enumerator-list } [var];
access enum struct enumeration-identifier [:underlying-type] { enumerator-list } [var];

Parameters

  • access
    列挙型のアクセシビリティ。public または private を指定できます。

  • enumeration-identifier
    列挙型の名前。

  • underlying-type
    (省略可能) 列挙型の基になる型。

    (省略可能、Windows ランタイムのみ) 列挙型の基になる型。bool、char、char16、int16、uint16、int、uint32、int64、uint64 のいずれかを指定できます。

  • enumerator-list
    列挙子名のコンマ区切りのリスト。

    それぞれの列挙子の値は、コンパイラによって暗黙的に定義された定数式か、"列挙子=定数式" という表記で明示的に定義された定数式になります。既定では、最初の列挙子が暗黙的に定義されている場合、その値は 0 です。それ以降の暗黙的に定義された列挙子の値は、前の列挙子の値に 1 を加算した値になります。

  • var
    (省略可能) 列挙型の変数の名前。

解説

詳細および例については、「列挙型」を参照してください。

列挙子の値を定義する定数式が underlying-type で表すことができない場合、コンパイラはエラー メッセージを生成します。ただし、基になる型に対して値が不適切であるというエラーは生成されません。次に例を示します。

  • underlying-type が数値であり、列挙子がその型の最大値を指定する場合は、次に暗黙的に定義されている列挙型の値は表すことができません。

  • underlying-type が bool のときに、3 つ以上の列挙子が暗黙的に定義されている場合、最初の 2 つの列挙子より後の列挙子は表すことができません。

  • underlying-type が char16 のときに、列挙型の値が 0xD800 から 0xDFFF の範囲にある場合、その値を表すことができます。この値は Unicode サロゲート ペアの一方を表していますが、このペアは分離して表すことができないため、論理的にはこの値は正しくありません。

a6cskb49.collapse_all(ja-jp,VS.110).gif要件

Compiler option: /ZW

共通言語ランタイム

Syntax

access enum class name [:type] { enumerator-list } var;
access enum struct name [:type] { enumerator-list } var;

Parameters

  • access
    列挙型のアクセシビリティ。public または private を指定できます。

  • enumerator-list
    列挙型に含まれる識別子 (列挙子) のコンマ区切りのリスト。

  • name
    The name of the enumeration.匿名のマネージ列挙型は使用できません。

  • type (省略可能)
    識別子の基になる型。符号付きまたは符号なしの int、short、long など、任意のスカラー型を指定できます。bool または char も使用できます。

  • var (省略可能)
    列挙型の変数の名前。

解説

enum class と enum struct は同等の宣言です。

列挙型には、マネージ列挙型と標準列挙型の 2 種類があります。

マネージ列挙型は、たとえば次のように定義されます。

enum class day {sun, mon };

これは、次のコードと同じ意味です。

ref class day {
public:
   static const int sun = 0;
   static const int mon = 1;
};

標準列挙型は、たとえば次のように定義されます。

enum day2 {sun, mon, };

and is semantically equivalent to:

static const int sun = 0;
static const int mon = 1;

マネージ列挙子の名前 (識別子) は、列挙型が定義されるスコープに挿入されません。列挙子へのすべての参照が完全修飾名であることが必要です (名前::識別子)。そのため、匿名のマネージ列挙型は定義できません。

標準列挙型の列挙子は外側のスコープに厳密に挿入されます。そのため、列挙子と同じ名前を持つ別のシンボルが外側のスコープにある場合、コンパイラはエラーを生成します。

Visual C++ 2002 と Visual C++ 2003 では、列挙子は弱く挿入されていました (同じ名前の別の識別子が存在していない限り外側のスコープで参照可能)。

C++ 標準列挙型が定義されている (class も struct も指定されていない) 場合、/clr を指定してコンパイルすると、列挙型がマネージ列挙型としてコンパイルされます。この列挙型のセマンティクスはアンマネージ列挙型のままです。コンパイラはその列挙型をネイティブ列挙型にするというプログラマの意図を示すために、Visual C++ コンパイラが認識する Microsoft::VisualC::NativeEnumAttribute 属性を挿入します。他のコンパイラは、標準列挙型を単にマネージ列挙型として認識します。

/clr を指定してコンパイルされた名前付きの標準列挙型は、アセンブリでマネージ列挙型として参照可能であり、他のマネージ コンパイラでも実行できます。ただし、名前のない標準列挙体は、アセンブリからパブリックに参照することができません。

Visual C++ 2002 と Visual C++ 2003 では、標準列挙型は関数のパラメーターの型として使用されていました。

// mcppv2_enum.cpp
// compile with: /clr
enum E { a, b };
void f(E) {System::Console::WriteLine("hi");}

int main() {
   E myi = b;
   f(myi);
}

これは、関数のシグネチャに対応して MSIL に次の出力を行います。

void f(int32);

ただし、現在のバージョンのコンパイラでは、[NativeEnumAttribute] を指定すると標準列挙型がマネージ列挙型として出力され、関数のシグネチャに対応して MSIL に次の出力を行います。

void f(E)

ネイティブ列挙型の詳細については、「C++ 列挙体の宣言」を参照してください。

開発環境では、キーワード (enum class など) 選択して F1 キーを押すことで、そのキーワードに関する F1 ヘルプを表示できます。

CLR 列挙型の詳細については、次のページを参照してください。

a6cskb49.collapse_all(ja-jp,VS.110).gif要件

Compiler option: /clr

a6cskb49.collapse_all(ja-jp,VS.110).gif例

Example

説明

// mcppv2_enum_2.cpp
// compile with: /clr
// managed enum
public enum class m { a, b };

// standard enum
public enum n { c, d };

// unnamed, standard enum
public enum { e, f } o;

int main() {
   // consume managed enum
   m mym = m::b;
   System::Console::WriteLine("no automatic conversion to int: {0}", mym);
   System::Console::WriteLine("convert to int: {0}", (int)mym);

   // consume standard enum
   n myn = d;
   System::Console::WriteLine(myn);

   // consume standard, unnamed enum
   o = f;
   System::Console::WriteLine(o);
}Optionally, copy this sequence of tags for each example you want, then populate the text nodes. That is, after section+title("Examples")+content, insert: para+embeddedLabel ("Example")+para(sample description); code(sample); para+embeddedLabel("Output"); computerOutput(sample output, including 'br' tag instead of newlines)

出力

参照

概念

ランタイム プラットフォームのコンポーネントの拡張機能