Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.

For information on migrating to InterSystems IRIS, see Why Migrate to InterSystems IRIS?

$ZWCHAR (ObjectScript)

Converts a number to a two-byte string.

Synopsis

$ZWCHAR(n)
$ZWC(n)

Parameter

Argument Description
n A positive integer in the range 0 through 65535. It can be specified as a value, a variable, or an expression.

Description

$ZWCHAR returns a two-byte (wide) character string corresponding to the binary representation of n. The bytes of the character string are presented in little-endian byte order, with the least significant byte first. It is the functional equivalent of:

   WRITE $CHAR(n#256,n\256)

If n is out of range or a negative number, $ZWCHAR returns the null string.

Example

The following example returns the two-byte string for the integer 25185:

   WRITE $ZWCHAR(25185)

returns: ab

Notes

$ZWCHAR and $CHAR

$ZWCHAR is similar to $CHAR except that it operates on two byte (16-bit) words instead of single 8-bit bytes. For four byte (32-bit) words, use $ZLCHAR; For eight byte (64-bit) words, use $ZQCHAR.

$ZWCHAR and $ZWASCII

$ZWASCII is the logical inverse of the $ZWCHAR function. For example:

   WRITE $ZWCHAR(25185)

returns: ab

   WRITE $ZWASCII("ab")

returns: 25185

See Also

Feedback