How to throw errors using strings

Swift version: 5.0

Paul Hudson    @twostraws    March 28th 2019

Throwing functions in Swift are the main way we have of signaling that an operation failed, but sometimes it can be annoying to define a whole new error enum just to report a simple failure.

With a small extension to String you can make the whole process easier:

extension String: LocalizedError {
    public var errorDescription: String? { return self }
}

With that change you can now throw strings as errors, and they work just like regular errors. For example, you can create a throwing function like this one:

func doDangerousThing() throws {
    throw "I'm sorry, Dave, I can't do that."
}

Then attempt to run it and print any errors that are thrown, like this:

do {
    try doDangerousThing()
} catch {
    print(error.localizedDescription)
}

This only really works for errors that have one case, because you can’t match specific string errors.

Available from iOS 8.0

Did this solution work for you? Please pass it on!

Tweet

Other people are reading…

• How to check the Swift version at compile time
• How to find the longest initial sequence in an array
• What is a lazy sequence?
• How to convert an NSRange to a Swift string index
• How to use typealias to make it easier to use complex types

About the Swift Knowledge Base

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