Функция put

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

Синтаксис

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

Пример

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

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

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

kotlinMap: {one=1}
Previous value: null

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

kotlinval 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")
}

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

kotlinKey 'b' existed with value: 2

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

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