Commit | Line | Data |
---|---|---|
eb31c5e6 | 1 | /* |
0235b0db | 2 | * SPDX-License-Identifier: MIT |
eb31c5e6 | 3 | * |
0235b0db | 4 | * Copyright 2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com> |
eb31c5e6 | 5 | */ |
fd3c708f | 6 | |
0235b0db MJ |
7 | #ifndef _BABELTRACE_INTERNAL_H |
8 | #define _BABELTRACE_INTERNAL_H | |
70bd0a12 | 9 | |
826b4673 PP |
10 | #ifdef __cplusplus |
11 | extern "C" { | |
12 | #endif | |
13 | ||
087cd0f5 SM |
14 | #ifdef __cplusplus |
15 | #define BT_EXTERN_C extern "C" | |
16 | #else | |
17 | #define BT_EXTERN_C | |
18 | #endif | |
19 | ||
91d81473 | 20 | #define bt_max_t(type, a, b) \ |
f3e4505b | 21 | ((type) (a) > (type) (b) ? (type) (a) : (type) (b)) |
f3e4505b | 22 | |
5d6c80a5 | 23 | /* |
1353b066 | 24 | * BT_EXPORT: set the visibility for exported functions. |
5d6c80a5 | 25 | */ |
675860f4 | 26 | #if defined(_WIN32) || defined(__CYGWIN__) |
1353b066 | 27 | #define BT_EXPORT |
675860f4 | 28 | #else |
1353b066 | 29 | #define BT_EXPORT __attribute__((visibility("default"))) |
675860f4 | 30 | #endif |
5d6c80a5 | 31 | |
9340eff9 SM |
32 | /* Enable `txt` if developer mode is enabled. */ |
33 | #ifdef BT_DEV_MODE | |
34 | #define BT_IF_DEV_MODE(txt) txt | |
35 | #else | |
36 | #define BT_IF_DEV_MODE(txt) | |
37 | #endif | |
38 | ||
55b71f05 SM |
39 | /* |
40 | * Yield `ref`'s value while setting `ref` to NULL. | |
41 | * | |
42 | * This can be used to give a strong reference to a callee: | |
43 | * | |
44 | * add_foo_to_list(list, BT_MOVE_REF(foo)); | |
45 | * | |
46 | * or in a simple assignment: | |
47 | * | |
48 | * my_struct->foo = BT_MOVE_REF(foo); | |
49 | * | |
50 | * When moving a reference in a function call, the reference is given to the | |
51 | * callee even if that function call fails, so make sure the called function | |
52 | * is written accordingly. | |
53 | */ | |
54 | ||
55 | #define BT_MOVE_REF(ref) \ | |
56 | ({ \ | |
0ec1ae8b | 57 | __typeof__(ref) _ref = ref; \ |
55b71f05 SM |
58 | ref = NULL; \ |
59 | _ref; \ | |
60 | }) | |
61 | ||
d50d46f3 SM |
62 | /* Wrapper for g_array_index that adds bound checking. */ |
63 | #define bt_g_array_index(a, t, i) \ | |
64 | g_array_index((a), t, ({ BT_ASSERT_DBG((i) < (a)->len); (i); })) | |
65 | ||
1778c2a4 PP |
66 | /* |
67 | * Copied from: | |
68 | * <https://stackoverflow.com/questions/37411809/how-to-elegantly-fix-this-unused-variable-warning/37412551#37412551>: | |
69 | * | |
70 | * * sizeof() ensures that the expression is not evaluated at all, so | |
71 | * its side-effects don't happen. That is to be consistent with the | |
72 | * usual behaviour of debug-only constructs, such as assert(). | |
73 | * | |
74 | * * `((_expr), 0)` uses the comma operator to swallow the actual type | |
75 | * of `(_expr)`. This is to prevent VLAs from triggering evaluation. | |
76 | * | |
77 | * * `(void)` explicitly ignores the result of `(_expr)` and sizeof() so | |
78 | * no "unused value" warning appears. | |
79 | */ | |
80 | ||
81 | #define BT_USE_EXPR(_expr) ((void) sizeof((void) (_expr), 0)) | |
82 | #define BT_USE_EXPR2(_expr1, _expr2) \ | |
83 | ((void) sizeof((void) (_expr1), (void) (_expr2), 0)) | |
84 | #define BT_USE_EXPR3(_expr1, _expr2, _expr3) \ | |
85 | ((void) sizeof((void) (_expr1), (void) (_expr2), (void) (_expr3), 0)) | |
86 | #define BT_USE_EXPR4(_expr1, _expr2, _expr3, _expr4) \ | |
87 | ((void) sizeof((void) (_expr1), (void) (_expr2), \ | |
88 | (void) (_expr3), (void) (_expr4), 0)) | |
89 | #define BT_USE_EXPR5(_expr1, _expr2, _expr3, _expr4, _expr5) \ | |
90 | ((void) sizeof((void) (_expr1), (void) (_expr2), \ | |
91 | (void) (_expr3), (void) (_expr4), (void) (_expr5), 0)) | |
92 | ||
2ea09241 SM |
93 | #if defined __clang__ |
94 | # if __has_warning("-Wunused-but-set-variable") | |
95 | # define BT_DIAG_IGNORE_UNUSED_BUT_SET_VARIABLE \ | |
96 | _Pragma("GCC diagnostic ignored \"-Wunused-but-set-variable\"") | |
97 | # endif | |
98 | #endif | |
99 | ||
100 | #if !defined BT_DIAG_IGNORE_UNUSED_BUT_SET_VARIABLE | |
101 | # define BT_DIAG_IGNORE_UNUSED_BUT_SET_VARIABLE | |
102 | #endif | |
103 | ||
826b4673 PP |
104 | #ifdef __cplusplus |
105 | } | |
106 | #endif | |
107 | ||
70bd0a12 | 108 | #endif |