Library: UTF-8 text processing legacy library (UTF8PAT) Include: utf8pat.xin

Return type: Integer Returns:  Integer value corresponding to the specified UTF-8 character.

Declaration

  define integer function utf8-char-number
      value stream utf8-string

You can use utf8-char-number to convert a string containing a single UTF-8 character to the character number it encodes.

If the string does not consist of a single UTF-8 encoded character, the character number of the Unicode Replacement Character (U-FFFD) is returned instead.

The following program converts a UTF-8 encoded file to a long character encoding (2 bytes for every character):

  include utf8pat.xin

  process
      submit file #main-input

  find utf8-char => char
      output "2f0b" % utf8-char-number char

Other Library Functions    multi-byte-utf8-char    single-byte-utf8-char    utf8-char    utf8-char-number    utf8-encoded

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]