Функция containsValue

Функция containsValue проверяет наличие указанного значения в коллекции. Возвращает true если значение найдено, и false в противном случае. Основное применение функции - работа с ассоциативными массивами типа Map.

Синтаксис

fun <K, V> Map<out K, V>.containsValue(value: V): Boolean

Для каких коллекций работает

Функция containsValue доступна для следующих типов коллекций:

Map - ассоциативные массивы (основное применение)
MutableMap - изменяемые ассоциативные массивы
HashMap
LinkedHashMap
SortedMap

Для массивов (Array), списков (List) и множеств (Set) используйте функцию contains.

Пример

Проверим наличие значения в ассоциативном массиве:

val map = mapOf("a" to 1, "b" to 2, "c" to 3)
val res = map.containsValue(2)
println(res)

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

Boolean true

Пример

Проверим наличие несуществующего значения:

val map = mapOf("x" to 10, "y" to 20, "z" to 30)
val res = map.containsValue(15)
println(res)

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

Boolean false

Пример

Работа со строковыми значениями:

val countries = mapOf("RU" to "Russia", "US" to "USA", "DE" to "Germany")
val res = countries.containsValue("Russia")
println(res)

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

Boolean true

Пример

Проверка чувствительна к регистру при работе со строками:

val map = mapOf(1 to "Apple", 2 to "Banana", 3 to "Orange")
val res1 = map.containsValue("apple")
val res2 = map.containsValue("Apple")
println("Lowercase: $res1")
println("Uppercase: $res2")

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

Lowercase: false
Uppercase: true

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

функцию contains,
которая проверяет наличие элемента в массивах, списках и множествах
функцию containsKey,
которая проверяет наличие ключа в ассоциативных массивах
функцию get,
которая возвращает значение по ключу
функцию getOrDefault,
которая возвращает значение по ключу или значение по умолчанию