associateBy

kotlin-stdlib / kotlin.sequences / associateBy

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

inline fun <T, K> Sequence<T>.associateBy(
    keySelector: (T) -> K
): Map<K, T>

Возвращает Map, содержащую элементы из заданной последовательности, индексированные ключами, полученными из функции keySelector, применённой к каждому элементу.

Если у двух элементов будет получен один и тот же ключ с помощью функции keySelector, в карту добавляется последний элемент.

Возвращаемая карта сохраняет порядок итерации записей исходной последовательности.

Операция является терминальной.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
data class Person(val firstName: String, val lastName: String) {
    override fun toString(): String = "$firstName $lastName"
}

val scientists = listOf(Person("Grace", "Hopper"), Person("Jacob", "Bernoulli"), Person("Johann", "Bernoulli"))

val byLastName = scientists.associateBy { it.lastName }

// Jacob Bernoulli does not occur in the map because only the last pair with the same key gets added
println(byLastName) // {Hopper=Grace Hopper, Bernoulli=Johann Bernoulli}
//sampleEnd
}

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

inline fun <T, K, V> Sequence<T>.associateBy(
    keySelector: (T) -> K, 
    valueTransform: (T) -> V
): Map<K, V>

Возвращает Map, содержащую значения, предоставленные функцией valueTransform, индексированные функциями keySelector, применёнными к элементам заданной последовательности.

Возвращаемая карта сохраняет порядок итерации записей исходной последовательности.

Операция является терминальной.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
data class Person(val firstName: String, val lastName: String)

val scientists = listOf(Person("Grace", "Hopper"), Person("Jacob", "Bernoulli"), Person("Johann", "Bernoulli"))

val byLastName = scientists.associateBy({ it.lastName }, { it.firstName })

// Jacob Bernoulli does not occur in the map because only the last pair with the same key gets added
println(byLastName) // {Hopper=Grace, Bernoulli=Johann}
//sampleEnd
}

© 2010–2020 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.sequences/associate-by.html