Caché ObjectScript Reference - InterSystems Documentation

System and Other FunctionsEncoding Translation$ZCONVERT(string, mode, trans) performs either an input encoding translation or an outputencoding translation on string. In the three-argument form, the mode values you can use areeither "I" or "O". You must define the mode value. The trans value can be a numeric characteror a string that specifies the translation table or translation handle to use.ParametersstringThe string can be specified as a value, a variable, or an expression.modeA letter specifying the type of encoding translation, as shown in the previous table.transThe translation table to use. The trans value can be:• An integer value describing a process I/O translation object (0 for the current process I/Otranslation object.)• A string value describing an I/O translation table name (null string for the default processI/O translation table name.)• A Named table. A named table can be defined in a locale and points to one or two translationtables. Use a named table to define a specific system-to/from-device encoding.Supplied translation tables include HTML, which adds (output mode) or removes (inputmode) HTML escape characters to a string, and URL, which adds (output mode) orremoves (input mode) URL parameter escape characters to a string.• "" (null string), which will use the default process I/O translation table name. (Forequivalent functionality, see the $$GetPDefIO^%NLS() function of the %NLS utility.)ExamplesThe following example returns "HELLO":WRITE $ZCONVERT("Hello","U")The following example returns "hello":WRITE $ZCVT("Hello","L")The following example returns "HELLO":524 Caché ObjectScript Reference