Purpose

Converts a string to upper case respecting any UTF-8 characters it contains. If UTF-8 characters have upper case equivalents then these are used.

Syntax

#Success = UPPER_CASE_UTF8(String-Expression, String-Variable)
 

Operation

Returns one if successful or zero if failure (e.g. encountered invalid UTF-8). The first argument is a string expression that may contains UTF-8 characters. The second argument must be a string variable that is overwritten with upper case version of the first argument.

Remarks
 

The same variable may be used for both arguments. The second argument cannot be a value variable. If the function fails then the second argument may be partially updated with what could be converted.

Example
 

if UPPER_CASE_UTF8($A + $B, $C) then

  umsg("$C ='" + $C + "'", -1)

else

  umsg("UPPER_CASE_UTF8 failed - invalid UTF-8?", -1)

endif