Big5-output-file

function

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

Purpose

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 Topics

Character set encoding

Other Library Functions