This library contains one string source function and one string sink function, as follows:

  • reader is a string source function that reads its value string source, and returns the text of that data converted from a Big5 encoding to a UTF-8 encoding. That is, the provided data is in Big5, but the program sees UTF-8.
  • writer is a string sink function that accepts UTF-8 encoded data and writes that data to its value string sink argument, converted from a UTF-8 encoding to a Big5 encoding. That is, the program writes UTF-8, but the provided output receives Big5.

The Big Five data format is interpreted/produced according to the Taiwanese Industry Standard.

The only kinds of errors that can occur are in conversion: finding a character that does not have a conversion in the other character set. In this case, the converted value use is DEL (0x7F) in the Big5 encoding, and NOT-A-CHARACTER (0xFFFD) in the UTF-8 encoding.

Usage Note

To use OMFFBIG5, you must import it into your program using an import declaration such as:

  import "omffbig5.xmd" prefixed by big5.