utf16.reader

function

Library: UTF-16 (OMFFUTF16)
Import : omffutf16.xmd

Returns: A scannable input source for streaming data.

Declaration

export external string source function reader
                  from value string source input-data

Purpose

Use reader to read a value string source, its argument, and return the text of that file converted from a UTF-16 encoding to a UTF-8 encoding. That is, the provided source is in UTF-16, but the program sees UTF-8.

Usage Note

To use omffutf16, you must import it into your program using a statement like this:

  import "omffutf16.xmd" prefixed by utf16.

(Please see the import topic for more on importing.)

Example

  ; Copy the file named by the first command-line argument to
  ; the file named by the second command-line argument, converting
  ; from UTF-16 encoding to UTF-8 encoding (the default) on the
  ; output file.
  import "omffutf16.xmd" prefixed by utf16.
  process
     set file #args [2] to utf16.reader from file #args [1]

Related Topics

utf16.writer

Other Library Functions