Dispatcher IO in Kotlin

Introduction

Dispatcher IO 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.

Dispatchers.IO is optimized for blocking I/O operations. 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

• Dispatchers.IO is optimized for blocking I/O operations.
• Use for file, network and database tasks.
• It uses shared thread pool for I/O workloads.

Syntax

withContext(Dispatchers.IO) { }

Dispatcher IO in Kotlin Example Program in Kotlin

import kotlinx.coroutines.*

fun main(args: Array<String>) = runBlocking {
    val result = withContext(Dispatchers.IO) {
        delay(50)
        "IO result"
    }
    println(result)
}

Sample Output

IO result

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 result = withContext(Dispatchers.IO) { assigns or updates a value used later in the program.

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

4. Dispatchers.IO is optimized for blocking I/O operations.

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

• Dispatchers.IO is optimized for blocking I/O operations.
• Use for file, network and database tasks.
• It uses shared thread pool for I/O workloads.
• 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.