Suspend functions concept in Kotlin

Introduction

Suspend functions let your program pause and wait without blocking everything else. This helps your app stay smooth and fast.

When you want to fetch data from the internet without freezing the screen.

When you need to read or write files but don't want the app to stop working.

When you want to wait for a timer or delay without blocking other tasks.

When you want to run long tasks but keep the app responsive.

When you want to handle multiple tasks at the same time easily.

Syntax

Kotlin

suspend fun functionName(parameters): ReturnType {
    // code that can pause
}

Use the suspend keyword before fun to mark a function as suspend.

Suspend functions can only be called from other suspend functions or coroutine builders.

Examples

A simple suspend function that returns a string after some work.

Kotlin

suspend fun fetchData(): String {
    // pretend to get data
    return "Data received"
}

This suspend function waits for 1 second without blocking, then prints a message.

Kotlin

suspend fun waitAndPrint() {
    kotlinx.coroutines.delay(1000) // pause for 1 second
    println("Done waiting")
}

Sample Program

This program shows how to call a suspend function greet inside runBlocking. It pauses inside greet without freezing the whole program.

Kotlin

import kotlinx.coroutines.*

suspend fun greet() {
    delay(500) // pause for half a second
    println("Hello from suspend function!")
}

fun main() = runBlocking {
    println("Start")
    greet() // call suspend function
    println("End")
}

Important Notes

Suspend functions do not create new threads by themselves; they just let the current task pause.

You need a coroutine builder like runBlocking or launch to call suspend functions from normal code.

Summary

Suspend functions let your code pause and resume without blocking.

Use suspend keyword before fun to create them.

Call suspend functions only from coroutines or other suspend functions.

Practice

1. What is the main purpose of a suspend function in Kotlin?

easy

A. To mark the function as deprecated

B. To make the function run faster by using multiple threads

C. To allow the function to pause and resume without blocking the thread

D. To convert the function into a lambda expression

Solution

1. Step 1: Understand what suspend functions do

   Suspend functions let the program pause execution at some point and resume later without blocking the thread.

2. Step 2: Compare options with this behavior

   Only To allow the function to pause and resume without blocking the thread describes this pausing and resuming behavior correctly.

3. Final Answer:

   To allow the function to pause and resume without blocking the thread -> Option C

4. Quick Check:

   Suspend function purpose = pause and resume without blocking [OK]

Hint: Suspend means pause and resume without blocking [OK]

Common Mistakes:

• Thinking suspend means multithreading
• Confusing suspend with deprecated functions
• Assuming suspend converts functions to lambdas

2. Which of the following is the correct way to declare a suspend function in Kotlin?

easy

A. fun suspend fetchData() { }

B. fun fetchData() suspend { }

C. suspend fetchData fun() { }

D. suspend fun fetchData() { }

Solution

1. Step 1: Recall suspend function syntax

   The correct syntax places the suspend keyword before fun.

2. Step 2: Check each option

   Only suspend fun fetchData() { } matches the correct syntax: suspend fun fetchData() { }.

3. Final Answer:

   suspend fun fetchData() { } -> Option D

4. Quick Check:

   Suspend function syntax = suspend before fun [OK]

Hint: Remember: suspend keyword comes before fun [OK]

Common Mistakes:

• Placing suspend after fun
• Putting suspend after function name
• Mixing order of keywords

3. What will be the output of the following Kotlin code?

import kotlinx.coroutines.*
suspend fun greet() {
    delay(100)
    println("Hello from suspend")
}
fun main() = runBlocking {
    greet()
    println("Done")
}

medium

A. Hello from suspend\nDone

B. Done\nHello from suspend

C. Compilation error because greet() is suspend

D. Runtime error because delay() is not allowed here

Solution

1. Step 1: Understand runBlocking and suspend call

   runBlocking starts a coroutine and allows calling suspend functions like greet().

2. Step 2: Trace execution order

   greet() delays 100ms, then prints "Hello from suspend". After greet() finishes, main prints "Done".

3. Final Answer:

   Hello from suspend\nDone -> Option A

4. Quick Check:

   Output order = greet() then Done [OK]

Hint: runBlocking lets you call suspend functions directly [OK]

Common Mistakes:

• Assuming greet() runs asynchronously and prints after Done
• Thinking delay causes errors outside coroutine
• Confusing suspend function calls outside coroutines

4. Identify the error in this Kotlin code snippet:

fun fetchData() {
    delay(1000)
    println("Data fetched")
}

medium

A. delay() cannot be called from a non-suspend function

B. println() is not allowed inside functions

C. fetchData() must return a value

D. delay() requires an integer argument, 1000 is invalid

Solution

1. Step 1: Check usage of delay()

   delay() is a suspend function and can only be called from suspend functions or coroutines.

2. Step 2: Analyze fetchData() declaration

   fetchData() is a regular function without suspend keyword, so calling delay() inside causes an error.

3. Final Answer:

   delay() cannot be called from a non-suspend function -> Option A

4. Quick Check:

   delay() call requires suspend function context [OK]

Hint: delay() only works inside suspend functions [OK]

Common Mistakes:

• Thinking delay() works in normal functions
• Believing println() is restricted
• Confusing delay() argument type

5. You want to write a suspend function fetchUserData() that calls another suspend function fetchFromNetwork() and returns its result. Which of the following is the correct way to implement fetchUserData()?

hard

A. fun fetchUserData() = fetchFromNetwork()

B. suspend fun fetchUserData() = fetchFromNetwork()

C. fun suspend fetchUserData() = fetchFromNetwork()

D. suspend fun fetchUserData() { fetchFromNetwork() }

Solution

1. Step 1: Recognize suspend function chaining rules

   A suspend function calling another suspend function must itself be marked suspend.

2. Step 2: Check each option's syntax and behavior

   suspend fun fetchUserData() = fetchFromNetwork() correctly declares fetchUserData() as suspend and returns fetchFromNetwork() result. The option with suspend fun fetchUserData() { fetchFromNetwork() } misses returning the result. The remaining options have incorrect syntax.

3. Final Answer:

   suspend fun fetchUserData() = fetchFromNetwork() -> Option B

4. Quick Check:

   Calling suspend inside suspend requires suspend keyword [OK]

Hint: Suspend functions calling suspend must also be suspend [OK]

Common Mistakes:

• Omitting suspend keyword on calling function
• Using wrong suspend syntax order
• Not returning the result from called suspend function