Decode a
ByteString containing UTF-8 encoded text.
NOTE: The replacement character returned by
OnDecodeError MUST be within the BMP plane; surrogate code
points will automatically be remapped to the replacement char
U+FFFD (
since 0.11.3.0), whereas code points beyond
the BMP will throw an
error (
since 1.2.3.1); For earlier
versions of
text using those unsupported code points would
result in undefined behavior.