encodeToAppendable

kotlin-stdlib/kotlin.io.encoding/Base64/encodeToAppendable

Начиная с Kotlin: 2.2


@IgnorableReturnValue
fun <A : Appendable> encodeToAppendable(source: ByteArray, destination: A, startIndex: Int = 0, endIndex: Int = source.size): A

Кодирует байты из указанного массива source или его поддиапазона и добавляет полученные символы в объект destination. Возвращает объект destination.

Будет ли результат кодирования дополнен символами '=', зависит от значения PaddingOption, заданного для этого экземпляра Base64.

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

объект destination.

Параметры

source

массив, из которого кодируются байты.

destination

объект, в который добавляются символы.

startIndex

начало (включительно) кодируемого поддиапазона; по умолчанию — 0.

endIndex

конец (не включительно) кодируемого поддиапазона; по умолчанию — размер массива source.

Исключения

IndexOutOfBoundsException

если startIndex или endIndex выходит за пределы индексов массива source.

IllegalArgumentException

если startIndex > endIndex.

Примеры

import kotlin.io.encoding.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val data = byteArrayOf(-1, 0, -2, 0, -3)

val encoded = buildString {
    append("{ \"data\": \"")
    Base64.encodeToAppendable(data, destination = this)
    append("\" }")
}
println(encoded) // { \"data\": \"/wD+AP0=\" }

val encodedFromSubRange = buildString {
    append("{ \"data\": \"")
    Base64.encodeToAppendable(data, destination = this, startIndex = 1, endIndex = 3)
    append("\" }")
}
println(encodedFromSubRange) // { \"data\": \"AP4=\" } 
   //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.io.encoding/-base64/encode-to-appendable.html