Функция removeFirst

Функция removeFirst удаляет и возвращает первый элемент из изменяемой коллекции. Работает с изменяемыми списками типа MutableList, массивами типа Array, множествами типа MutableSet и очередями типа ArrayDeque. Если коллекция пустая, функция выбрасывает исключение NoSuchElementException.

Импорт

import kotlin.collections.removeFirst

Синтаксис

// Для MutableList
fun <T> MutableList<T>.removeFirst(): T

// Для ArrayDeque
fun <T> ArrayDeque<T>.removeFirst(): T

// Для MutableSet
fun <T> MutableSet<T>.removeFirst(): T

Пример

Удалим первый элемент из изменяемого списка:

val list = mutableListOf('a', 'b', 'c', 'd', 'e')
val res = list.removeFirst()
println("Removed element: $res")
println("List after removal: $list")

Результат выполнения кода:

Removed element: a
List after removal: [b, c, d, e]

Пример

Удалим первый элемент из очереди ArrayDeque:

val deque = ArrayDeque(listOf(1, 2, 3, 4, 5))
val res = deque.removeFirst()
println("Removed element: $res")
println("Deque after removal: $deque")

Результат выполнения кода:

Removed element: 1
Deque after removal: [2, 3, 4, 5]

Пример

Удалим первый элемент из изменяемого множества:

val set = mutableSetOf("apple", "banana", "cherry")
val res = set.removeFirst()
println("Removed element: $res")
println("Set after removal: $set")

Результат выполнения кода:

Removed element: apple
Set after removal: [banana, cherry]

Пример

Попытка удалить первый элемент из пустой коллекции вызывает исключение:

val emptyList = mutableListOf<Int>()

try {
	val res = emptyList.removeFirst()
} catch (e: NoSuchElementException) {
	println("Error: ${e.message}")
}

Результат выполнения кода:

Error: List is empty.

Смотрите также

функцию removeFirstOrNull,
которая возвращает null вместо исключения для пустой коллекции
функцию removeLast,
которая удаляет и возвращает последний элемент коллекции
функцию remove,
которая удаляет конкретный элемент из коллекции
функцию first,
которая возвращает первый элемент без удаления