HEXIMAGE8
HEXIMAGE8 returns a character string that is the UTF-8 hexadecimal representation of the storage at a specified location.
HEXIMAGE8(p,n) returns a character string that is the hexadecimal
representation of n bytes of storage at
location p. Its length is 2 * n
.
HEXIMAGE8(p,n,z) returns a character string that is the
hexadecimal representation of n bytes of
storage at location p with character z inserted
between every set of eight characters in the output string. Its length
is (2 * n)
+ ((n - 1)/4)
.
- p
- A restricted expression that must have a locator type (POINTER or OFFSET). If p is OFFSET, it must have the AREA attribute.
- n
- An expression. n must have a computational type and is converted to FIXED BINARY(31,0).
- z
- An expression. If specified, z must have the type CHARACTER(1) NONVARYING and must be a valid 1-byte UTF-8 character.
If the number of bytes to be converted to hex is not known at compile time, then no more than 32767 bytes will be converted.
For examples of the HEXIMAGE8 built-in function, see HEX8.