Функция plus
Функция plus выполняет объединение двух коллекций,
возвращая новую коллекцию, содержащую все элементы
из исходной коллекции и все элементы из переданной
в параметре коллекции. Исходные коллекции при этом
не изменяются. Функция работает с массивами Array,
списками List, множествами Set
и ассоциативными массивами Map.
Синтаксис
operator fun <T> Array<out T>.plus(elements: Array<out T>): Array<T>
operator fun <T> Array<out T>.plus(element: T): Array<T>
operator fun <T> Array<out T>.plus(elements: Collection<T>): Array<T>
operator fun <T> Iterable<T>.plus(elements: Iterable<T>): List<T>
operator fun <T> Iterable<T>.plus(element: T): List<T>
operator fun <T> Iterable<T>.plus(elements: Array<out T>): List<T>
operator fun <T> Collection<T>.plus(elements: Iterable<T>): List<T>
operator fun <T> Collection<T>.plus(element: T): List<T>
operator fun <T> Collection<T>.plus(elements: Array<out T>): List<T>
operator fun <T> Set<T>.plus(elements: Iterable<T>): Set<T>
operator fun <T> Set<T>.plus(element: T): Set<T>
operator fun <T> Set<T>.plus(elements: Array<out T>): Set<T>
operator fun <K, V> Map<out K, V>.plus(pair: Pair<K, V>): Map<K, V>
operator fun <K, V> Map<out K, V>.plus(map: Map<out K, V>): Map<K, V>
operator fun <K, V> Map<out K, V>.plus(pairs: Iterable<Pair<K, V>>): Map<K, V>
Пример
Объединение двух массивов типа Array:
val arr1 = arrayOf(1, 2, 3)
val arr2 = arrayOf(4, 5, 6)
val res = arr1.plus(arr2)
println(res.contentToString())
Результат выполнения кода:
Array<Int> [1, 2, 3, 4, 5, 6]
Пример
Объединение двух списков типа List:
val list1 = listOf('a', 'b', 'c')
val list2 = listOf('d', 'e', 'f')
val res = list1.plus(list2)
println(res)
Результат выполнения кода:
List<Char> ['a', 'b', 'c', 'd', 'e', 'f']
Пример
Объединение двух множеств типа Set:
val set1 = setOf(1, 2, 3)
val set2 = setOf(3, 4, 5)
val res = set1.plus(set2)
println(res)
Результат выполнения кода:
Set<Int> [1, 2, 3, 4, 5]
Пример
Объединение двух ассоциативных массивов типа Map:
val map1 = mapOf("a" to 1, "b" to 2)
val map2 = mapOf("c" to 3, "d" to 4)
val res = map1.plus(map2)
println(res)
Результат выполнения кода:
Map<String, Int> {a=1, b=2, c=3, d=4}
Пример
Добавление отдельного элемента к массиву:
val arr = arrayOf(1, 2, 3)
val res = arr.plus(4)
println(res.contentToString())
Результат выполнения кода:
Array<Int> [1, 2, 3, 4]
Пример
Добавление отдельного элемента к списку:
val list = listOf('a', 'b', 'c')
val res = list.plus('d')
println(res)
Результат выполнения кода:
List<Char> ['a', 'b', 'c', 'd']
