The type of encoding.

encoding_of_string s converts a (case sensitive) IANA character set name to an encoding.

encoding_to_string e is a IANA character set name for e.

The type for decoders.

The type for input sources. With a `Manual source the client must provide input with src.

src d s j l provides d with l bytes to read, starting at j in s. This byte range is read by calls to decode with d until `Await is returned. To signal the end of input call the function with l = 0.

decoder encoding src is a decoder that inputs from src.

Encoding. encoding specifies the decoded encoding scheme.

decode d is:

• `Await if d has a `Manual input source and awaits for more input. The client must use src to provide it.
• `Uchar u if a Unicode scalar value u was decoder.
• `End if the end of input was reached.
• `Malformed err if d encountered an error err.

Note. Repeated invocation always eventually returns `End, even in case of errors.

decoder_byte_count d is the number of characters already decoder on d (including malformed ones). This is the last decode's and byte offset counting from beginning of the stream.

decoder_src d is d's input source.

decoder_kind d is d's the decoded encoding scheme of d.

to_utf_8_string ~charset str converts a given string str encoded with the character set charset into a string in UTF-8. If the character set is not recognised (among Rosetta.encoding), it returns None.