ENCODE/DECODE CARETS AND CTRL CHARS    ICR (1136)

Takes a string, converts any "^" to "~U~", and
returns the result.

This function is identical to $$ENCODEUP^XMXUTIL (DBIA 2734).

This function is used when putting strings, which may contain "^", into fields
in globals.  Fields in globals are delimited by "^", so any "^" in a string
would, in effect, create an unintended field.  So, before we put such strings
into fields, we convert any "^".  MailMan uses this to convert any subjects
with "^" before putting them in the .01 field in the MESSAGE file, 3.9.

Usage:  S X=$$ENCODEUP^XMCU1(string)

Takes a string, converts any "~U~" to "^", and
returns the result.

This function is identical to $$DECODEUP^XMXUTIL (DBIA 2734).

Usage: S X=$$DECODEUP^XMCU1(STRING)

Takes a string, converts any control characters (and
"~") to printable characters, and returns the result.  The conversion may be
undone by $$RTRAN^XMCU1.

Usage: S X=$$STRAN^XMCU1(STRING)

Note:
"~" is replaced by "~>"
$C(I)           by $C(I+64)  for I=0 to 31, for example
$C(0)           by "~@"
$C(1)           by "~A"
$C(7)           by "~G"   (i.e. BELL)
$C(13)          by "~M"   (i.e. CR = Carriage Return)
$C(26)          by "~Z"
$C(31)          by "~_"
etc.

Takes a string which had been converted by
$$STRAN^XMCU1, undoes the conversion, and returns the result.