comparison: ucx/cx/common.h
ucx/cx/common.h
- branch
- dav-2
- changeset 886
- da79af4baec8
- parent 854
- 1c8401ece69e
- child 889
- 42cdbf9bbd49
equal
deleted
inserted
replaced
| 885:591377a27fa3 | 886:da79af4baec8 |
|---|---|
| 44 * | 44 * |
| 45 * <p> | 45 * <p> |
| 46 * Repositories:<br> | 46 * Repositories:<br> |
| 47 * <a href="https://sourceforge.net/p/ucx/code">https://sourceforge.net/p/ucx/code</a> | 47 * <a href="https://sourceforge.net/p/ucx/code">https://sourceforge.net/p/ucx/code</a> |
| 48 * - or - | 48 * - or - |
| 49 * <a href="https://develop.uap-core.de/hg/ucx">https://develop.uap-core.de/hg/ucx</a> | 49 * <a href="https://uap-core.de/hg/ucx">https://uap-core.de/hg/ucx</a> |
| 50 * </p> | 50 * </p> |
| 51 * | 51 * |
| 52 * <h2>LICENCE</h2> | 52 * <h2>LICENCE</h2> |
| 53 * | 53 * |
| 54 * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved. | 54 * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved. |
| 129 */ | 129 */ |
| 130 #define __attribute__(x) | 130 #define __attribute__(x) |
| 131 #endif | 131 #endif |
| 132 | 132 |
| 133 /** | 133 /** |
| 134 * Inform the compiler that falling through a switch case is intentional. | |
| 135 */ | |
| 136 #define cx_attr_fallthrough __attribute__((__fallthrough__)) | |
| 137 | |
| 138 /** | |
| 134 * All pointer arguments must be non-NULL. | 139 * All pointer arguments must be non-NULL. |
| 135 */ | 140 */ |
| 136 #define cx_attr_nonnull __attribute__((__nonnull__)) | 141 #define cx_attr_nonnull __attribute__((__nonnull__)) |
| 137 | 142 |
| 138 /** | 143 /** |
| 148 /** | 153 /** |
| 149 * The attributed function always returns freshly allocated memory. | 154 * The attributed function always returns freshly allocated memory. |
| 150 */ | 155 */ |
| 151 #define cx_attr_malloc __attribute__((__malloc__)) | 156 #define cx_attr_malloc __attribute__((__malloc__)) |
| 152 | 157 |
| 153 #ifndef __clang__ | 158 #if !defined(__clang__) && __GNUC__ >= 11 |
| 154 /** | 159 /** |
| 155 * The pointer returned by the attributed function is supposed to be freed | 160 * The pointer returned by the attributed function is supposed to be freed |
| 156 * by @p freefunc. | 161 * by @p freefunc. |
| 157 * | 162 * |
| 158 * @param freefunc the function that shall be used to free the memory | 163 * @param freefunc the function that shall be used to free the memory |
| 238 * Takes one or two arguments: the index of the pointer and (optionally) the | 243 * Takes one or two arguments: the index of the pointer and (optionally) the |
| 239 * index of another argument specifying the maximum number of accessed bytes. | 244 * index of another argument specifying the maximum number of accessed bytes. |
| 240 */ | 245 */ |
| 241 #define cx_attr_access_w(...) cx_attr_access(__write_only__, __VA_ARGS__) | 246 #define cx_attr_access_w(...) cx_attr_access(__write_only__, __VA_ARGS__) |
| 242 | 247 |
| 243 #if __STDC_VERSION__ >= 202300L | |
| 244 | |
| 245 /** | 248 /** |
| 246 * Do not warn about unused variable. | 249 * Do not warn about unused variable. |
| 247 */ | 250 */ |
| 248 #define cx_attr_unused [[maybe_unused]] | 251 #define cx_attr_unused __attribute__((__unused__)) |
| 249 | 252 |
| 250 /** | 253 /** |
| 251 * Warn about discarded return value. | 254 * Warn about discarded return value. |
| 252 */ | 255 */ |
| 253 #define cx_attr_nodiscard [[nodiscard]] | |
| 254 | |
| 255 #else // no C23 | |
| 256 | |
| 257 /** | |
| 258 * Do not warn about unused variable. | |
| 259 */ | |
| 260 #define cx_attr_unused __attribute__((__unused__)) | |
| 261 | |
| 262 /** | |
| 263 * Warn about discarded return value. | |
| 264 */ | |
| 265 #define cx_attr_nodiscard __attribute__((__warn_unused_result__)) | 256 #define cx_attr_nodiscard __attribute__((__warn_unused_result__)) |
| 266 | |
| 267 #endif // __STDC_VERSION__ | |
| 268 | 257 |
| 269 | 258 |
| 270 // --------------------------------------------------------------------------- | 259 // --------------------------------------------------------------------------- |
| 271 // MSVC specifics | 260 // MSVC specifics |
| 272 // --------------------------------------------------------------------------- | 261 // --------------------------------------------------------------------------- |
