How to create a custom debug description

Paul Hudson    March 3rd 2018    @twostraws

Swift lets you print all types of data, but some data is more useful than others thanks to the CustomDebugStringConvertible protocol. If you write a type conforming to that protocol, you must include a debugDescription string property that describes how instances of this type should be represented while debugging.

To test this out, we’re going to create a Player struct that stores a player’s name. When we try to debug an instance of this struct – i.e., print it out, or hover over it in the debugger – we just want the player’s name to come back, for easier debugging.

Try adding this struct to a playground:

struct Player: CustomDebugStringConvertible {
    var name: String = "@twostraws"

    var debugDescription: String {
        return name
    }
}

You can now create instances of that struct and print them out to see the player name:

let player = Player()
print(player)

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

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

Tweet

Other people are reading…

• How to fix “argument of #selector refers to instance method that is not exposed to Objective-C”
• How to fix the error “protocol can only be used as a generic constraint because it has Self or associated type requirements”
• What’s the difference between a function and a closure?
• What is a dictionary?
• How to use one-sided ranges

About the Swift Knowledge Base

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