mirror of https://git.tukaani.org/xz.git
89 lines
2.7 KiB
C
89 lines
2.7 KiB
C
///////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
/// \file tuklib_common.h
|
|
/// \brief Common definitions for tuklib modules
|
|
//
|
|
// 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
|