joinTo

Начиная с Kotlin: 1.0


@IgnorableReturnValue
fun <T, A : Appendable> Sequence<T>.joinTo(buffer: A, separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: (T) -> CharSequence? = null): A

Добавляет строку из всех элементов, разделённых с помощью separator, и использует указанные prefix и postfix, если они заданы.

Если коллекция не содержит элементов, функция добавляет к buffer только prefix, за которым следует postfix (по умолчанию оба пусты).

Если коллекция очень большая, можно указать неотрицательное значение limit. В этом случае будут добавлены только первые элементы в количестве limit, за которыми последует строка truncated (по умолчанию — «...»).

Возвращаемое значение

аргумент buffer с добавленными элементами.

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

Примеры

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

fun main() { 
   //sampleStart 
   val sb = StringBuilder("An existing string and a list: ")
val numbers = listOf(1, 2, 3)
println(numbers.joinTo(sb, prefix = "[", postfix = "]").toString()) // An existing string and a list: [1, 2, 3]

val lotOfNumbers: Iterable<Int> = 1..100
val firstNumbers = StringBuilder("First five numbers: ")
println(lotOfNumbers.joinTo(firstNumbers, limit = 5).toString()) // First five numbers: 1, 2, 3, 4, 5, ...

// If the receiver is empty, the result only contains prefix and postfix
println("emptyList<Int>().joinTo(StringBuilder()).toString().isEmpty() is ${emptyList<Int>().joinTo(StringBuilder()).toString().isEmpty()}") // true
println(emptyList<Int>().joinTo(StringBuilder(), prefix = "[", postfix = "]").toString()) // [] 
   //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.html