HEXENCODE8

HEXENCODE8 encodes the source buffer into base 16 that is encoded as UTF-8. It returns a size_t ¹ value that indicates the number of bytes that are written into the target buffer.

p

Specifies the address of the target buffer.

m

Specifies the length in bytes of the target buffer. It must have a computational type and is converted to type size_t.

q

Specifies the address of the source buffer.

n

Specifies the length in bytes of the source buffer. It must have a computational type and is converted to type size_t.

If the address of the target buffer is zero, the number of bytes that would be written is returned. If the target buffer is not large enough, a value of -1 is returned. If the target buffer is large enough, the number of bytes that is written to the buffer is returned.