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 Topics 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 ]