utf8-char-number

function

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

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


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


Purpose

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