Data Class Destructuring in Kotlin

Introduction

Data Class Destructuring is a fundamental concept every Kotlin developer should understand. Data classes auto-generate equals, hashCode, toString, and copy for model types — ideal for DTOs, API payloads, and domain objects.

Destructuring splits a data class into component variables. In this tutorial you will learn the syntax, walk through a complete example program, study the sample output, and review best practices so you can apply the concept confidently in your own projects.

Definition

• Destructuring splits a data class into component variables.
• Component functions component1(), component2() are generated automatically.
• Useful in for loops and assignments.

Syntax

val (id, name) = student

Data Class Destructuring in Kotlin Example Program in Kotlin

data class Point(val x: Int, val y: Int)

fun main(args: Array<String>) {
    val point = Point(10, 20)
    val (x, y) = point
    println("x=$x, y=$y")
}

Sample Output

x=10, y=20

When to use

Use data classes for immutable value objects where structural equality and copy-with-modifications matter.

How it works

1. The program starts with a main function — the entry point that runs when you execute the file.

2. val point = Point(10, 20) assigns or updates a value used later in the program.

3. val (x, y) = point assigns or updates a value used later in the program.

4. The println("x=$x, y=$y") statement writes a line to the console — this produces part of the sample output below.

5. Destructuring splits a data class into component variables.

6. Run the program in IntelliJ IDEA, Android Studio, or with the Kotlin command-line compiler (kotlinc / kotlin). Compare your console output with the sample output shown below.

Best Practices

Common Mistakes

Key Points

• Destructuring splits a data class into component variables.
• Component functions component1(), component2() are generated automatically.
• Useful in for loops and assignments.
• Test the example locally and verify the output matches the sample.
• Experiment by changing input values to see how behaviour changes.

Notes

• Semicolons at the end of statements are optional in Kotlin.