join
Начиная с Kotlin: 1.0
fun <T> Sequence<T>.joinToString(separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: (T) -> CharSequence? = null): String
Создаёт строку из всех элементов, разделённых с помощью разделителя, с использованием заданных префикса и постфикса, если они указаны.
Если коллекция не содержит элементов, результат состоит только из префикса, за которым следует постфикс (оба по умолчанию пусты).
Если коллекция очень большая, можно указать неотрицательное значение ограничения. В этом случае будут добавлены только первые ограничения элементов, после которых следует строка усечения (по умолчанию — «...»).
Операция является терминальной.
Примеры
import kotlin.math.*
import kotlin.test.*
fun main() {
//sampleStart
val numbers = listOf(1, 2, 3, 4, 5, 6)
println(numbers.joinToString()) // 1, 2, 3, 4, 5, 6
println(numbers.joinToString(prefix = "[", postfix = "]")) // [1, 2, 3, 4, 5, 6]
println(numbers.joinToString(prefix = "<", postfix = ">", separator = "•")) // <1•2•3•4•5•6>
val chars = charArrayOf('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q')
println(chars.joinToString(limit = 5, truncated = "...!") { it.uppercaseChar().toString() }) // A, B, C, D, E, ...!
// If the receiver is empty, the result only contains prefix and postfix
println("emptyList<Int>().joinToString().isEmpty() is ${emptyList<Int>().joinToString().isEmpty()}") // true
println(emptyList<Int>().joinToString(prefix = "[", postfix = "]")) // []
//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/join-to-string.html
