.TEXT FROM UNICODE

This subroutine transcodes a Unicode alpha field into a RAW alpha field. Added in 6.0.0

Usage

      PASS         <raw>                      FIELD            SHARE? Y
      PASS         <unicode_source>           FIELD            SHARE? N
      PASS         <encoding>                 FIELD            SHARE? N
      PASS         <action>                   FIELD            SHARE? N
      PASS         <option>                   FIELD            SHARE? N
      PASS         <error_text>               FIELD            SHARE? N
      GOSUB    --- .TEXT FROM UNICODE
      *        Check for errors
      IF       --- .TEXT FROM UNICODE         NE

Description

This subroutine will transcode a Unicode alpha field to a RAW alpha field with error handling for the characters that cannot be transcoded. The first 2 parameters are required. If any required parameters are missing, the subroutine will CANCEL.

<raw> is the RAW alpha field to contain the transcoded string (Required). This must be PASSed with Share "Y" to return the value.

<unicode_source> is the field containing the Unicode string to be transcoded (Required).

<encoding> is the encoding to use in the RAW target field. If not specified or a blank is PASSed, it will check the environment variable APPX_RAW_ENCODING and use that encoding. If that is not present, it will default to ISO-8859-15.

<action> is the action to be taken if a character cannot be transcoded to RAW (Optional). If not PASSed or blank is PASSed, defaults to SKIP.

• SKIP - skip the offending character, it will not be transcoded to the target field but the remaining characters will be.
• STOP - stop transcoding and return an error
• SUBS - Substitute the character in the <option> field for the offending character
• ESCAPE - Escape the character according to the convention specified in the <option> field

• C - specifies C style escaping (\uXXXX or \UXXXXXXXX)
• STYLE - specifies CSS2 escaping (\XXXXXX)
• JAVA - specifies Java escaping (\uXXXX)
• UNICODE - specifies Unicode escaping {U+XXXXX}
• DECIMAL - - specifies XML decimal escaping ($#XXXX)
• X - specifies XML hex escaping (&#xXXXX)

Examples

Given a Unicode string containing 'aɏb', here are the results with various options (the ɏ character does not exist in the ISO-8859-15 encoding).

Comments

<--/commentPlugin-->

-- Jean Neron - 2017-11-02