Accessing elements safely in Kotlin

Introduction

Sometimes, when you get an item from a list or map, it might not be there. Accessing elements safely helps you avoid errors by checking first.

When you want to get a value from a map but aren't sure if the key exists.

When you want to get an item from a list but the index might be out of range.

When you want to avoid your program crashing due to missing elements.

When you want to provide a default value if the element is not found.

Syntax

Kotlin

val value = map[key] ?: defaultValue
val item = list.getOrNull(index) ?: defaultValue

The ?: operator is called the Elvis operator and provides a default if the left side is null.

getOrNull(index) returns the element at the index or null if the index is invalid.

Examples

Try to get key "c" from the map. Since it doesn't exist, print 0 instead.

Kotlin

val map = mapOf("a" to 1, "b" to 2)
val value = map["c"] ?: 0
println(value)

Try to get the 6th item (index 5). It's out of range, so print -1.

Kotlin

val list = listOf(10, 20, 30)
val item = list.getOrNull(5) ?: -1
println(item)

Get value for key "x" which exists, so print 100.

Kotlin

val map = mapOf("x" to 100)
val value = map["x"] ?: 0
println(value)

Sample Program

This program tries to get a fruit at index 3, which doesn't exist, so it prints "unknown". It also gets scores for Alice and Charlie. Alice's score exists, Charlie's does not, so it prints 0 for Charlie.

Kotlin

fun main() {
    val fruits = listOf("apple", "banana", "cherry")
    val fruit = fruits.getOrNull(3) ?: "unknown"
    println("Fruit at index 3: $fruit")

    val scores = mapOf("Alice" to 90, "Bob" to 85)
    val aliceScore = scores["Alice"] ?: 0
    val charlieScore = scores["Charlie"] ?: 0
    println("Alice's score: $aliceScore")
    println("Charlie's score: $charlieScore")
}

Important Notes

Using safe access avoids crashes from missing elements.

The Elvis operator ?: is very handy for providing fallback values.

getOrNull() works well with lists to avoid index errors.

Summary

Access elements safely to avoid errors when items might be missing.

Use map[key] ?: default to get values with a fallback.

Use list.getOrNull(index) ?: default to safely get list items.

Practice

1.

What does the Kotlin expression map[key] ?: "default" do?

easy

A. Removes the key from the map if it exists.

B. Returns the value for key if it exists, otherwise returns "default".

C. Throws an error if key is not in the map.

D. Always returns "default" regardless of key.

Solution

1. Step 1: Understand map access with []

   Accessing map[key] returns the value if key exists, or null if it doesn't.

2. Step 2: Use the Elvis operator ?: for fallback

   The expression ?: "default" means if the left side is null, return "default" instead.

3. Final Answer:

   Returns the value for key if it exists, otherwise returns "default". -> Option B

4. Quick Check:

   map[key] ?: default = safe access with fallback [OK]

Hint: Use ?: to provide a default when key might be missing [OK]

Common Mistakes:

• Thinking it throws an error if key is missing
• Assuming it always returns default
• Confusing with removing keys

2.

Which of the following is the correct Kotlin syntax to safely get the element at index 2 from a list myList, returning -1 if the index is out of bounds?

easy

A. myList.getOrNull(2) ?: -1

B. myList[2] ?: -1

C. myList.get(2) ?: -1

D. myList.getOrElse(2, -1)

Solution

1. Step 1: Understand safe list access methods

   myList.getOrNull(2) returns the element at index 2 or null if out of bounds.

2. Step 2: Use Elvis operator for default

   ?: -1 returns -1 if getOrNull returns null.

3. Final Answer:

   myList.getOrNull(2) ?: -1 -> Option A

4. Quick Check:

   getOrNull + ?: = safe get with fallback [OK]

Hint: Use getOrNull(index) ?: default for safe list access [OK]

Common Mistakes:

• Using myList[2] which throws exception if index invalid
• Using get(2) which throws exception if index invalid
• Confusing getOrElse syntax

3.

What is the output of this Kotlin code?

val map = mapOf("a" to 1, "b" to 2)
println(map["c"] ?: 0)

medium

A. null

B. 2

C. Exception thrown

D. 0

Solution

1. Step 1: Check map access for key "c"

   Key "c" does not exist in the map, so map["c"] returns null.

2. Step 2: Apply Elvis operator

   ?: 0 returns 0 because the left side is null.

3. Final Answer:

   0 -> Option D

4. Quick Check:

   map[missingKey] ?: default = default [OK]

Hint: Missing keys return null, use ?: for default [OK]

Common Mistakes:

• Expecting null to print instead of default
• Thinking exception is thrown
• Confusing existing key values

4.

Identify the error in this Kotlin code snippet and choose the corrected version:

val list = listOf(10, 20, 30)
val value = list[5] ?: -1
println(value)

medium

A. val value = list.get(5) ?: -1

B. val value = list[5]

C. val value = list.getOrNull(5) ?: -1

D. val value = list.getOrElse(5, -1)

Solution

1. Step 1: Understand list access with []

   Using list[5] throws an IndexOutOfBoundsException because index 5 is out of range.

2. Step 2: Use safe access method

   list.getOrNull(5) returns null if index is invalid, so combined with ?: -1 it safely returns -1.

3. Final Answer:

   val value = list.getOrNull(5) ?: -1 -> Option C

4. Quick Check:

   Use getOrNull + ?: to avoid exceptions [OK]

Hint: Replace [] with getOrNull + ?: for safe index access [OK]

Common Mistakes:

• Using [] which throws exception if index invalid
• Using get(5) which throws exception
• Confusing getOrElse syntax

5.

You have a map val scores = mapOf("Alice" to 90, "Bob" to 85) and a list val bonuses = listOf(5, 10). You want to safely get Bob's score and the bonus at index 2, returning 0 if missing, then sum them. Which code correctly does this?

hard

A. val total = (scores["Bob"] ?: 0) + (bonuses.getOrNull(2) ?: 0)

B. val total = (scores.getOrNull("Bob") ?: 0) + (bonuses.getOrNull(2) ?: 0)

C. val total = (scores["Bob"] ?: 0) + (bonuses[2] ?: 0)

D. val total = (scores["Bob"] ?: 0) + bonuses.get(2)

Solution

1. Step 1: Access map value safely

   scores["Bob"] ?: 0 safely gets Bob's score or 0 if missing.

2. Step 2: Access list element safely

   bonuses.getOrNull(2) ?: 0 safely gets bonus at index 2 or 0 if out of bounds.

3. Step 3: Sum the two values

   Adding these two safe values gives the total without errors.

4. Final Answer:

   val total = (scores["Bob"] ?: 0) + (bonuses.getOrNull(2) ?: 0) -> Option A

5. Quick Check:

   Safe map + safe list access with ?: for default [OK]

Hint: Use ?: with map and getOrNull for list to avoid errors [OK]

Common Mistakes:

• Using bonuses[2] which throws exception if index invalid
• Using getOrNull on map which is invalid
• Not providing default fallback