Функция plusElement

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

Импорт

import kotlin.collections.plusElement

Синтаксис

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

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

Пример

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

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

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

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

Пример

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

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

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

Set [1, 2, 3, 4]

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

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

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

функцию plus,
которая добавляет несколько элементов или коллекцию
функцию minusElement,
которая удаляет элемент из коллекции
функцию addAll,
которая добавляет несколько элементов в изменяемую коллекцию