Functions		Platforms
	omefio - UTF-8 file I/O

The omefio library allows you to do a variety of character encoding conversions on file input or output. The available conversions include:

• JIS ("Japanese Industry Standard" (JIS X 0201, JIS X 0208, and JIS X 0212)) character encoding to UTF-8 on file input
• UTF-8 to JIS character encoding on file output
• sJIS ("Shift JIS") character encoding to UTF-8 on file input
• UTF-8 to sJIS character encoding on file output
• EUC ("Extended UNIX Code") character encoding to UTF-8 on file input
• UTF-8 to EUC character encoding on file output
• UTF-16 to UTF-8 character encoding on file input
• UTF-8 to UTF-16 character encoding on file output
• Big Five to UTF-8 character encoding on file input
• UTF-8 to Big Five character encoding on file output

Also included in this function library is one external source function (input-file) and one external output function (output-file) that provide basic file input and output functionality. These functions duplicate basic OmniMark file input and output processes, with one notable exception: if a file i/o error is encountered when doing "regular" OmniMark file processing, your program will terminate. The input-file and output-file functions, however, make use of the "exceptions-to" optional argument, allowing file I/O errors to be noted without terminating the program. This error handling is beneficial in server programs where program termination is often unacceptable.

Note that not all legitimate Big Five characters have a corresponding UTF-8 encoding, so occasionally you will lose data during a conversion. OmniMark will issue a warning when such a data loss occurs.

The UTF-8 file I/O library, omefio, depends on the OmniMark I/O exception object library (omioe). This means that omioe must be included in the program before omefio, as shown:

  include "omioe.xin"
  include "omefio.xin"

Functions    Big5-input-file    Big5-output-file    euc-input-file    euc-output-file    input-file    jis-input-file    jis-output-file    output-file    sjis-input-file    sjis-output-file    utf16-input-file    utf16-output-file

Platforms    HP/UX    IBM AIX    Linux (Intel)    MS Windows 95/98    MS Windows NT    SGI IRIX    Sun Solaris

----

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

Copyright © OmniMark Technologies Corporation, 1988-2000.