associateBy所在位置是kotlin.collections.associateBy，其相關用法介紹如下。

用法一

inline fun <T, K> Array<out T>.associateBy(
    keySelector: (T) -> K
): Map<K, T>
inline fun <K> ByteArray.associateBy(
    keySelector: (Byte) -> K
): Map<K, Byte>
inline fun <K> ShortArray.associateBy(
    keySelector: (Short) -> K
): Map<K, Short>
inline fun <K> IntArray.associateBy(
    keySelector: (Int) -> K
): Map<K, Int>
inline fun <K> LongArray.associateBy(
    keySelector: (Long) -> K
): Map<K, Long>
inline fun <K> FloatArray.associateBy(
    keySelector: (Float) -> K
): Map<K, Float>
inline fun <K> DoubleArray.associateBy(
    keySelector: (Double) -> K
): Map<K, Double>
inline fun <K> BooleanArray.associateBy(
    keySelector: (Boolean) -> K
): Map<K, Boolean>
inline fun <K> CharArray.associateBy(
    keySelector: (Char) -> K
): Map<K, Char>

返回一個 Map，其中包含給定數組中的元素，該數組由應用於每個元素的 keySelector 函數返回的鍵索引。

如果任意兩個元素具有由keySelector 返回的相同鍵，則將最後一個元素添加到Map中。

返回的映射保留原始數組的條目迭代順序。

例子：

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val charCodes = intArrayOf(72, 69, 76, 76, 79)

val byChar = charCodes.associateBy { Char(it) }

// L=76 only occurs once because only the last pair with the same key gets added
println(byChar) // {H=72, E=69, L=76, O=79}
//sampleEnd
}

輸出：

{H=72, E=69, L=76, O=79}

用法二

inline fun <T, K, V> Array<out T>.associateBy(
    keySelector: (T) -> K, 
    valueTransform: (T) -> V
): Map<K, V>
inline fun <K, V> ByteArray.associateBy(
    keySelector: (Byte) -> K, 
    valueTransform: (Byte) -> V
): Map<K, V>
inline fun <K, V> ShortArray.associateBy(
    keySelector: (Short) -> K, 
    valueTransform: (Short) -> V
): Map<K, V>
inline fun <K, V> IntArray.associateBy(
    keySelector: (Int) -> K, 
    valueTransform: (Int) -> V
): Map<K, V>
inline fun <K, V> LongArray.associateBy(
    keySelector: (Long) -> K, 
    valueTransform: (Long) -> V
): Map<K, V>
inline fun <K, V> FloatArray.associateBy(
    keySelector: (Float) -> K, 
    valueTransform: (Float) -> V
): Map<K, V>
inline fun <K, V> DoubleArray.associateBy(
    keySelector: (Double) -> K, 
    valueTransform: (Double) -> V
): Map<K, V>
inline fun <K, V> BooleanArray.associateBy(
    keySelector: (Boolean) -> K, 
    valueTransform: (Boolean) -> V
): Map<K, V>
inline fun <K, V> CharArray.associateBy(
    keySelector: (Char) -> K, 
    valueTransform: (Char) -> V
): Map<K, V>

返回一個 Map，其中包含由 valueTransform 提供的值並由應用於給定數組元素的 keySelector 函數索引。

如果任意兩個元素具有由keySelector 返回的相同鍵，則將最後一個元素添加到Map中。

返回的映射保留原始數組的條目迭代順序。

例子：

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val charCodes = intArrayOf(65, 65, 66, 67, 68, 69)

val byUpperCase = charCodes.associateBy({ Char(it) }, { Char(it + 32) })

// A=a only occurs once because only the last pair with the same key gets added
println(byUpperCase) // {A=a, B=b, C=c, D=d, E=e}
//sampleEnd
}

輸出：

{A=a, B=b, C=c, D=d, E=e}

用法三

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

返回一個Map，其中包含給定集合中的元素，這些元素由應用於每個元素的keySelector 函數返回的鍵索引。

如果任意兩個元素具有由keySelector 返回的相同鍵，則將最後一個元素添加到Map中。

返回的映射保留原始集合的條目迭代順序。

例子：

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
}

輸出：

{Hopper=Grace Hopper, Bernoulli=Johann Bernoulli}

用法四

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

返回一個 Map，其中包含由 valueTransform 提供的值，並由應用於給定集合元素的 keySelector 函數索引。

如果任意兩個元素具有由keySelector 返回的相同鍵，則將最後一個元素添加到Map中。

返回的映射保留原始集合的條目迭代順序。

例子：

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
}

輸出：

{Hopper=Grace, Bernoulli=Johann}