Функция removeFirst

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

Импорт

kotlinimport kotlin.collections.removeFirst

Синтаксис

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

kotlinval emptyList = mutableListOf<Int>()

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

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

kotlinError: List is empty.

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