Функция toPair

Функция toPair преобразует коллекцию из двух элементов в объект типа Pair. Применяется к коллекциям, которые содержат ровно два элемента. Если в коллекции больше или меньше двух элементов, будет выброшено исключение IllegalArgumentException.

Импорт

kotlinimport kotlin.collections.toPair

Синтаксис

kotlinfun <T> Iterable<T>.toPair(): Pair<T, T>
kotlinfun <T> Array<T>.toPair(): Pair<T, T>
kotlinfun <K, V> Map.Entry<K, V>.toPair(): Pair<K, V>

Пример

Преобразуем список из двух элементов в пару:

kotlinval list = listOf("key", "value")
val res: Pair<String, String> = list.toPair()
println(res)

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

kotlin(key, value)

Пример

Преобразуем массив из двух чисел в пару:

kotlinval arr = arrayOf(1, 2)
val res: Pair<Int, Int> = arr.toPair()
println(res)

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

kotlin(1, 2)

Пример

Преобразуем элемент Map.Entry в пару:

kotlinval map = mapOf("name" to "John", "age" to 25)
val entry = map.entries.first()
val res: Pair<String, Any> = entry.toPair()
println(res)

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

kotlin(name, John)

Пример

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

kotlinval list = listOf(1, 2, 3)

try {
  val res = list.toPair()
  println(res)
} catch (e: IllegalArgumentException) {
  println("Error: " + e.message)
}

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

kotlinError: Collection has more than two elements.

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

  • функцию toList,
    которая преобразует коллекцию в список
  • функцию toSet,
    которая преобразует коллекцию в множество
  • функцию toMap,
    которая преобразует коллекцию пар в словарь
  • функцию toArray,
    которая преобразует коллекцию в массив