enum class (Extensiones de componentes de C++)

Declara una enumeración, que es un tipo definido por el usuario que está compuesto de un conjunto de constantes con nombre llamadas enumeradores.

Todos los runtimes

Comentarios

C++/CX y C++/CLI admiten public enum class y private enum class que son similares a la clase enum estándar de C++ pero con la adición del especificador de accesibilidad.Para obtener más información acerca de la palabra clave estándar de C++ antigua, enum, vea Declaraciones de enumeración de C++.

Windows en tiempo de ejecución

Sintaxis

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

Parámetros

• access
  Accesibilidad de la enumeración, que puede ser public o private.

• identificador de enumeración
  Nombre de la enumeración.

• tipo subyacente
  (Opcional) Tipo de datos subyacente de la enumeración.

  (OpcionalSolo Windows en tiempo de ejecución) El tipo subyacente de la enumeración, que puede ser bool, char, char16, int16, uint16, int, uint32, int64 o uint64.

• enumerator-list
  Lista de nombres de enumerador separados con comas.

  El valor de cada enumerador es una expresión constante definida implícitamente por el compilador o explícitamente mediante la notación enumerador=expresión constante.De forma predeterminada, el valor del primer enumerador es cero si se define implícitamente.El valor de cada enumerador implícitamente definido subsiguiente es el valor del enumerador anterior + 1.

• var
  (Opcional) Nombre de una variable del tipo de enumeración.

Comentarios

Para obtener más información y ejemplos, vea Enumeraciones (C++/CX).

Observe que el compilador emite mensajes de error si la expresión constante que define el valor de un enumerador no se puede representar mediante el tipo subyacente.Sin embargo, el compilador no indica un error para un valor que es inadecuado para el tipo subyacente.Por ejemplo:

• Si underlying-type es numérico y un enumerador especifica el valor máximo para ese tipo, el valor de la siguiente enumeración definida implícitamente no se puede representar.

• Si underlying-type es bool y hay más de dos enumeradores definidos implícitamente, no se pueden representar los enumeradores después de los dos primeros.

• Si underlying-type es char16 y el valor de enumeración va de 0xD800 a 0xDFFF, el valor se puede representar.Sin embargo, el valor es lógicamente incorrecto porque representa la mitad del par suplente Unicode y no debe aparecer de forma aislada.

Requisitos

Opción del compilador: /ZW

Common Language Runtime

Sintaxis

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

Parámetros

• access
  Accesibilidad de la enumeración.Puede ser public o private.

• enumerator-list
  Una lista delimitada por comas de los identificadores (enumeradores) en la enumeración.

• name
  Nombre de la enumeración.Las enumeraciones administradas anónimas no se permiten.

• type (opcional)
  Tipo subyacente de identifiers.Puede tratarse de cualquier tipo escalar, como versiones con signo o sin signo de int, short o long.bool o char también se permite.

• var (opcional)
  Nombre de una variable del tipo de enumeración.

Comentarios

enum class y enum struct son declaraciones equivalentes.

Hay dos tipos de enumeraciones: administrada y estándar.

Una enumeración administrada puede definirse como sigue,

enum class day {sun, mon };

y es semánticamente equivalente a:

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

Una enumeración estándar puede definirse como sigue:

enum day2 {sun, mon, };

y es semánticamente equivalente a:

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

Los nombres de enumerador administrados (identificadores) no se insertan en el ámbito en el que está definida la enumeración; todas las referencias a los enumeradores deben estar completamente cualificadas (nombre::identificador).Por esta razón, no se puede definir una enumeración administrada anónima.

Los enumeradores de una enumeración estándar se insertan fuertemente en el ámbito de inclusión.Es decir, si hay otro símbolo con el mismo nombre que un enumerador en el ámbito de inclusión, el compilador generará un error.

En Visual C++ 2002 y Visual C++ 2003, los enumeradores insertados de forma poco rigurosa (visible en el ámbito de inclusión a menos que hubiera otro identificador con el mismo nombre).

Si se define una enumeración estándar de C++ (sin class o struct), la compilación con /clr hará que la enumeración se compile como una enumeración administrada.La enumeración todavía tiene la semántica de una enumeración no administrada.Nota: El compilador inserta un atributo, Microsoft::VisualC::NativeEnumAttribute, que el compilador de Visual C++ reconoce, para identificar la intención del programador de que la enumeración sea una enumeración nativa.Otros compiladores verán simplemente la enumeración estándar como enumeración administrada.

Una enumeración con nombre, estándar compilada con /clr estará visible en el ensamblado como una enumeración administrada y se puede utilizar en cualquier otro compilador administrado.Sin embargo, una enumeración estándar sin nombre no será visible de forma pública desde el ensamblado.

En Visual C++ 2002 y Visual C++ 2003, una enumeración estándar se utiliza como el tipo de un parámetro de función:

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

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

emitiría lo siguiente en MSIL para la firma de la función:

void f(int32);

Sin embargo, en las versiones actuales del compilador, la enumeración estándar se emite como enumeración administrada con [NativeEnumAttribute] y lo siguiente en MSIL para la signatura de la función:

void f(E)

Para obtener más información sobre enumeraciones nativas, vea Declaraciones de enumeración de C++.

En el entorno de desarrollo, puede obtener Ayuda de F1 para estas palabras clave resaltando la palabra clave, (enum class, por ejemplo) y presionando F1.

Para obtener más información acerca de las enumeraciones CLR, vea:

• Tipo subyacente de una enumeración

• Enumeraciones administradas y estándar

• Operadores y enumeraciones

Requisitos

Opción del compilador: /clr

Ejemplos

Ejemplo

Desc.

// 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)

Output

Vea también

Conceptos

Extensiones de componentes para plataformas de tiempo de ejecución