i2pd/core/util/base64.h

#ifndef BASE64_H
#define BASE64_H

#include <inttypes.h>
#include <string.h>

namespace i2p
{
namespace util
{

    
    /*
     * Base64 encodes an array of bytes.
     * @return the number of characters written to the output buffer
     * @param InBuffer array of input bytes to be encoded 
     * @param InCount length of the input array
     * @param OutBuffer array to store output characters 
     * @param len length of the output buffer
     * @note zero is returned when the output buffer is too small 
     */
    size_t ByteStreamToBase64 (const uint8_t * InBuffer, size_t InCount, char * OutBuffer, size_t len);

    /**
     * Decodes base 64 encoded data to an array of bytes.
     * @return the number of bytes written to the output buffer
     * @param InBuffer array of input characters to be decoded
     * @param InCount length of the input array
     * @param OutBuffer array to store output bytes
     * @param len length of the output buffer
     * @todo Do not return a negative value on failure, size_t could be unsigned.
     * @note zero is returned when the output buffer is too small 
     */
    size_t Base64ToByteStream (const char * InBuffer, size_t InCount, uint8_t * OutBuffer, size_t len );

    const char * GetBase64SubstitutionTable (); 
    
    /**
     * Decodes base 32 encoded data to an array of bytes.
     * @return the number of bytes written to the output buffer
     * @param inBuf array of input characters to be decoded
     * @param len length of the input buffer
     * @param outBuf array to store output bytes
     * @param outLen length of the output array 
     * @note zero is returned when the output buffer is too small 
     */
    size_t Base32ToByteStream (const char * inBuf, size_t len, uint8_t * outBuf, size_t outLen);

    /**
     * Base 32 encodes an array of bytes.
     * @return the number of bytes written to the output buffer
     * @param inBuf array of input bytes to be encoded
     * @param len length of the input buffer
     * @param outBuf array to store output characters
     * @param outLen length of the output array 
     * @note zero is returned when the output buffer is too small 
     */
    size_t ByteStreamToBase32 (const uint8_t * inBuf, size_t len, char * outBuf, size_t outLen);
}
}

#endif