Text utf
Purpose: Convert text to UTF (UTF8 or UTF16) string. 

 text-utf <text> \
     [ status <status> ] \
     [ error-text <error text> ]

text-utf will convert string value <text> to UTF. <text> itself will hold the resulting UTF string. If you don't wish <text> to be modified, make a copy of it first (see copy-string). See utf-text for the reverse conversion and data standards information.

You can obtain <status> in "status" clause. <status> number is GG_OKAY if successful, or GG_ERR_UTF if there was an error, in which case <error text> string in "error-text" clause will contain the error message.
Examples
 // Unicode value to encode to UTF8 or UTF16 (such as \\uD834\\uDD1E as a surrogate pair)
 set-string txt = "\u0459\\\"Doc\\\"\\n\\t\\b\\f\\r\\t\\u21d7\\u21d8\\t\\u25b7\\u25ee\\uD834\\uDD1E\\u13eb\\u2ca0\\u0448\\n\\/\\\"()\\t"

 // Convert to UTF 
 text-utf txt status txt_status error-text txt_error

 // Expected UTF result
 set-string utf = "љ\"Doc\"\n\t\b\f\r\t⇗⇘\t▷◮𝄞ᏫⲠш\n/\"()\t"

 // Make sure conversion was successful
 if-true utf not-equal txt or txt_status not-equal GG_OKAY or txt_error not-equal ""
     @Error in converting string to UTF
 end-if

See also
UTF
text-utf  
utf-text  
See all
documentation

Copyright (c) 2019-2025 Gliim LLC. All contents on this web site is "AS IS" without warranties or guarantees of any kind.