withContext Dispatcher in Kotlin

Introduction

withContext Dispatcher is a fundamental concept every Kotlin developer should understand. Dispatchers decide which thread pool runs coroutine code — Main for UI, IO for blocking work, and Default for CPU-bound tasks.

WithContext switches coroutine to another dispatcher and returns result. 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

• withContext switches coroutine to another dispatcher and returns result.
• Original context is restored after block completes.
• Useful for moving work off UI thread and back.

Syntax

withContext(Dispatchers.IO) { ... }

withContext Dispatcher in Kotlin Example Program in Kotlin

import kotlinx.coroutines.*

fun main(args: Array<String>) = runBlocking {
    val data = withContext(Dispatchers.Default) {
        "Processed data"
    }
    println(data)
}

Sample Output

Processed data

When to use

Switch dispatchers when moving between UI updates (Main) and blocking or CPU-heavy work (IO / Default).

How it works

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

2. val data = withContext(Dispatchers.Default) { assigns or updates a value used later in the program.

3. The println(data) statement writes a line to the console — this produces part of the sample output below.

4. WithContext switches coroutine to another dispatcher and returns result.

5. 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

• withContext switches coroutine to another dispatcher and returns result.
• Original context is restored after block completes.
• Useful for moving work off UI thread and back.
• Test the example locally and verify the output matches the sample.
• Experiment by changing input values to see how behaviour changes.

Notes

• Add the kotlinx-coroutines-core dependency when running coroutine examples outside Android or IntelliJ.
• Semicolons at the end of statements are optional in Kotlin.