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

Declaration

define external string sink function Big5-output-file
                value string filename
  exceptions-to value io-exception exceptions-to optional

This external string sink function converts a stream of UTF-8 characters to a stream of Big Five 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 UTF-8 characters. When a file name is not specified, this function uses standard output.
• "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 Big5-output-file "myfile.utf" to my-buffer 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 output file cannot be found.
• 0x0020: Read Error. This error usually occurs when an illegal character is detected during writing.

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 ] [ LEGACY LIBRARIES ] [ ERRORS ]