[iOS / Swift] Enum이란?

열거형 (Enum)

열거형(Enum)은 연관된 값들을 하나의 타입으로 묶어 표현하는 자료형입니다.

 

Swift에서는 단순한 값 목록을 넘어, 타입 안정성과 표현력을 모두 갖춘 구조로 사용되며,

각 case는 독립적인 값으로 동작하고 필요에 따라 연관값(Associated Value) 을 저장할 수 있습니다.

 

그렇다면 왜 열거형을 사용할까요?

열거형은 비슷한 성격의 여러 값을 하나의 범주로 묶어 코드의 의미를 명확히 하고, 잘못된 값이 저장되는 것을 방지할 수 있습니다.

 

또한 Enum은 메서드를 정의하거나 프로토콜을 채택할 수 있는 확장 가능한 타입으로,

프로그램의 상태나 종류를 명확하게 구분하고 코드를 안전하게 유지하는 데 활용됩니다!

 

🍎 열거형을 사용하는 이유

열거형을 사용하지 않고 단순히 String이나 Int로 상태를 저장하면, 잘못된 입력이나 오타로 인한 오류가 발생할 가능성이 큽니다.

예를 들어, 하이링구얼(Hilingual) 앱에서 iOS 파트의 팀원을 관리한다고 가정해보겠습니다.

let iosMember1 = "zero"
let iosMember2 = "one"
let iosMember3 = "tew" // 오타 발생

 

이처럼 문자열로 관리할 경우 "yaungjuuu"처럼 오타가 나도 컴파일러는 오류를 인식하지 못합니다.

이런 문제는 런타임 시점에서야 드러나기 때문에 유지보수에 불리합니다.

 

그렇다면 열거형을 사용하면 어떨까요?

미리 정의된 값만 선택할 수 있으므로 오타나 잘못된 입력이 원천적으로 차단됩니다!

또한 코드의 의미가 명확해져 가독성과 안정성을 동시에 확보할 수 있습니다.

 

예시를 한번 살펴봅시다.

enum IosMember {
    case zero
    case one
    case two
}

var member: IosMember = .zero

 

이제 member에는 .youngseo, .nayeon, .youngju 외의 값은 들어갈 수 없습니다.

Swift의 타입 시스템이 컴파일 단계에서 값을 검사하므로, 잘못된 입력은 즉시 오류로 처리되겠죠.

즉, 열거형은 정해진 선택지 안에서만 안전하게 값을 다루도록 보장하는 자료형임을 알 수 있습니다.

 

🍎 원시값 (Raw Value)

1. 원시값이 없는 열거형

원시값이란 각 case에 고정된 기본값을 지정하는 것을 말합니다.

원시값이 없는 열거형은 그중에서도 가장 단순한 형태로, 각 case에 별도의 값을 지정하지 않습니다.

 

즉, 아래처럼 단순히 상태나 단계만 구분할 때 사용하는 열거형입니다.

enum HomeViewState {
    case idle        // 아무 동작도 없는 상태
    case loading     // 데이터 로딩 중
    case success     // 불러오기 성공
    case failure     // 불러오기 실패
}

 

위 코드를 쉼표를 이용하여 한 줄로 표현할 수도 있습니다!

enum HomeViewState { case idle, loading, success, failure }

 

사용 예시는 다음과 같습니다.

var currentState: HomeViewState = .loading

 

이처럼 열거형 자체가 하나의 타입으로 인식되며, . 문법을 통해 미리 정의된 case만 접근할 수 있습니다.

의도치 않은 값의 대입이 불가능하니 오류를 줄일 수 있겠죠!

 

2. 원시값이 있는 열거형

열거형의 각 case에 기본값을 지정할 수도 있습니다.

이때 지정되는 값이 원시값이며, 모든 case가 동일한 타입의 값 을 가져야 합니다.

 

Swift에서 Raw Value로 사용할 수 있는 타입은 Int, Character, String 세 가지입니다.

하나하나 차례대로 알아볼게요!

(1) Int형 원시값

가장 자주 사용되는 형태로, Raw Value를 Int로 지정하면 컴파일러가 첫 번째 case부터 0부터 시작해 1씩 자동으로 증가시킵니다.

enum HTTPStatusCode: Int {
    case success
    case badRequest
    case unauthorized
    case notFound
}

 

위의 예시에서 success는 0, badRequest는 1, unauthorized는 2, notFound는 3입니다.

 

아래처럼 직접 값을 지정할 수도 있습니다.

enum HTTPStatusCode: Int {
    case success = 200
    case badRequest = 400
    case unauthorized = 401
    case notFound = 404
}

 

그렇다면, 마지막 case에 값을 지정하지 않으면 어떻게 될까요?

enum HTTPStatusCode: Int {
    case success = 200
    case badRequest = 400
    case unauthorized = 401
    case notFound
}

 

답은 402입니다!  컴파일러는 지정된 case 이후의 값이 없으면 이전 case의 Raw Value에 +1을 자동으로 더해줍니다.

따라서 notFound에는 401 다음 값인 402가 들어가게 되는거죠.

⚠️ 만약 Raw Value 타입이 Double이나 Float이라면,컴파일러는 자동으로 “이전 값 + 1”을 계산할 수 없습니다.
따라서 모든 case에 대해 값을 직접 지정해야 합니다. 그렇지 않으면 “Cannot infer raw value” 에러가 발생해요!

 

(2) Character형 원시값

Character 타입은 모든 case에 직접 값을 지정해야 합니다.

하나라도 생략되면 컴파일 에러가 발생합니다.

enum ShortcutKey: Character {
    case save = "S"
    case open = "O"
    case quit = "Q"
}

 

이 경우 ShortcutKey.save.rawValue는 "S"입니다.

