NEW: Start my new Ultimate Portfolio App course with a free Hacking with Swift+ trial! >>

How to add raw values to enums

Swift version: 5.2

Paul Hudson    @twostraws   

Raw values for enums are primitive values that sit behind each case. For example, you might create an enum for the planets in our solar system, and want to refer to each planet by a number as well as its name:

enum Planets: Int {
    case mercury
    case venus
    case earth
    case mars
} 

Swift will assign each case a raw integer value, starting from 0 and counting up. You can then use this to load and save the enum, or perhaps transfer it over the network.

You can provide custom raw values for any or all of your cases, and Swift will fill in the rest. For example, if we wanted mercury to be planet number 1, venus to be number 2, and so on, we could do this:

enum Planets: Int {
    case mercury = 1
    case venus
    case earth
    case mars
}

That will cause Swift to count upwards from 1.

If your raw value type is String, Swift will automatically create strings from each case name.

So, this:

enum Planets: String {
    case mercury
    case venus
    case earth
    case mars
}

Is equivalent to this:

enum Planets: String {
    case mercury = "mercury"
    case venus = "venus"
    case earth = "earth"
    case mars = "mars"
}

Finally, you can create enums from their raw value, but you get back an optional enum because your raw value might not match any of the available cases. For example, given our original Planets enum with integer raw values starting from 0, this would create an optional Planet pointing at Venus:

let venus = Planets(rawValue: 1)
Hacking with Swift is sponsored by Essential Developer

SPONSORED From January 26th to 31st you can join a FREE crash course for iOS devs who want to achieve an expert level of technical and practical skills – it’s the fast track to being a senior developer!

Save your spot now

Sponsor Hacking with Swift and reach the world's largest Swift community!

Available from iOS 8.0 – learn more in my book Pro Swift

Similar solutions…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

BUY OUR BOOKS
Buy Pro Swift Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift (Vapor Edition) Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Server-Side Swift (Kitura Edition) Buy Beyond Code

Was this page useful? Let us know!

Average rating: 5.0/5

 
Unknown user

You are not logged in

Log in or create account
 

Link copied to your pasteboard.