Функция plus

Функция plus выполняет объединение двух коллекций, возвращая новую коллекцию, содержащую все элементы из исходной коллекции и все элементы из переданной в параметре коллекции. Исходные коллекции при этом не изменяются. Функция работает с массивами Array, списками List, множествами Set и ассоциативными массивами Map.

Синтаксис

kotlinoperator 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>

kotlinoperator 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>

kotlinoperator 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>

kotlinoperator 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>

kotlinoperator 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:

kotlinval arr1 = arrayOf(1, 2, 3)
val arr2 = arrayOf(4, 5, 6)
val res = arr1.plus(arr2)
println(res.contentToString())

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

kotlinArray<Int> [1, 2, 3, 4, 5, 6]

Пример

Объединение двух списков типа List:

kotlinval list1 = listOf('a', 'b', 'c')
val list2 = listOf('d', 'e', 'f')
val res = list1.plus(list2)
println(res)

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

kotlinList<Char> ['a', 'b', 'c', 'd', 'e', 'f']

Пример

Объединение двух множеств типа Set:

kotlinval set1 = setOf(1, 2, 3)
val set2 = setOf(3, 4, 5)
val res = set1.plus(set2)
println(res)

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

kotlinSet<Int> [1, 2, 3, 4, 5]

Пример

Объединение двух ассоциативных массивов типа Map:

kotlinval map1 = mapOf("a" to 1, "b" to 2)
val map2 = mapOf("c" to 3, "d" to 4)
val res = map1.plus(map2)
println(res)

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

kotlinMap<String, Int> {a=1, b=2, c=3, d=4}

Пример

Добавление отдельного элемента к массиву:

kotlinval arr = arrayOf(1, 2, 3)
val res = arr.plus(4)
println(res.contentToString())

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

kotlinArray<Int> [1, 2, 3, 4]

Пример

Добавление отдельного элемента к списку:

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

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

kotlinList<Char> ['a', 'b', 'c', 'd']

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