associateByTo

kotlin-stdlib/kotlin.sequences/associateByTo

Начиная с Kotlin: 1.0


@IgnorableReturnValue
inline fun <T, K, M : MutableMap<in K, in T>> Sequence<T>.associateByTo(destination: M, keySelector: (T) -> K): M

Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ задаётся функцией keySelector, применённой к каждому элементу заданной последовательности, а значение — сам элемент.

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

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

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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 = mutableMapOf<String, Person>()
println("byLastName.isEmpty() is ${byLastName.isEmpty()}") // true

scientists.associateByTo(byLastName) { it.lastName }

println("byLastName.isNotEmpty() is ${byLastName.isNotEmpty()}") // true
// 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
}


@IgnorableReturnValue
inline fun <T, K, V, M : MutableMap<in K, in V>> Sequence<T>.associateByTo(destination: M, keySelector: (T) -> K, valueTransform: (T) -> V): M

Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ задаётся функцией keySelector, а значение — функцией valueTransform, применённой к элементам заданной последовательности.

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

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

Примеры

import kotlin.math.*
import kotlin.test.*

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

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

val byLastName = mutableMapOf<String, String>()
println("byLastName.isEmpty() is ${byLastName.isEmpty()}") // true

scientists.associateByTo(byLastName, { it.lastName }, { it.firstName} )

println("byLastName.isNotEmpty() is ${byLastName.isNotEmpty()}") // true
// 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–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.sequences/associate-by-to.html