apply Scope Function in Kotlin

Introduction

apply Scope Function is a fundamental concept every Kotlin developer should understand. Scope functions (let, run, with, apply, also) execute a block in the context of an object, reducing nesting and improving readability.

Apply configures object using receiver block. 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

• apply configures object using receiver block.
• Returns the object itself, not lambda result.
• Useful for builder-style initialization.

Syntax

obj.apply { ... }

apply Scope Function in Kotlin Example Program in Kotlin

class User {
    var name = ""
    var age = 0
}

fun main(args: Array<String>) {
    val user = User().apply {
        name = "Arjun"
        age = 24
    }
    println("${user.name}, ${user.age}")
}

Sample Output

Arjun, 24

When to use

Use scope functions to configure objects, safely unwrap nullables, or chain transformations in a readable pipeline.

How it works

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

2. var name = "" assigns or updates a value used later in the program.

3. var age = 0 assigns or updates a value used later in the program.

4. val user = User().apply { assigns or updates a value used later in the program.

5. name = "Arjun" assigns or updates a value used later in the program.

6. age = 24 assigns or updates a value used later in the program.

7. The println("${user.name}, ${user.age}") statement writes a line to the console — this produces part of the sample output below.

8. Apply configures object using receiver block.

Best Practices

• Understand the core idea: apply configures object using receiver block.
• Prefer readable names and small functions so examples map directly to real projects.
• Run and modify the example — change values and observe how the output changes.

Common Mistakes

• Skipping the example and only reading the definition — hands-on practice cements the concept.
• Copying syntax without understanding nullable vs non-nullable types or scope rules.
• Ignoring compiler warnings that often point to safer alternatives.

Key Points

• apply configures object using receiver block.
• Returns the object itself, not lambda result.
• Useful for builder-style initialization.
• 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.