dav: comparison ucx/cx/common.h

-:b60487c3ec36
+:af685cc9d623
 *
 * <p>
 * Repositories:<br>
 * <a href="https://sourceforge.net/p/ucx/code">https://sourceforge.net/p/ucx/code</a>
 * -&nbsp;or&nbsp;-
-* <a href="https://develop.uap-core.de/hg/ucx">https://develop.uap-core.de/hg/ucx</a>
+* <a href="https://uap-core.de/hg/ucx">https://uap-core.de/hg/ucx</a>
 * </p>
 *
-* <h2>LICENCE</h2>
+* <h2>LICENSE</h2>
 *
 * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 */
 #define __attribute__(x)
 #endif
 /**
+* Inform the compiler that falling through a switch case is intentional.
+*/
+#define cx_attr_fallthrough __attribute__((__fallthrough__))
+/**
 * All pointer arguments must be non-NULL.
 */
 #define cx_attr_nonnull __attribute__((__nonnull__))
 /**
 /**
 * The attributed function always returns freshly allocated memory.
 */
 #define cx_attr_malloc __attribute__((__malloc__))
-#ifndef __clang__
+#if !defined(__clang__) && __GNUC__ >= 11
 /**
 * The pointer returned by the attributed function is supposed to be freed
 * by @p freefunc.
 *
 * @param freefunc the function that shall be used to free the memory
 /**
 * No support for @c null_terminated_string_arg in clang or GCC below 14.
 */
 #define cx_attr_cstr_arg(idx)
 /**
-* No support for access attribute in clang.
+* No support for the access attribute in clang.
 */
 #define cx_attr_access(mode, ...)
 #else
 #if __GNUC__ < 10
 /**
 * Takes one or two arguments: the index of the pointer and (optionally) the
 * index of another argument specifying the maximum number of accessed bytes.
 */
 #define cx_attr_access_w(...) cx_attr_access(__write_only__, __VA_ARGS__)
-#if __STDC_VERSION__ >= 202300L
 /**
 * Do not warn about unused variable.
 */
-#define cx_attr_unused [[maybe_unused]]
+#define cx_attr_unused __attribute__((__unused__))
 /**
 * Warn about discarded return value.
 */
-#define cx_attr_nodiscard [[nodiscard]]
-#else // no C23
-/**
-* Do not warn about unused variable.
-*/
-#define cx_attr_unused __attribute__((__unused__))
-/**
-* Warn about discarded return value.
-*/
 #define cx_attr_nodiscard __attribute__((__warn_unused_result__))
-#endif // __STDC_VERSION__
 // ---------------------------------------------------------------------------
 //       MSVC specifics
 // ---------------------------------------------------------------------------
 #ifdef _MSC_VER
 // fix missing _Thread_local support
 #define _Thread_local __declspec(thread)
 #endif // _MSC_VER
+// ---------------------------------------------------------------------------
+//       Exported and inlined functions
+// ---------------------------------------------------------------------------
 #if defined(CX_WINDLL_EXPORT)
-#define cx_attr_export __declspec(dllexport)
+#define CX_EXPORT __declspec(dllexport)
 #elif defined(CX_WINDLL)
-#define cx_attr_export __declspec(dllimport)
+#define CX_EXPORT __declspec(dllimport)
 #else
 /** Only used for building Windows DLLs. */
-#define cx_attr_export
+#define CX_EXPORT
 #endif // CX_WINDLL / CX_WINDLL_EXPORT
+#ifdef __GNUC__
+/**
+* Declares a function to be inlined.
+*/
+#define CX_INLINE __attribute__((always_inline)) static inline
+#else
+#define CX_INLINE static inline
+#endif
+/**
+* Declares a compatibility function for C++ builds.
+*/
+#define CX_CPPDECL static inline
 // ---------------------------------------------------------------------------
 //       Useful function pointers
 // ---------------------------------------------------------------------------
 /**
 * Function pointer compatible with fwrite-like functions.
 */
-typedef size_t (*cx_write_func)(
+typedef size_t (*cx_write_func)(const void*, size_t, size_t, void*);
-const void *,
-size_t,
-size_t,
-void *
-);
 /**
 * Function pointer compatible with fread-like functions.
 */
-typedef size_t (*cx_read_func)(
+typedef size_t (*cx_read_func)(void*, size_t, size_t, void*);
-void *,
-size_t,
-size_t,
-void *
-);
 // ---------------------------------------------------------------------------
 //       Utility macros
 // ---------------------------------------------------------------------------
 * @retval non-zero the multiplication would overflow
 */
 #if __cplusplus
 extern "C"
 #endif
-cx_attr_export int cx_szmul_impl(size_t a, size_t b, size_t *result);
+CX_EXPORT int cx_szmul_impl(size_t a, size_t b, size_t *result);
 #endif // cx_szmul
 #endif // UCX_COMMON_H

Mercurial > hg > dav / file comparison

comparison: ucx/cx/common.h

ucx/cx/common.h