RunCatching for safe execution in Kotlin - Step-by-Step Execution

Concept Flow - RunCatching for safe execution

Start

↓

RunCatching block

↓

Try to execute code

↓

Success?

Yes→Return Success Result

↓

Catch Exception

↓

Return Failure Result

↓

Use Result safely

↓

End

RunCatching tries to run code safely, catching exceptions and returning a Result object that shows success or failure.

Execution Sample

Kotlin

val result = runCatching {
    val x = 10 / y
    "Result is $x"
}
println(result.getOrElse { "Error: ${it.message}" })

This code tries to divide 10 by y safely, catching any error and printing the result or error message.

Execution Table

Step	Action	Evaluation	Result
1	Enter runCatching block	Start code inside runCatching	No result yet
2	Evaluate 10 / y	If y=2, 10/2=5	5
3	Create string "Result is 5"	String formed	"Result is 5"
4	runCatching returns Success("Result is 5")	Success result	Success("Result is 5")
5	Call getOrElse on Success	Returns success value	"Result is 5"
6	Print output	Output to console	Result is 5
7	If y=0, division throws exception	Exception caught	Failure(ArithmeticException)
8	Call getOrElse on Failure	Returns fallback string	"Error: / by zero"
9	Print output	Output to console	Error: / by zero

💡 Execution stops after printing the result or error message.

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4	Final
y	2 or 0	2 or 0	2 or 0	2 or 0	2 or 0
x	undefined	5 or exception	5 or exception	5 or exception	5 or exception
result	undefined	undefined	undefined	Success or Failure	Success or Failure

Key Moments - 3 Insights

Why does runCatching not crash the program when division by zero happens?

Because runCatching catches the exception inside its block and returns a Failure result instead of letting the exception crash the program (see steps 7 and 8 in execution_table).

What does getOrElse do with the Result object?

getOrElse returns the success value if present, or the fallback value if the Result is a failure (see steps 5 and 8 in execution_table).

Is the code inside runCatching executed immediately or deferred?

It is executed immediately when runCatching is called, but safely inside a try-catch block (see step 2 in execution_table).

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of 'result' after step 4 when y=2?

A Success("Result is 5")

B Failure(ArithmeticException)

C "Result is 5"

D Exception thrown

💡 Hint

Check the 'Result' column at step 4 in execution_table.

At which step does runCatching catch an exception if y=0?

A Step 2

B Step 7

C Step 5

D Step 9

💡 Hint

Look for the step mentioning exception caught in execution_table.

If we change getOrElse fallback to "Oops", what will be printed when y=0?

A "Result is 5"

B "Error: / by zero"

C "Oops"

D Program crashes

💡 Hint

Check step 8 and 9 in execution_table where getOrElse fallback is used.

Concept Snapshot

runCatching { code } runs code safely.
Returns Result: Success(value) or Failure(exception).
Use getOrElse { fallback } to get value or fallback.
Prevents crashes from exceptions inside block.
Ideal for safe error handling.

Full Transcript

RunCatching in Kotlin lets you run code that might fail without crashing your program. It tries to run the code inside its block. If the code works, it returns a Success result with the value. If the code throws an exception, runCatching catches it and returns a Failure result with the exception. You can then use getOrElse on the Result to get the success value or provide a fallback value if there was an error. This way, your program stays safe and you handle errors gracefully.