Library: Character encodings, international (OMEFIO) Include: omefio.xin

Declaration

  define external source function Big5-input-file
                  value stream filename
    exceptions-to value io-exception exceptions-to optional

This external source function converts a stream of Big Five characters to a stream of UTF-8 characters.

Big 5 is a Chinese character set encoding that specifies 13,494 Chinese characters. It is the most widely used encoding in Taiwan and its name refers to the five companies that collaborated in its development in 1984.

Arguments:

• "filename". This is the name of the file containing Big Five characters. When a file name is not specified, this function uses standard input.
• "io-exception". This optional argument indicates that errors are to be recorded in the passed "io-exception" object, and that the OmniMark program is not to be immediately terminated.

Example:

  set my-buffer to Big5-input-file "test.dat" exceptions-to e

  do when get-exception-status e != 0
     put #error "Error " || "16r8fzud" % get-exception-status e || "occurred. %n"
  done

You should note two common errors.

• 0x0010: Connection Error. This error usually occurs when the input file cannot be found.
• 0x0020: Read Error. This error usually occurs when an illegal character is detected during reading.

Related Concepts    Character set encoding

Other Library 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

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