This library contains one OmniMark external source function and one OmniMark external output function implementation for converting from and to the "Shift-JIS" encoding of Japanese text, as follows:

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

The data formats are interpreted/produced according to the Japanese Industry Standards JIS X 0201, JIS X 0208 and JIS X 0212. The Shift-JIS data format is transformed using the JIS<->Shift-JIS conversion algorithms.

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

These functions are based on the book "Understanding Japanese Information Processing" by Ken Lunde, O'Reilly 1993, ISBN 1-56592-043-0.

Usage Note

To use omffsjis, you must import it into your program using a statement like this:

  import "omffsjis.xmd" prefixed by sjis.

(Please see the import topic for more on importing.)

Functions    sjis.reader    sjis.writer

Platforms    HP/UX    HP-UX Itanium 2    IBM AIX 5.3    Linux (Intel)    Linux Red Hat Enterprise 5    MS Windows 98/ME    MS Windows NT/2000/XP    MS Windows Vista    Sun Solaris 8

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]