utils_decode_8bit

Attempts to convert text in an unknown 8bit/multibyte charset into UTF-8 by finding the charset which will convert the most bytes into valid UTF-8 characters as possible.

If no exact match can be found, it will choose the best match and convert invalid byte sequences into question-marks (?) in the returned string buffer.

Parameters:

options	a ParserOptions or null
text	input text in unknown 8bit/multibyte character set
len	input text length

Returns:

a UTF-8 string representation of text.