0LASubrTextGetUniname < Main

Tags: view all tags
---+ .TEXT GET UNINAME

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

<br />%TOC%
---++ Usage
<pre>      PASS         &lt;unicode_name&gt;             FIELD            SHARE? Y
      PASS         &lt;unicode_string&gt;           FIELD            SHARE? N
      GOSUB    --- .TEXT GET UNINAME
      *        Check for errors
      IF       --- .TEXT GET UNINAME          NE
</pre>

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

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

&lt;unicode_string&gt; 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 [[0LASubrTextSetUniname][.TEXT SET UNINAME]].

Notes:
   * Unicode character names can be quite long (i.e., LATIN SMALL LETTER Y WITH STROKE), make sure your &lt;unicode_name&gt; 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

%COMMENT%

-- %USERSIG{JeanNeron - 2017-11-02}%
Topic revision: r3 - 2023-04-10 - BrianRyan