toKString
Return the kotlin.String decoded from given zero-terminated UTF-8-encoded C string.
Decodes a string from the bytes in UTF-8 encoding in this array.
Bytes following the first occurrence of
0
byte, if it occurs, are not decoded.
Malformed byte sequences are replaced by the replacement char
\uFFFD
.
Decodes a string from the bytes in UTF-8 encoding in this array or its subrange.
Bytes following the first occurrence of
0
byte, if it occurs, are not decoded.
Parameters
startIndex
- the beginning (inclusive) of the subrange to decode, 0 by default.
endIndex
- the end (exclusive) of the subrange to decode, size of this array by default.
throwOnInvalidSequence
- specifies whether to throw an exception on malformed byte sequence or replace it by the replacement char
\uFFFD
.
Exceptions
IndexOutOfBoundsException
- if
startIndex
is less than zero or
endIndex
is greater than the size of this array.
IllegalArgumentException
- if
startIndex
is greater than
endIndex
.
CharacterCodingException
- if the byte array contains malformed UTF-8 byte sequence and
throwOnInvalidSequence
is true.