.TEXT GET UNINAME

This subroutine returns the name of the specified Unicode character. Added in 6.0.0

Usage

      PASS         <unicode_name>             FIELD            SHARE? Y
      PASS         <unicode_string>           FIELD            SHARE? N
      GOSUB    --- .TEXT GET UNINAME
      *        Check for errors
      IF       --- .TEXT GET UNINAME          NE

Description

This subroutine returns the name of the specified Unicode character. All parameters are required. If any required parameters are missing, the subroutine will CANCEL.

<unicode_name> returns the name of the Unicode character PASSed in <unicode_string> (Required). This must be PASSed with Share "Y" to return the value.

<unicode_string> is the Unicode character or string whose name will be returned (Required). Only the first character of the string is checked.

This is the opposite of .TEXT SET UNINAME.

Notes:

• Unicode character names can be quite long (i.e., LATIN SMALL LETTER Y WITH STROKE), make sure your <unicode_name> field is large enough.
• This subroutine is designed to operate on Alpha, Text, and Token fields only. The returned results are undefined if you specify any other type of field.

-- Jean Neron - 2017-11-02