encodeToByteArray

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

fun String.encodeToByteArray(): ByteArray

Кодирует эту строку в массив байтов в кодировке UTF-8.

Любая некорректная последовательность символов заменяется на последовательность байтов-заменителей.

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

fun String.encodeToByteArray(
    startIndex: Int = 0, 
    endIndex: Int = this.length, 
    throwOnInvalidSequence: Boolean = false
): ByteArray

Кодирует эту строку или ее подстроку в массив байтов в кодировке UTF-8.

Параметры

startIndex - начало (включительно) подстроки для кодирования, по умолчанию 0.

endIndex - конец (исключительно) подстроки для кодирования, по умолчанию длина этой строки.

throwOnInvalidSequence - указывает, следует ли выбрасывать исключение при некорректной последовательности символов или заменить её.

Исключения

IndexOutOfBoundsException - если startIndex меньше нуля или endIndex больше длины этой строки.

IllegalArgumentException - если startIndex больше endIndex.

CharacterCodingException - если эта строка содержит некорректную последовательность символов, и throwOnInvalidSequence равно true.