Kotlin Array first Function

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

The first function in Kotlin is used to return the first element of an array that matches a given predicate. If no predicate is provided, it returns the first element of the array. This function is part of the Kotlin standard library and provides a simple way to access elements from the beginning of an array.

Introduction
first Function Syntax
Understanding first
Examples
- Basic Usage
- Using first with a Condition
- Handling Empty Arrays
- Using first with Custom Types
Real-World Use Case
Conclusion

Introduction

The first function is used to return the first element of an array, either unconditionally or based on a given condition. If no such element is found when a condition is provided, or if the array is empty when no condition is provided, it throws an exception.

first Function Syntax

The syntax for the first function is as follows:

fun <T> Array<out T>.first(): T
fun <T> Array<out T>.first(predicate: (T) -> Boolean): T

Parameters:

predicate: A lambda function that takes an element of type T and returns true if the element matches the condition, false otherwise (optional).

Returns:

The first element of the array or the first element that matches the predicate.

Throws:

NoSuchElementException if no element is found that matches the predicate, or if the array is empty when no predicate is provided.

Understanding first

The first function provides a convenient way to access elements from the beginning of an array. When used without a predicate, it returns the very first element. When used with a predicate, it returns the first element that matches the given condition.

Examples

Basic Usage

To demonstrate the basic usage of first, we will create an array of integers and return the first element.

Example

fun main() {
    val numbers = arrayOf(1, 2, 3, 4, 5)
    val firstNumber = numbers.first()
    println("First element: $firstNumber")
}

Output:

First element: 1

Using `first` with a Condition

This example shows how to use first to return the first element that matches a given condition.

Example

fun main() {
    val numbers = arrayOf(1, 2, 3, 4, 5)
    val firstEvenNumber = numbers.first { it % 2 == 0 }
    println("First even element: $firstEvenNumber")
}

Output:

First even element: 2

Handling Empty Arrays

This example demonstrates how to handle cases where the array is empty.

Example

fun main() {
    val emptyArray = emptyArray<Int>()
    try {
        val firstElement = emptyArray.first()
        println("First element: $firstElement")
    } catch (e: NoSuchElementException) {
        println("Error: ${e.message}")
    }
}

Output:

Error: Array is empty.

Using `first` with Custom Types

This example shows how to use first with an array of custom objects.

Example

data class Person(val name: String, val age: Int)

fun main() {
    val people = arrayOf(
        Person("Ravi", 25),
        Person("Anjali", 30),
        Person("Priya", 22)
    )

    val firstPersonAbove25 = people.first { it.age > 25 }
    println("First person above 25: $firstPersonAbove25")
}

Output:

First person above 25: Person(name='Anjali', age=30)

Real-World Use Case

Finding the First Active User

In real-world applications, the first function can be used to find the first element that matches a specific condition, such as finding the first active user in a list.

Example

data class User(val name: String, val isActive: Boolean)

fun main() {
    val users = arrayOf(
        User("Ravi", false),
        User("Anjali", true),
        User("Priya", true)
    )

    val firstActiveUser = users.first { it.isActive }
    println("First active user: $firstActiveUser")
}

Output:

First active user: User(name='Anjali', isActive=true)

Conclusion

The first function in Kotlin is a convenient method for accessing the first element of an array, either unconditionally or based on a given predicate. It provides a simple way to retrieve elements from the beginning of an array and can be useful for filtering and finding elements based on specific conditions. By understanding and using this function, you can effectively manage element access operations in your Kotlin applications.

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Spring Boot + RabbitMQ Course - The Practical Guide