How to Convert Interface to Struct Go

Hey! If you love Go and building Go apps as much as I do, let's connect on Twitter or LinkedIn. I talk about this stuff all the time!

Want to learn how to build better Go applications faster and easier? You can.

Check out my course on the Go Standard Library. You can check it out now for free.


Converting an interface to a struct is a fundamental operation that is often required in different programming tasks. So, if you’re looking to learn how to convert an interface to a struct in Golang, you’re in the right place.

Before diving into the code examples, let’s first understand the theory behind converting an interface to a struct in Golang.

In Golang, an interface is a type that defines a set of methods. An interface value can hold any value that implements the interface. On the other hand, a struct is a composite type that groups together zero or more values of different types. Converting an interface to a struct involves extracting the underlying value from the interface and then mapping it to the fields of a struct.

Golang provides two main methods for converting an interface to a struct. The first method is by using the type assertion operator “(type)” to extract the underlying value from the interface and then manually mapping it to the fields of a struct. The second method is by using the encoding/json package to marshal the interface value into a JSON object and then unmarshaling the JSON object into a struct.

Here’s an example of the first method:

package main

import (
    "fmt"
)

type Person struct {
    Name string
    Age  int
}

func main() {
    var x interface{} = Person{"John", 30}
    p, ok := x.(Person)
    if !ok {
        fmt.Println("Error: invalid type assertion")
        return
    }
    fmt.Println(p.Name, p.Age)
}

In the code above, we declare a struct called “Person” with two fields, “Name” and “Age”. We then declare an interface variable called “x” with a value of type “Person”. We use the type assertion operator “(Person)” to extract the underlying value from the interface and map it to a variable called “p” of type “Person”. We then print the “Name” and “Age” fields of the “p” variable using the fmt.Println() function.

Here’s an example of the second method:

package main

import (
    "encoding/json"
    "fmt"
)

type Person struct {
    Name string
    Age  int
}

func main() {
    var x interface{} = Person{"John", 30}
    b, err := json.Marshal(x)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    var p Person
    err = json.Unmarshal(b, &p)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    fmt.Println(p.Name, p.Age)
}

In the code above, we declare a struct called “Person” with two fields, “Name” and “Age”. We then declare an interface variable called “x” with a value of type “Person”. We use the json.Marshal() function to marshal the “x” variable into a JSON object and store the resulting byte slice in a variable called “b”. We then declare a variable called “p” of type “Person” and use the json.Unmarshal() function to unmarshal the “b” variable into the “p” variable. We then print the “Name” and “Age” fields of the “p” variable using the fmt.Println() function.

So why would someone want to convert an interface to a struct in Golang? One common use case is when working with data structures that contain values of different types. By converting the interface values to a struct, you can easily manipulate and access the values in a structured and organized way.

Another use case is when working with external APIs that return data in the form of an interface. By converting the interface to a struct, you can easily work with the data and manipulate it in a more structured way.

In conclusion, converting an interface to a struct in Golang is a fundamental operation that you’ll encounter frequently in your Golang programming journey. By using the type assertion operator or the encoding/json package, you can easily extract and map the underlying values of interface variables to struct fields. This can help you work with complex data structures and external APIs more efficiently.

I hope you found this tutorial helpful.


Questions or comments? Reach out to me


Learn how to leverage the Go Standard Library like a PRO.

I just created a new course, The Go Standard Library, check it out!