safeDecode

Decodes a single code point. The input does not have to be valid.

This function removes one or more code units from the start of a string, and returns the decoded code point which those code units represent.

This function will accept an invalidly encoded string as input. If an invalid sequence is found at the start of the string, this function will remove it, and return the value INVALID_SEQUENCE.