Enum type
Peponi │ 11/18/2024 │ 5m
C#
SyntaxTypeenum
Enum type
11/18/2024
5m
Peponi
C#
SyntaxTypeenum
1. Introduction
enum (열거형) 은 기본적으로 int 형식으로 만들어진 정수 숫자 형식이다. enum은 int 뿐만 아니라 다른 정수 숫자 형식 (short, long 등) 을 이용하여 정의할 수 있다. 정수 숫자 형식의 값을 가지는 만큼, enum에 정의되어 있지 않더라도 기본값은 0이다.
2. enum 정의
기본적인 enum의 정의 방법은 아래와 같다.
enum StatusCode
{
Idle, // 0
Run, // 1
Error // 2
}enum StatusCode
{
Idle = 10,
Run, // 11
Error = 1000
}enum StatusCode : byte // byte : 0 ~ 255
{
Idle = 10,
Run = 100,
Error = 1000 // CS0031 : '1000' 상수 값을 'byte'(으)로 변환할 수 없습니다.
}3. enum 초기화
아래와 같은 방법으로 enum을 초기화 할 수 있다.
enum StatusCode
{
Idle = 10,
Run = 100,
Error = 1000
}
StatusCode code = (StatusCode)10;
StatusCode code2 = StatusCode.Run;
// enum에는 0이 정의되지 않았지만, 0이 기본값이다.
StatusCode code3 = default; // 0
// enum 정의 외 정수를 할당할 수도 있다. 이 경우, 매칭되는 키가 없어 값이 키가 된다.
// 비트 플래그 사용 시 이런 식으로 쓰기도 한다.
StatusCode code4 = (StatusCode)1;4. enum 비트 플래그
enum의 경우 비트 연산자 (|, &)를 통해 선택 및 조합이 가능하다. 해당 기능을 사용하려면 enum 선언 시 [Flags] 특성과 함께 2의 제곱 형태로 값을 정의한다. enum의 기본값이 0이기 때문에, 0 값은 None, Empty 등으로 지정해주는 것이 좋다.
[Flags]
enum StatusCode
{
None = 0, // 0
Idle = 1, // 1
Run = 2, // 2
Warning = 4, // 4
Error = 8 // 8
}[Flags]
enum StatusCode
{
None = 0b_0, // 0
Idle = 0b_1, // 1
Run = 0b_10, // 2
Warning = 0b_100, // 4
Error = 0b_1000 // 8
}StatusCode code = StatusCode.Idle | StatusCode.Warning | StatusCode.Error; // 13
Console.WriteLine(code); // Idle, Warning, Error
code = (StatusCode)13;
Console.WriteLine(code); // Idle, Warning, Error5. enum 변환
enum은 정수 형식과 상호 명시적 변환이 가능하다. enum을 정수 형식으로 변환하는 경우, 키에 매칭되는 값으로 반환된다. 또한 enum에는 ToString() 메서드가 있어 호출 시 매칭되는 키가 반환된다.
[Flags]
enum StatusCode
{
None = 0, // 0
Idle = 1, // 1
Run = 2, // 2
Warning = 4, // 4
Error = 8 // 8
}
StatusCode code = (StatusCode)2;
string keyValue = code.ToString(); // 키 반환 : Run
int codeValue = (int)code; // 값 반환 : 2아래는 string을 enum으로 변환하거나 정의 여부를 조회하는 방법 이다.
[Flags]
enum StatusCode
{
None = 0, // 0
Idle = 1, // 1
Run = 2, // 2
Warning = 4, // 4
Error = 8 // 8
}
// string 변환 방법
string key = "Warning";
StatusCode code = code = Enum.Parse<StatusCode>("Warning"); // 키가 정의되어 있지 않은 경우 예외가 발생한다.
bool isSuccess = Enum.TryParse<StatusCode>("Warning", out StatusCode code2);
// 정의 여부 조회
bool isDefined = Enum.IsDefined(typeof(StatusCode), "Hello"); // false