encodeToByteArray
fun
String
.
encodeToByteArray
(
)
:
ByteArray
(Common source) (JVM source) (JS source) (Native source)
Encodes this string to an array of bytes in UTF-8 encoding.
Any malformed char sequence is replaced by the replacement byte sequence.
fun
String
.
encodeToByteArray
(
startIndex
:
Int
=
0
,
endIndex
:
Int
=
this.length
,
throwOnInvalidSequence
:
Boolean
=
false
)
:
ByteArray
(Common source) (JVM source) (JS source) (Native source)
Encodes this string or its substring to an array of bytes in UTF-8 encoding.
Parameters
startIndex
- the beginning (inclusive) of the substring to encode, 0 by default.
endIndex
- the end (exclusive) of the substring to encode, length of this string by default.
throwOnInvalidSequence
- specifies whether to throw an exception on malformed char sequence or replace.
Exceptions
IndexOutOfBoundsException
- if
startIndex
is less than zero or
endIndex
is greater than the length of this string.
IllegalArgumentException
- if
startIndex
is greater than
endIndex
.
CharacterCodingException
- if this string contains malformed char sequence and
throwOnInvalidSequence
is true.