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.
