tuklib_common.h

Go to the documentation of this file.

// SPDX-License-Identifier: 0BSD
 
//
//
//  Author:     Lasse Collin
//
 
#ifndef TUKLIB_COMMON_H
#define TUKLIB_COMMON_H
 
// The config file may be replaced by a package-specific file.
// It should include at least stddef.h, stdbool.h, inttypes.h, and limits.h.
#include "tuklib_config.h"
 
// TUKLIB_SYMBOL_PREFIX is prefixed to all symbols exported by
// the tuklib modules. If you use a tuklib module in a library,
// you should use TUKLIB_SYMBOL_PREFIX to make sure that there
// are no symbol conflicts in case someone links your library
// into application that also uses the same tuklib module.
#ifndef TUKLIB_SYMBOL_PREFIX
#   define TUKLIB_SYMBOL_PREFIX
#endif
 
#define TUKLIB_CAT_X(a, b) a ## b
#define TUKLIB_CAT(a, b) TUKLIB_CAT_X(a, b)
 
#ifndef TUKLIB_SYMBOL
#   define TUKLIB_SYMBOL(sym) TUKLIB_CAT(TUKLIB_SYMBOL_PREFIX, sym)
#endif
 
#ifndef TUKLIB_DECLS_BEGIN
#   ifdef __cplusplus
#       define TUKLIB_DECLS_BEGIN extern "C" {
#   else
#       define TUKLIB_DECLS_BEGIN
#   endif
#endif
 
#ifndef TUKLIB_DECLS_END
#   ifdef __cplusplus
#       define TUKLIB_DECLS_END }
#   else
#       define TUKLIB_DECLS_END
#   endif
#endif
 
#if defined(__GNUC__) && defined(__GNUC_MINOR__)
#   define TUKLIB_GNUC_REQ(major, minor) \
        ((__GNUC__ == (major) && __GNUC_MINOR__ >= (minor)) \
            || __GNUC__ > (major))
#else
#   define TUKLIB_GNUC_REQ(major, minor) 0
#endif
 
// tuklib_attr_noreturn attribute is used to mark functions as non-returning.
// We cannot use "noreturn" as the macro name because then C23 code that
// uses [[noreturn]] would break as it would expand to [[ [[noreturn]] ]].
//
// tuklib_attr_noreturn must be used at the beginning of function declaration
// to work in all cases. The [[noreturn]] syntax is the most limiting, it
// must be even before any GNU C's __attribute__ keywords:
//
//     tuklib_attr_noreturn
//     __attribute__((nonnull(1)))
//     extern void foo(const char *s);
//
// FIXME: Update __STDC_VERSION__ for the final C23 version. 202000 is used
// by GCC 13 and Clang 15 with -std=c2x.
#if   defined(__STDC_VERSION__) && __STDC_VERSION__ >= 202000
#   define tuklib_attr_noreturn [[noreturn]]
#elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112
#   define tuklib_attr_noreturn _Noreturn
#elif TUKLIB_GNUC_REQ(2, 5)
#   define tuklib_attr_noreturn __attribute__((__noreturn__))
#elif defined(_MSC_VER)
#   define tuklib_attr_noreturn __declspec(noreturn)
#else
#   define tuklib_attr_noreturn
#endif
 
#if (defined(_WIN32) && !defined(__CYGWIN__)) \
        || defined(__OS2__) || defined(__MSDOS__)
#   define TUKLIB_DOSLIKE 1
#endif
 
#endif