cbprintf.h

Go to the documentation of this file.

/*
 * Copyright (c) 2020 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_SYS_CBPRINTF_H_
#define ZEPHYR_INCLUDE_SYS_CBPRINTF_H_
 
#include <stdarg.h>
#include <stddef.h>
#include <stdint.h>
#include <zephyr/toolchain.h>
#include <string.h>
 
#ifdef CONFIG_CBPRINTF_LIBC_SUBSTS
#include <stdio.h>
#endif /* CONFIG_CBPRINTF_LIBC_SUBSTS */
 
/* Determine if _Generic is supported using macro from toolchain.h.
 *
 * @note Z_C_GENERIC is also set for C++ where functionality is implemented
 * using overloading and templates.
 */
#ifndef Z_C_GENERIC
#if defined(__cplusplus) || TOOLCHAIN_HAS_C_GENERIC
#define Z_C_GENERIC 1
#else
#define Z_C_GENERIC 0
#endif
#endif
 
/* Z_C_GENERIC is used there */
#include <zephyr/sys/cbprintf_internal.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#ifdef __xtensa__
#define CBPRINTF_PACKAGE_ALIGNMENT 16
#else
#define CBPRINTF_PACKAGE_ALIGNMENT \
        Z_POW2_CEIL(COND_CODE_1(CONFIG_CBPRINTF_PACKAGE_LONGDOUBLE, \
                (sizeof(long double)), (MAX(sizeof(double), sizeof(long long)))))
#endif
 
BUILD_ASSERT(Z_IS_POW2(CBPRINTF_PACKAGE_ALIGNMENT));
 
#define CBPRINTF_PACKAGE_CONST_CHAR_RO BIT(0)
 
#define CBPRINTF_PACKAGE_ADD_RO_STR_POS BIT(1)
 
#define CBPRINTF_PACKAGE_ADD_RW_STR_POS BIT(2)
 
#define Z_CBPRINTF_PACKAGE_FIRST_RO_STR_BITS 3
#define Z_CBPRINTF_PACKAGE_FIRST_RO_STR_OFFSET 3
#define Z_CBPRINTF_PACKAGE_FIRST_RO_STR_MASK BIT_MASK(Z_CBPRINTF_PACKAGE_FIRST_RO_STR_BITS)
 
#define CBPRINTF_PACKAGE_FIRST_RO_STR_CNT(n) \
        (n << Z_CBPRINTF_PACKAGE_FIRST_RO_STR_OFFSET)
 
#define Z_CBPRINTF_PACKAGE_FIRST_RO_STR_CNT_GET(flags) \
        (((flags) >> Z_CBPRINTF_PACKAGE_FIRST_RO_STR_OFFSET) & Z_CBPRINTF_PACKAGE_FIRST_RO_STR_MASK)
 
#define CBPRINTF_PACKAGE_ADD_STRING_IDXS \
        (CBPRINTF_PACKAGE_ADD_RO_STR_POS | CBPRINTF_PACKAGE_CONST_CHAR_RO)
 
#define CBPRINTF_PACKAGE_COPY_RO_STR BIT(0)
 
#define CBPRINTF_PACKAGE_COPY_RW_STR BIT(1)
 
#define CBPRINTF_PACKAGE_COPY_KEEP_RO_STR BIT(2)
 
#ifdef __CHECKER__
typedef int (*cbprintf_cb)(int c, void *ctx);
#else
typedef int (*cbprintf_cb)(/* int c, void *ctx */);
#endif
 
typedef int (*cbprintf_convert_cb)(const void *buf, size_t len, void *ctx);
 
typedef int (*cbvprintf_exteral_formatter_func)(cbprintf_cb out, void *ctx,
                                                const char *fmt, va_list ap);
 
#define CBPRINTF_MUST_RUNTIME_PACKAGE(flags, ... /* fmt, ... */) \
        Z_CBPRINTF_MUST_RUNTIME_PACKAGE(flags, __VA_ARGS__)
 
#define CBPRINTF_STATIC_PACKAGE(packaged, inlen, outlen, align_offset, flags, \
                                ... /* fmt, ... */) \
        Z_CBPRINTF_STATIC_PACKAGE(packaged, inlen, outlen, \
                                  align_offset, flags, __VA_ARGS__)
 
__printf_like(4, 5)
int cbprintf_package(void *packaged,
                     size_t len,
                     uint32_t flags,
                     const char *format,
                     ...);
 
int cbvprintf_package(void *packaged,
                      size_t len,
                      uint32_t flags,
                      const char *format,
                      va_list ap);
 
int cbprintf_package_convert(void *in_packaged,
                             size_t in_len,
                             cbprintf_convert_cb cb,
                             void *ctx,
                             uint32_t flags,
                             uint16_t *strl,
                             size_t strl_len);
 
/* @interal Context used for package copying. */
struct z_cbprintf_buf_desc {
        void *buf;
        size_t size;
        size_t off;
};
 
/* @internal Function callback used for package copying. */
static inline int z_cbprintf_cpy(const void *buf, size_t len, void *ctx)
{
        struct z_cbprintf_buf_desc *desc = (struct z_cbprintf_buf_desc *)ctx;
 
        if ((desc->size - desc->off) < len) {
                return -ENOSPC;
        }
 
        memcpy(&((uint8_t *)desc->buf)[desc->off], (void *)buf, len);
        desc->off += len;
 
        return len;
}
 
static inline int cbprintf_package_copy(void *in_packaged,
                                        size_t in_len,
                                        void *packaged,
                                        size_t len,
                                        uint32_t flags,
                                        uint16_t *strl,
                                        size_t strl_len)
{
        struct z_cbprintf_buf_desc buf_desc = {
                .buf = packaged,
                .size = len
        };
 
        return cbprintf_package_convert(in_packaged, in_len,
                                        packaged ? z_cbprintf_cpy : NULL, &buf_desc,
                                        flags, strl, strl_len);
}
 
static inline int cbprintf_fsc_package(void *in_packaged,
                                       size_t in_len,
                                       void *packaged,
                                       size_t len)
{
        return cbprintf_package_copy(in_packaged, in_len, packaged, len,
                                     CBPRINTF_PACKAGE_COPY_RO_STR |
                                     CBPRINTF_PACKAGE_COPY_RW_STR, NULL, 0);
}
 
int cbpprintf_external(cbprintf_cb out,
                       cbvprintf_exteral_formatter_func formatter,
                       void *ctx,
                       void *packaged);
 
__printf_like(3, 4)
int cbprintf(cbprintf_cb out, void *ctx, const char *format, ...);
 
int cbvprintf(cbprintf_cb out, void *ctx, const char *format, va_list ap);
 
static inline
int cbpprintf(cbprintf_cb out, void *ctx, void *packaged)
{
        return cbpprintf_external(out, cbvprintf, ctx, packaged);
}
 
#ifdef CONFIG_CBPRINTF_LIBC_SUBSTS
 
__printf_like(2, 3)
int fprintfcb(FILE * stream, const char *format, ...);
 
int vfprintfcb(FILE *stream, const char *format, va_list ap);
 
__printf_like(1, 2)
int printfcb(const char *format, ...);
 
int vprintfcb(const char *format, va_list ap);
 
__printf_like(3, 4)
int snprintfcb(char *str, size_t size, const char *format, ...);
 
int vsnprintfcb(char *str, size_t size, const char *format, va_list ap);
 
#endif /* CONFIG_CBPRINTF_LIBC_SUBSTS */
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_SYS_CBPRINTF_H_ */