Функция put

Функция put добавляет новую пару ключ-значение в изменяемый ассоциативный массив (MutableMap). Если ключ уже существует в коллекции, то его значение будет заменено на новое. Возвращает предыдущее значение, связанное с ключом, или null, если ключа не было.

Синтаксис

fun put(key: K, value: V): V?

Пример

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

val map = mutableMapOf<String, Int>()
val previousValue = map.put("one", 1)
println("Map: $map")
println("Previous value: $previousValue")

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

Map: {one=1}
Previous value: null

Пример

Обновим значение существующего ключа:

val map = mutableMapOf("one" to 1, "two" to 2)
val previousValue = map.put("two", 22)
println("Map: $map")
println("Previous value: $previousValue")

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

Map: {one=1, two=22}
Previous value: 2

Пример

Добавим несколько элементов с разными типами ключей и значений:

val map = mutableMapOf<Any, Any>()
map.put(1, "apple")
map.put("two", 2.5)
map.put('c', true)
println(map)

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

{1=apple, two=2.5, c=true}

Пример

Использование результата функции put для проверки существования ключа:

val map = mutableMapOf("a" to 1, "b" to 2, "c" to 3)
val result = map.put("b", 20)

if (result != null) {
	println("Key 'b' existed with value: $result")
} else {
	println("Key 'b' did not exist")
}

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

Key 'b' existed with value: 2

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

функцию getOrPut,
которая получает значение или добавляет новое при отсутствии ключа
функцию putIfAbsent,
которая добавляет элемент только если ключ отсутствует
функцию remove,
которая удаляет элемент по ключу из ассоциативного массива
функцию containsKey,
которая проверяет наличие ключа в ассоциативном массиве