BASE64DECODE8

BASE64DECODE8 decodes the source buffer from base 64 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.

This function is the reverse of the function BASE64ENCODE8 and expects that the base 64 source was encoded by using the same convention that the BASE64ENCODE8 function uses. See Convention for encoding a source buffer into base 64 as UTF-8 for details. If other conventions were used, the results are unpredictable.