Функция minusElement

Функция minusElement удаляет один экземпляр указанного элемента из коллекции и возвращает новую коллекцию. Если элемент не найден в коллекции, возвращается исходная коллекция без изменений. Функция доступна для массивов, списков, множеств и других типов коллекций.

Синтаксис

// Для Array
fun <T> Array<out T>.minusElement(element: T): List<T>

// Для List
fun <T> Iterable<T>.minusElement(element: T): List<T>

// Для Set
fun <T> Set<T>.minusElement(element: T): Set<T>

// Для Map
fun <K, V> Map<out K, V>.minusElement(element: Entry<K, V>): Map<K, V>

Пример

Удаление элемента из массива:

val arr = arrayOf('a', 'b', 'c', 'd', 'e')
val res = arr.minusElement('c')
println(res)

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

List ['a', 'b', 'd', 'e']

Пример

Удаление элемента из списка:

val list = listOf(1, 2, 3, 4, 5)
val res = list.minusElement(3)
println(res)

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

List [1, 2, 4, 5]

Пример

Удаление элемента из множества:

val set = setOf('a', 'b', 'c', 'd', 'e')
val res = set.minusElement('c')
println(res)

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

Set ['a', 'b', 'd', 'e']

Пример

Удаление элемента из отображения (Map):

val map = mapOf("a" to 1, "b" to 2, "c" to 3)
val elementToRemove = map.entries.first { it.key == "b" }
val res = map.minusElement(elementToRemove)
println(res)

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

Map {a=1, c=3}

Пример

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

val list = listOf(1, 2, 3, 4, 5)
val res = list.minusElement(10)
println(res)

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

List [1, 2, 3, 4, 5]

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

функцию minus,
которая удаляет все вхождения элемента
функцию plusElement,
которая добавляет элемент в коллекцию
функцию filter,
которая фильтрует элементы по условию
функцию remove,
которая удаляет элемент из изменяемой коллекции