getValue

kotlin-stdlib/kotlin.collections/getValue

Начиная с Kotlin: 1.0

inline operator fun <V, V1 : V> Map<in String, V>.getValue(thisRef: Any?, property: KProperty<*>): V1

Возвращает значение свойства для заданного объекта из этой неизменяемой карты.

Возвращаемое значение

значение свойства.

Параметры

thisRef

объект, для которого запрашивается значение (не используется).

property

метаданные свойства, используемые для получения имени свойства и поиска в карте значения, соответствующего этому имени.

Исключения

NoSuchElementException

если карта не содержит значения для имени свойства и не задаёт неявное значение по умолчанию (см. withDefault).


@JvmName(name = "getVar")
inline operator fun <V, V1 : V> MutableMap<in String, out V>.getValue(thisRef: Any?, property: KProperty<*>): V1

Возвращает значение свойства для заданного объекта из этой изменяемой карты.

Возвращаемое значение

значение свойства.

Параметры

thisRef

объект, для которого запрашивается значение (не используется).

property

Исключения

NoSuchElementException

если карта не содержит значения для имени свойства и не задаёт неявное значение по умолчанию (см. withDefault).

fun <K, V> Map<K, V>.getValue(key: K): V

Возвращает значение для заданного ключа или выбрасывает исключение, если такого ключа нет в карте.

Если карта была создана с помощью withDefault, вместо выбрасывания исключения используется функция-поставщик defaultValue.

Исключения

NoSuchElementException

если карта не содержит значения для указанного ключа и для этой карты не задано неявное значение по умолчанию.

Примеры

import kotlin.test.*
import java.util.*

fun main() { 
   //sampleStart 
   val map = mapOf(1 to "One", 2 to "Two")
// map.getValue(3) // will fail with NoSuchElementException
println(map.getValue(1)) // One 
   //sampleEnd
}

import kotlin.test.*
import java.util.*

fun main() { 
   //sampleStart 
   val mapWithDefault = mapOf(1 to "One", 2 to "Two").withDefault { key ->
    when {
        key == 0 -> "Zero"
        key > 0 -> "Positive"
        else -> "Negative"
    }
}
val actual = (-1..3).associateWith { mapWithDefault.getValue(it) }
println(actual) // {-1=Negative, 0=Zero, 1=One, 2=Two, 3=Positive} 
   //sampleEnd
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/get-value.html