this helper converts the unicodeScalar to a sequence of utf8 bytes and copies those bytes into the supplied outputBytes array. If there is insufficient room in the array to hold the generated bytes it will throw an ArrayIndexOutOfBoundsException. It does not check for the validity of the passed in unicodeScalar thoroughly, however it will throw an InvalidUnicodeCodePoint if the value is less than negative or the UTF8 encoding would exceed 4 bytes.

Parameters

unicodeScalar:int

scalar to convert

outputBytes:byte[]

user output array to fill with UTF8 bytes

offset:int

first array element to fill

maxLength:int

maximum number of array elements to fill

Returns:int

number of bytes written to the output array

this helper converts the bytes starting at offset from UTF8 to a Unicode scalar. This does not check for valid Unicode scalar ranges but simply handle the UTF8 decoding. getScalarReadLengthFromBytes can be used to determine how many bytes would be converted (consumed) in this process if the same parameters are passed in. This will throw ArrayIndexOutOfBoundsException if the array has too few bytes to fully decode the scalar. It will throw InvalidUnicodeCodePoint if the first byte isn't a valid UTF8 initial byte with a length of 4 or less.

Parameters

bytes:byte[]

UTF8 bytes in an array

offset:int

initial array element to decode from

maxLength:int

maximum number of bytes to consume from the array

Returns:int

Unicode scalar

this helper calculates the number of bytes it will consume from the supplied byte array (bytes) if getScalarFromBytes is called with the same parameters. This is in place of having getScalarFromBytes return an object with the bytes consumed and the resultant scalar. This will throw ArrayIndexOutOfBoundsException if there are fewer bytes remaining (maxLength) than needed for a valid UTF8 sequence starting at offset.

Parameters

bytes:byte[]

UTF8 bytes in user supplied array

offset:int

first array element to read from

maxLength:int

maximum number of bytes to read from the array

Returns:int

number of bytes needed to decode the next scalar

converts a unicode code point to a 0-3 bytes of UTF8 encoded data and a length - note this doesn't pack a 1 byte character and it returns the start character. this is the unpacking routine while (_utf8_pretch_byte_count > 0 && offset < limit) { _utf8_pretch_byte_count--; buffer[offset++] = (byte)((_utf8_pretch_bytes >> (_utf8_pretch_byte_count*8)) & 0xff); }