You are here: Foswiki>APPX Web>FullAPIList>0LASubrTextGetUniname (10 Apr 2023, BrianRyan)Edit Attach

.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.
Comments

 

-- %USERSIG{JeanNeron - 2017-11-02}%
Topic revision: r3 - 10 Apr 2023, BrianRyan
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback