bsl_base64.h

/*
 * This file is part of the openHiTLS project.
 *
 * openHiTLS is licensed under the Mulan PSL v2.
 * You can use this software according to the terms and conditions of the Mulan PSL v2.
 * You may obtain a copy of Mulan PSL v2 at:
 *
 *     http://license.coscl.org.cn/MulanPSL2
 *
 * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
 * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
 * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
 * See the Mulan PSL v2 for more details.
 */
 
#ifndef BSL_BASE64_H
#define BSL_BASE64_H
 
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define HITLS_BASE64_CTX_BUF_LENGTH 80
#define HITLS_BASE64_CTX_LENGTH 48
/* Input length (len) divided by 3, rounded up, multiplied by 4, then add the number of newline characters,and
   add the length of the context buffer */
#define HITLS_BASE64_ENCODE_LENGTH(len) \
    ((((len) + 2) / 3 * 4) + ((len) / HITLS_BASE64_CTX_LENGTH + 1) * 2 + HITLS_BASE64_CTX_BUF_LENGTH)
#define HITLS_BASE64_DECODE_LENGTH(len) (((len) + 3) / 4 * 3 + HITLS_BASE64_CTX_BUF_LENGTH)
 
/*
 * When writing, it makes all the data written on one line without a newline character at the end;
 * When reading, it expects all data to be on one line (regardless of whether there is a trailing newline character)
 */
#define BSL_BASE64_FLAGS_NO_NEWLINE  0x01
 
typedef struct BASE64_ControlBlock BSL_Base64Ctx;

int32_t BSL_BASE64_Encode(const uint8_t *srcBuf, const uint32_t srcBufLen, char *dstBuf, uint32_t *dstBufLen);

int32_t BSL_BASE64_Decode(const char *srcBuf, const uint32_t srcBufLen, uint8_t *dstBuf, uint32_t *dstBufLen);

BSL_Base64Ctx *BSL_BASE64_CtxNew(void);

void BSL_BASE64_CtxFree(BSL_Base64Ctx *ctx);

void BSL_BASE64_CtxClear(BSL_Base64Ctx *ctx);

int32_t BSL_BASE64_EncodeInit(BSL_Base64Ctx *ctx);

int32_t BSL_BASE64_EncodeUpdate(BSL_Base64Ctx *ctx, const uint8_t *srcBuf, uint32_t srcBufLen,
    char *dstBuf, uint32_t *dstBufLen);

int32_t BSL_BASE64_EncodeFinal(BSL_Base64Ctx *ctx, char *dstBuf, uint32_t *dstBufLen);

int32_t BSL_BASE64_DecodeInit(BSL_Base64Ctx *ctx);

int32_t BSL_BASE64_DecodeUpdate(BSL_Base64Ctx *ctx, const char *srcBuf, const uint32_t srcBufLen,
    uint8_t *dstBuf, uint32_t *dstBufLen);

int32_t BSL_BASE64_DecodeFinal(BSL_Base64Ctx *ctx, uint8_t *dstBuf, uint32_t *dstBufLen);

int32_t BSL_BASE64_SetFlags(BSL_Base64Ctx *ctx, uint32_t flags);
 
#ifdef __cplusplus
}
#endif
 
#endif