base64.h

/*
 * SPDX-FileCopyrightText: 2014 HAW Hamburg
 * SPDX-FileCopyrightText: 2014 Martin Landsmann <Martin.Landsmann@HAW-Hamburg.de>
 * SPDX-License-Identifier: LGPL-2.1-only
 */
 
#pragma once

 
#include <stddef.h> /* for size_t */
#include <stdbool.h> /* for bool */
 
#include "compiler_hints.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define BASE64_SUCCESS                  (0)  
#define BASE64_ERROR_BUFFER_OUT         (-1) 
#define BASE64_ERROR_BUFFER_OUT_SIZE    (-2) 
#define BASE64_ERROR_DATA_IN            (-3) 
#define BASE64_ERROR_DATA_IN_SIZE       (-4) 
#define BASE64_ERROR_OVERFLOW           (-5) 

static inline size_t base64_estimate_decode_size(size_t base64_in_size)
{
    return (((base64_in_size + 3) / 4) * 3);
}

static inline size_t base64_estimate_encode_size(size_t data_in_size)
{
    return (4 * ((data_in_size + 2) / 3));
}

static inline bool base64_can_estimate_encode_size(size_t data_in_size)
{
    return (data_in_size <= (SIZE_MAX / 4) * 3);
}

ACCESS(read_only, 1, 2)
int base64_encode(const void *data_in, size_t data_in_size,
                  void *base64_out, size_t *base64_out_size);

ACCESS(read_only, 1, 2)
int base64url_encode(const void *data_in, size_t data_in_size,
                     void *base64_out, size_t *base64_out_size);

ACCESS(read_only, 1, 2)
int base64_decode(const void *base64_in, size_t base64_in_size,
                  void *data_out, size_t *data_out_size);
 
#ifdef __cplusplus
}
#endif