⚠️ Character 타입은 문자 단위로만 저장되므로, 컴파일러가 자동으로 값을 증가시킬 수 없습니다.
"A" 다음 "B"로 넘어가는 식의 계산은 불가능합니다.

 

(3) String형 원시값

String 타입은 Character와 달리 Raw Value를 생략하면 case 이름이 그대로 문자열 값으로 자동 지정됩니다.

enum APIEndpoint: String {
    case diaryList
    case userProfile
    case updateNickname
}

• APIEndpoint.diaryList.rawValue → "diaryList"
• APIEndpoint.userProfile.rawValue → "userProfile"

이 방식은 서버 통신 시 엔드포인트 이름이나 리소스 경로를 표현할 때 자주 사용되는데요~

case 이름과 실제 문자열 값이 일치하므로, 오타를 방지하면서도 코드를 더 깔끔하게 유지할 수 있겠죠!

 

3. Raw Value 접근 및 초기화

열거형에 지정한 원시값(Raw Value)은 rawValue 속성을 통해 쉽게 꺼낼 수 있습니다.

enum Fruit: String {
    case apple
    case banana
    case orange
}

print(Fruit.banana.rawValue) // "banana"

 

이렇게 하면 banana case의 문자열 값 "banana"가 출력됩니다.

 

Raw Value를 이용해 열거형 인스턴스를 생성할 수도 있습니다.

즉, 문자열을 통해 해당 case를 찾아 만드는 방식입니다.

let selectedFruit = Fruit(rawValue: "orange")
print(selectedFruit) // Optional(Fruit.orange)

 

"orange"가 실제 존재하는 case이기 때문에 정상적으로 인스턴스가 만들어집니다.

 

다만, 존재하지 않는 값을 전달하면 nil이 반환됩니다.

let invalidFruit = Fruit(rawValue: "melon")
print(invalidFruit) // nil

 

그래서 Raw Value를 통한 초기화의 반환 타입은 항상 옵셔널(Optional) 입니다!

존재하지 않는 값이 들어올 수도 있기 때문에, Swift에서는 프로그램이 멈추지 않고 안전하게 처리할 수 있도록 옵셔널 형태로 반환한답니다.

 

🍎 연관값 (Associated Values)

Raw Value는 모든 case가 같은 타입의 값을 가집니다.

하지만 실제로는 case마다 서로 다른 정보를 함께 저장해야 하는 경우가 있죠.

 

예를 들어, 음식 주문 상황을 생각해볼까요? 음식마다 추가 옵션이 다를 수 있습니다.

피자는 사이즈가 필요하고, 음료는 얼음 유무가 필요하겠죠?

 

이럴 때 사용하는 게 바로 연관값(Associated Values) 입니다.

연관값은 각 case에 필요한 데이터를 함께 저장할 수 있습니다!

 

1. 연관값 선언

case 옆 괄호 안에, 그 case에 필요한 정보를 담을 수 있습니다.

enum Order {
    case pizza(size: String)
    case drink(ice: Bool)
    case dessert(name: String)
}

 

2. 연관값 인스턴스 생성

case를 생성할 때 괄호 안에 값을 넣어주면 됩니다.

let order1 = Order.pizza(size: "L")
let order2 = Order.drink(ice: true)
let order3 = Order.dessert(name: "cheesecake")

 

이제 각 주문은 하나의 타입(Order) 안에서 서로 다른 정보를 가지고 있게 되겠죠.

 

3. Switch문으로 값 꺼내기

switch문을 사용해 각 case의 값을 꺼내서 쓸 수 있습니다.

switch order2 {
case .pizza(let size):
    print("피자 사이즈는 \\(size)입니다.")
case .drink(let ice):
    print(ice ? "얼음 있는 음료 주문" : "얼음 없는 음료 주문")
case .dessert(let name):
    print("디저트: \\(name)")
}

 

4. if-case 구문

특정 case만 확인하고 싶을 땐 if case가 편리합니다.

if case let .pizza(size) = order1 {
    print("주문한 피자 사이즈: \\(size)")
}

 

이처럼 연관값은 case마다 다른 데이터를 함께 저장할 수 있는 기능입니다.

같은 타입 안에서도 여러 형태의 정보를 표현할 수 있으니, 상황을 더 직관적이고 안전하게 다룰 수 있겠죠?

 

🍎 프로토콜을 채택하는 열거형

Swift의 열거형도 class나 struct처럼 프로토콜을 채택할 수 있습니다.

즉, 열거형도 특정 기능을 미리 정의된 규칙에 맞춰 사용할 수 있다는 뜻입니다.

 

가장 많이 사용되는 예시가 바로 CaseIterable 프로토콜입니다.

CaseIterable은 열거형의 모든 case를 자동으로 모아주는 배열 allCases를 제공하는 프로토콜인데요.

이 프로토콜을 채택하면 열거형 안의 case들을 하나씩 순회할 수 있습니다.

 

예시를 한번 살펴봅시다!

enum StudyTopic: CaseIterable {
    case swift
    case compose
    case spring
    case design
}

for topic in StudyTopic.allCases {
    print(topic)
}

 

출력 결과은 아래와 같습니다.

swift
compose
spring
design

 

이렇게 allCases 배열을 통해 case를 순서대로 꺼낼 수 있습니다.

따라서 메뉴 목록, 탭 이름, 스터디 주제처럼 정해진 항목을 한 번에 다뤄야 할 때 유용하게 쓸 수 있겠죠!

 

⚠️ 단, CaseIterable은 연관값이 없는 열거형에서만 사용할 수 있습니다.
각 case에 저장된 데이터(연관값)가 다르면, Swift가 allCases 배열을 자동으로 생성할 수 없기 때문입니다.