Line: 1 to 1 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
.TEXT FROM UNICODEThis subroutine transcodes a Unicode alpha field into a RAW alpha field. Added in 6.0.0UsagePASS <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? Y GOSUB --- .TEXT FROM UNICODE * Check for errors IF --- .TEXT FROM UNICODE NE DescriptionThis 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. This must be a RAW field type, otherwise the transcoding will fail. <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.
| |||||||||||||||||||||
Added: | |||||||||||||||||||||
> > | Note: 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. | ||||||||||||||||||||
ExamplesGiven a Unicode string containing 'aɏb', here are the results with various options (the ɏ character does not exist in the ISO-8859-15 encoding).
| |||||||||||||||||||||
Changed: | |||||||||||||||||||||
< < | Comments | ||||||||||||||||||||
> > | Comments | ||||||||||||||||||||
-- Jean Neron - 2017-11-02 \ No newline at end of file |