Big5-input-file

function

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

Declaration

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

Purpose

This external string 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 Topics

Character set encoding

Other Library Functions