utf16-input-file

function

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

Declaration
define external string source function utf16-input-file
                value string filename
         endian value integer endian optional initial {0}
      strip-bom value switch strip-bom optional initial {true}
  exceptions-to value io-exception exceptions-to optional


Purpose

This external function reads the file named by the "filename" argument and returns the text of that file converted from a UTF-16 encoding to a UTF-8 encoding. The file is in UTF-16, but the program sees UTF-8.

Arguments:

Example:

  ; Submitting a file of UTF-16 encoded characters for scanning by find rules.
  
  submit utf16-input-file "widetext.txt"