Функция plusElement

Функция plusElement добавляет один элемент в коллекцию и возвращает новую коллекцию с добавленным элементом. Исходная коллекция при этом не изменяется. Функция работает для различных типов коллекций: List, Set, Array, Map и других. Для Map добавляется пара ключ-значение.

Импорт

kotlinimport kotlin.collections.plusElement

Синтаксис

kotlin// Для List, Set, Array
operator fun <T> Iterable<T>.plusElement(element: T): List<T>

kotlin// Для Map
operator fun <K, V> Map<out K, V>.plusElement(element: Pair<K, V>): Map<K, V>

Пример

Добавим элемент в список типа List:

kotlinval list = listOf('a', 'b', 'c')
val res = list.plusElement('d')
println(res)

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

kotlinList ['a', 'b', 'c', 'd']

Пример

Добавим элемент в множество типа Set:

kotlinval set = setOf(1, 2, 3)
val res = set.plusElement(4)
println(res)

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

kotlinSet [1, 2, 3, 4]

Пример

Добавим элемент в массив типа Array:

kotlinval arr = arrayOf("one", "two", "three")
val res = arr.plusElement("four")
println(res.contentToString())

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

kotlinArray<String> ['one', 'two', 'three', 'four']

Пример

Добавим пару ключ-значение в карту типа Map:

kotlinval map = mapOf(1 to "one", 2 to "two")
val res = map.plusElement(3 to "three")
println(res)

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

kotlinMap {1=one, 2=two, 3=three}

Пример

Исходная коллекция остается неизменной после вызова функции plusElement:

kotlinval original = listOf('a', 'b', 'c')
val newList = original.plusElement('d')

println("Original: $original")
println("New list: $newList")

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

kotlinOriginal: [a, b, c]
New list: [a, b, c, d]

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