How to use reflection to inspect type data

Swift version: 5.0

Paul Hudson    @twostraws    May 28th 2019

Swift has a built-in Mirror struct that lets us query any kind of data in our code. It’s most commonly used to read through the list of properties that are available, but it’s also used in playgrounds to print out user-readable values inside types.

To get started, first create a custom type then an instance of that type:

struct Person {
    var name = "Taylor Swift"
    var age = 26
}

var taylor = Person()

You can now instantiate a Mirror object from taylor, like this:

var mirror = Mirror(reflecting: taylor)

That mirror isn’t a copy of taylor, a reflection of it – something you can inspect. For example, you can loop over all the properties inside taylor and print out their names and values like this:

for case let (label?, value) in mirror.children {
    print (label, value)
}

Available from iOS 8.0

Similar solutions…

• How to use Dynamic Type to resize your app's text
• How to fix the error “protocol can only be used as a generic constraint because it has Self or associated type requirements”
• What is a protocol associated type?
• How to constrain a protocol associated type
• What is the Result type?

About the Swift Knowledge Base

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