encodeToByteArray

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

fun String.encodeToByteArray(): ByteArray

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

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

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

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

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

fun String.encodeToByteArray(
    startIndex: Int, 
    endIndex: Int, 
    throwOnInvalidSequence: Boolean
): ByteArray

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

Параметры

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

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

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

Исключения

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

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

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