25#ifndef SPA_UTILS_DEFS_H
26#define SPA_UTILS_DEFS_H
30# if __cplusplus >= 201103L
31# define SPA_STATIC_ASSERT static_assert
35# if __STDC_VERSION__ >= 201112L
36# define SPA_STATIC_ASSERT _Static_assert
39#ifndef SPA_STATIC_ASSERT
40#define SPA_STATIC_ASSERT(a, b) \
41 ((void)sizeof(struct { int spa_static_assertion_failed : 2 * !!(a) - 1; }))
75#if defined(__clang__) && defined(__cplusplus) && __cplusplus >= 201103L
77# define SPA_FALLTHROUGH [[clang::fallthrough]];
78#elif __GNUC__ >= 7 || __clang_major__ >= 10
79# define SPA_FALLTHROUGH __attribute__ ((fallthrough));
81# define SPA_FALLTHROUGH
84#define SPA_FLAG_MASK(field,mask,flag) (((field) & (mask)) == (flag))
85#define SPA_FLAG_IS_SET(field,flag) SPA_FLAG_MASK(field,flag,flag)
86#define SPA_FLAG_SET(field,flag) ((field) |= (flag))
87#define SPA_FLAG_CLEAR(field, flag) \
89 SPA_STATIC_ASSERT(__builtin_constant_p(flag) ? \
90 (__typeof__(flag))(__typeof__(field))(__typeof__(flag))(flag) == (flag) : \
91 sizeof(field) >= sizeof(flag), \
92 "truncation problem when masking " #field \
94 ((field) &= ~(__typeof__(field))(flag)); \
96#define SPA_FLAG_UPDATE(field,flag,val) ((val) ? SPA_FLAG_SET((field),(flag)) : SPA_FLAG_CLEAR((field),(flag)))
103#define SPA_DIRECTION_REVERSE(d) ((d) ^ 1)
105#define SPA_RECTANGLE(width,height) ((struct spa_rectangle){ (width), (height) })
111#define SPA_POINT(x,y) ((struct spa_point){ (x), (y) })
117#define SPA_REGION(x,y,width,height) ((struct spa_region){ SPA_POINT(x,y), SPA_RECTANGLE(width,height) })
123#define SPA_FRACTION(num,denom) ((struct spa_fraction){ (num), (denom) })
129#define SPA_N_ELEMENTS(arr) (sizeof(arr) / sizeof((arr)[0]))
140#define SPA_FOR_EACH_ELEMENT(arr, ptr) \
141 for ((ptr) = arr; (void*)(ptr) < SPA_PTROFF(arr, sizeof(arr), void); (ptr)++)
145 __typeof__(a) _a = (a); \
146 SPA_LIKELY(_a >= 0) ? _a : -_a; \
148#define SPA_MIN(a,b) \
150 __typeof__(a) _min_a = (a); \
151 __typeof__(b) _min_b = (b); \
152 SPA_LIKELY(_min_a <= _min_b) ? _min_a : _min_b; \
154#define SPA_MAX(a,b) \
156 __typeof__(a) _max_a = (a); \
157 __typeof__(b) _max_b = (b); \
158 SPA_LIKELY(_max_a >= _max_b) ? _max_a : _max_b; \
160#define SPA_CLAMP(v,low,high) \
162 __typeof__(v) _v = (v); \
163 __typeof__(low) _low = (low); \
164 __typeof__(high) _high = (high); \
165 SPA_MIN(SPA_MAX(_v, _low), _high); \
168#define SPA_CLAMPF(v,low,high) \
170 fminf(fmaxf(v, low), high); \
174#define SPA_SWAP(a,b) \
176 __typeof__(a) _t = (a); \
180#define SPA_TYPECHECK(type,x) \
183 (void)(&_dummy == &_dummy2); \
190#define SPA_PTROFF(ptr_,offset_,type_) ((type_*)((uintptr_t)(ptr_) + (ptrdiff_t)(offset_)))
191#define SPA_PTROFF_ALIGN(ptr_,offset_,alignment_,type_) \
192 SPA_PTR_ALIGN(SPA_PTROFF(ptr_,offset_,type_),alignment_,type_)
198#define SPA_MEMBER(b,o,t) SPA_PTROFF(b,o,t)
199#define SPA_MEMBER_ALIGN(b,o,a,t) SPA_PTROFF_ALIGN(b,o,a,t)
201#define SPA_CONTAINER_OF(p,t,m) ((t*)((uintptr_t)(p) - offsetof(t,m)))
203#define SPA_PTRDIFF(p1,p2) ((intptr_t)(p1) - (intptr_t)(p2))
205#define SPA_PTR_TO_INT(p) ((int) ((intptr_t) (p)))
206#define SPA_INT_TO_PTR(u) ((void*) ((intptr_t) (u)))
208#define SPA_PTR_TO_UINT32(p) ((uint32_t) ((uintptr_t) (p)))
209#define SPA_UINT32_TO_PTR(u) ((void*) ((uintptr_t) (u)))
211#define SPA_TIME_INVALID ((int64_t)INT64_MIN)
212#define SPA_IDX_INVALID ((unsigned int)-1)
213#define SPA_ID_INVALID ((uint32_t)0xffffffff)
215#define SPA_NSEC_PER_SEC (1000000000LL)
216#define SPA_NSEC_PER_MSEC (1000000ll)
217#define SPA_NSEC_PER_USEC (1000ll)
218#define SPA_USEC_PER_SEC (1000000ll)
219#define SPA_USEC_PER_MSEC (1000ll)
220#define SPA_MSEC_PER_SEC (1000ll)
222#define SPA_TIMESPEC_TO_NSEC(ts) ((ts)->tv_sec * SPA_NSEC_PER_SEC + (ts)->tv_nsec)
223#define SPA_TIMESPEC_TO_USEC(ts) ((ts)->tv_sec * SPA_USEC_PER_SEC + (ts)->tv_nsec / SPA_NSEC_PER_USEC)
224#define SPA_TIMEVAL_TO_NSEC(tv) ((tv)->tv_sec * SPA_NSEC_PER_SEC + (tv)->tv_usec * SPA_NSEC_PER_USEC)
225#define SPA_TIMEVAL_TO_USEC(tv) ((tv)->tv_sec * SPA_USEC_PER_SEC + (tv)->tv_usec)
228#define SPA_PRINTF_FUNC(fmt, arg1) __attribute__((format(printf, fmt, arg1)))
229#define SPA_FORMAT_ARG_FUNC(arg1) __attribute__((format_arg(arg1)))
230#define SPA_ALIGNED(align) __attribute__((aligned(align)))
231#define SPA_DEPRECATED __attribute__ ((deprecated))
232#define SPA_EXPORT __attribute__((visibility("default")))
233#define SPA_SENTINEL __attribute__((__sentinel__))
234#define SPA_UNUSED __attribute__ ((unused))
235#define SPA_NORETURN __attribute__ ((noreturn))
236#define SPA_WARN_UNUSED_RESULT __attribute__ ((warn_unused_result))
238#define SPA_PRINTF_FUNC(fmt, arg1)
239#define SPA_FORMAT_ARG_FUNC(arg1)
240#define SPA_ALIGNED(align)
241#define SPA_DEPRECATED
246#define SPA_WARN_UNUSED_RESULT
249#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
250#define SPA_RESTRICT restrict
251#elif defined(__GNUC__) && __GNUC__ >= 4
252#define SPA_RESTRICT __restrict__
257#define SPA_ROUND_DOWN(num,value) ((num) - ((num) % (value)))
258#define SPA_ROUND_UP(num,value) ((((num) + (value) - 1) / (value)) * (value))
260#define SPA_MASK_NEGATED(num1, num2) \
262 SPA_STATIC_ASSERT(__builtin_constant_p(num2) ? \
263 (__typeof__(num2))(__typeof__(num1))(__typeof__(num2))(num2) == (num2) : \
264 sizeof(num1) >= sizeof(num2), \
265 "truncation problem when masking " #num1 \
267 ((num1) & ~(__typeof__(num1))(num2)); \
270#define SPA_ROUND_DOWN_N(num,align) SPA_MASK_NEGATED((num), (align) - 1)
271#define SPA_ROUND_UP_N(num,align) SPA_ROUND_DOWN_N((num) + ((align) - 1),align)
273#define SPA_PTR_ALIGNMENT(p,align) ((intptr_t)(p) & ((align)-1))
274#define SPA_IS_ALIGNED(p,align) (SPA_PTR_ALIGNMENT(p,align) == 0)
275#define SPA_PTR_ALIGN(p,align,type) ((type*)SPA_ROUND_UP_N((intptr_t)(p), (intptr_t)(align)))
279#define SPA_LIKELY(x) (__builtin_expect(!!(x),1))
280#define SPA_UNLIKELY(x) (__builtin_expect(!!(x),0))
282#define SPA_LIKELY(x) (x)
283#define SPA_UNLIKELY(x) (x)
287#define SPA_STRINGIFY_1(...) #__VA_ARGS__
288#define SPA_STRINGIFY(...) SPA_STRINGIFY_1(__VA_ARGS__)
290#define spa_return_if_fail(expr) \
292 if (SPA_UNLIKELY(!(expr))) { \
293 fprintf(stderr, "'%s' failed at %s:%u %s()\n", \
294 #expr , __FILE__, __LINE__, __func__); \
299#define spa_return_val_if_fail(expr, val) \
301 if (SPA_UNLIKELY(!(expr))) { \
302 fprintf(stderr, "'%s' failed at %s:%u %s()\n", \
303 #expr , __FILE__, __LINE__, __func__); \
311#define spa_assert_se(expr) \
313 if (SPA_UNLIKELY(!(expr))) { \
314 fprintf(stderr, "'%s' failed at %s:%u %s()\n", \
315 #expr , __FILE__, __LINE__, __func__); \
320#define spa_assert_se(expr) \
322 int _unique_var = (expr); \
329#define spa_nop() do {} while (false)
332#define spa_assert(expr) spa_nop()
333#elif defined (FASTPATH)
334#define spa_assert(expr) spa_assert_se(expr)
336#define spa_assert(expr) spa_assert_se(expr)
340#define spa_assert_not_reached() abort()
342#define spa_assert_not_reached() \
344 fprintf(stderr, "Code should not be reached at %s:%u %s()\n", \
345 __FILE__, __LINE__, __func__); \
350#define spa_memzero(x,l) (memset((x), 0, (l)))
351#define spa_zero(x) (spa_memzero(&(x), sizeof(x)))
353#ifdef SPA_DEBUG_MEMCPY
354#define spa_memcpy(d,s,n) \
356 fprintf(stderr, "%s:%u %s() memcpy(%p, %p, %zd)\n", \
357 __FILE__, __LINE__, __func__, (d), (s), (size_t)(n)); \
360#define spa_memmove(d,s,n) \
362 fprintf(stderr, "%s:%u %s() memmove(%p, %p, %zd)\n", \
363 __FILE__, __LINE__, __func__, (d), (s), (size_t)(n)); \
367#define spa_memcpy(d,s,n) memcpy(d,s,n)
368#define spa_memmove(d,s,n) memmove(d,s,n)
371#define spa_aprintf(_fmt, ...) \
374 if (asprintf(&(_strp), (_fmt), ## __VA_ARGS__ ) == -1) \
spa_direction
Definition: defs.h:107
@ SPA_DIRECTION_INPUT
Definition: defs.h:108
@ SPA_DIRECTION_OUTPUT
Definition: defs.h:109
uint32_t num
Definition: defs.h:139
uint32_t denom
Definition: defs.h:140
int32_t y
Definition: defs.h:126
int32_t x
Definition: defs.h:125
uint32_t width
Definition: defs.h:118
uint32_t height
Definition: defs.h:119
struct spa_point position
Definition: defs.h:132
struct spa_rectangle size
Definition: defs.h:133