Go to the documentation of this file. 25 #ifndef SPA_UTILS_DEFS_H 26 #define SPA_UTILS_DEFS_H 63 #if defined(__clang__) && defined(__cplusplus) && __cplusplus >= 201103L 65 # define SPA_FALLTHROUGH [[clang::fallthrough]]; 66 #elif __GNUC__ >= 7 || __clang_major__ >= 10 67 # define SPA_FALLTHROUGH __attribute__ ((fallthrough)); 69 # define SPA_FALLTHROUGH 72 #define SPA_FLAG_MASK(field,mask,flag) (((field) & (mask)) == (flag)) 73 #define SPA_FLAG_IS_SET(field,flag) SPA_FLAG_MASK(field,flag,flag) 74 #define SPA_FLAG_SET(field,flag) ((field) |= (flag)) 75 #define SPA_FLAG_CLEAR(field,flag) ((field) &= ~(flag)) 76 #define SPA_FLAG_UPDATE(field,flag,val) ((val) ? SPA_FLAG_SET(field,flag) : SPA_FLAG_CLEAR(field,flag)) 83 #define SPA_DIRECTION_REVERSE(d) ((d) ^ 1) 85 #define SPA_RECTANGLE(width,height) (struct spa_rectangle){ width, height } 91 #define SPA_POINT(x,y) (struct spa_point){ x, y } 97 #define SPA_REGION(x,y,width,height) (struct spa_region){ SPA_POINT(x,y), SPA_RECTANGLE(width,height) } 103 #define SPA_FRACTION(num,denom) (struct spa_fraction){ num, denom } 109 #define SPA_N_ELEMENTS(arr) (sizeof(arr) / sizeof((arr)[0])) 120 #define SPA_FOR_EACH_ELEMENT(arr, ptr) \ 121 for (ptr = arr; (void*)ptr < SPA_PTROFF(arr, sizeof(arr), void); ptr++) 123 #define SPA_MIN(a,b) \ 125 __typeof__(a) _min_a = (a); \ 126 __typeof__(b) _min_b = (b); \ 127 SPA_LIKELY(_min_a < _min_b) ? _min_a : _min_b; \ 129 #define SPA_MAX(a,b) \ 131 __typeof__(a) _max_a = (a); \ 132 __typeof__(b) _max_b = (b); \ 133 SPA_LIKELY(_max_a > _max_b) ? _max_a : _max_b; \ 135 #define SPA_CLAMP(v,low,high) \ 137 __typeof__(v) _v = (v); \ 138 __typeof__(low) _low = (low); \ 139 __typeof__(high) _high = (high); \ 140 SPA_MIN(SPA_MAX(_v, _low), _high); \ 143 #define SPA_SWAP(a,b) \ 145 __typeof__(a) _t = (a); \ 149 #define SPA_TYPECHECK(type,x) \ 152 (void)(&_dummy == &_dummy2); \ 159 #define SPA_PTROFF(ptr_,offset_,type_) ((type_*)((uint8_t*)(ptr_) + (int)(offset_))) 160 #define SPA_PTROFF_ALIGN(ptr_,offset_,alignment_,type_) \ 161 SPA_PTR_ALIGN(SPA_PTROFF(ptr_,offset_,type_),alignment_,type_) 167 #define SPA_MEMBER(b,o,t) SPA_PTROFF(b,o,t) 168 #define SPA_MEMBER_ALIGN(b,o,a,t) SPA_PTROFF_ALIGN(b,o,a,t) 170 #define SPA_CONTAINER_OF(p,t,m) (t*)((uint8_t*)p - offsetof (t,m)) 172 #define SPA_PTRDIFF(p1,p2) ((uint8_t*)(p1) - (uint8_t*)(p2)) 174 #define SPA_PTR_TO_INT(p) ((int) ((intptr_t) (p))) 175 #define SPA_INT_TO_PTR(u) ((void*) ((intptr_t) (u))) 177 #define SPA_PTR_TO_UINT32(p) ((uint32_t) ((uintptr_t) (p))) 178 #define SPA_UINT32_TO_PTR(u) ((void*) ((uintptr_t) (u))) 180 #define SPA_TIME_INVALID ((int64_t)INT64_MIN) 181 #define SPA_IDX_INVALID ((unsigned int)-1) 182 #define SPA_ID_INVALID ((uint32_t)0xffffffff) 184 #define SPA_NSEC_PER_SEC (1000000000ll) 185 #define SPA_NSEC_PER_MSEC (1000000ll) 186 #define SPA_NSEC_PER_USEC (1000ll) 187 #define SPA_USEC_PER_SEC (1000000ll) 188 #define SPA_USEC_PER_MSEC (1000ll) 189 #define SPA_MSEC_PER_SEC (1000ll) 191 #define SPA_TIMESPEC_TO_NSEC(ts) ((ts)->tv_sec * SPA_NSEC_PER_SEC + (ts)->tv_nsec) 192 #define SPA_TIMESPEC_TO_USEC(ts) ((ts)->tv_sec * SPA_USEC_PER_SEC + (ts)->tv_nsec / SPA_NSEC_PER_USEC) 193 #define SPA_TIMEVAL_TO_NSEC(tv) ((tv)->tv_sec * SPA_NSEC_PER_SEC + (tv)->tv_usec * SPA_NSEC_PER_USEC) 194 #define SPA_TIMEVAL_TO_USEC(tv) ((tv)->tv_sec * SPA_USEC_PER_SEC + (tv)->tv_usec) 197 #define SPA_PRINTF_FUNC(fmt, arg1) __attribute__((format(printf, fmt, arg1))) 198 #define SPA_ALIGNED(align) __attribute__((aligned(align))) 199 #define SPA_DEPRECATED __attribute__ ((deprecated)) 200 #define SPA_EXPORT __attribute__((visibility("default"))) 201 #define SPA_SENTINEL __attribute__((__sentinel__)) 202 #define SPA_UNUSED __attribute__ ((unused)) 203 #define SPA_NORETURN __attribute__ ((noreturn)) 205 #define SPA_PRINTF_FUNC(fmt, arg1) 206 #define SPA_ALIGNED(align) 207 #define SPA_DEPRECATED 214 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L 215 #define SPA_RESTRICT restrict 216 #elif defined(__GNUC__) && __GNUC__ >= 4 217 #define SPA_RESTRICT __restrict__ 222 #define SPA_ROUND_DOWN_N(num,align) ((num) & ~((align) - 1)) 223 #define SPA_ROUND_UP_N(num,align) SPA_ROUND_DOWN_N((num) + ((align) - 1),align) 225 #define SPA_PTR_ALIGNMENT(p,align) ((intptr_t)(p) & ((align)-1)) 226 #define SPA_IS_ALIGNED(p,align) (SPA_PTR_ALIGNMENT(p,align) == 0) 227 #define SPA_PTR_ALIGN(p,align,type) (type*)SPA_ROUND_UP_N((intptr_t)(p), (intptr_t)(align)) 231 #define SPA_LIKELY(x) (__builtin_expect(!!(x),1)) 232 #define SPA_UNLIKELY(x) (__builtin_expect(!!(x),0)) 234 #define SPA_LIKELY(x) (x) 235 #define SPA_UNLIKELY(x) (x) 239 #define SPA_STRINGIFY_1(...) #__VA_ARGS__ 240 #define SPA_STRINGIFY(...) SPA_STRINGIFY_1(__VA_ARGS__) 242 #define spa_return_if_fail(expr) \ 244 if (SPA_UNLIKELY(!(expr))) { \ 245 fprintf(stderr, "'%s' failed at %s:%u %s()\n", \ 246 #expr , __FILE__, __LINE__, __func__); \ 251 #define spa_return_val_if_fail(expr, val) \ 253 if (SPA_UNLIKELY(!(expr))) { \ 254 fprintf(stderr, "'%s' failed at %s:%u %s()\n", \ 255 #expr , __FILE__, __LINE__, __func__); \ 263 #define spa_assert_se(expr) \ 265 if (SPA_UNLIKELY(!(expr))) { \ 266 fprintf(stderr, "'%s' failed at %s:%u %s()\n", \ 267 #expr , __FILE__, __LINE__, __func__); \ 272 #define spa_assert_se(expr) \ 274 int _unique_var = (expr); \ 281 #define spa_nop() do {} while (false) 284 #define spa_assert(expr) spa_nop() 285 #elif defined (FASTPATH) 286 #define spa_assert(expr) spa_assert_se(expr) 288 #define spa_assert(expr) spa_assert_se(expr) 292 #define spa_assert_not_reached() abort() 294 #define spa_assert_not_reached() \ 296 fprintf(stderr, "Code should not be reached at %s:%u %s()\n", \ 297 __FILE__, __LINE__, __func__); \ 302 #define spa_memzero(x,l) (memset((x), 0, (l))) 303 #define spa_zero(x) (spa_memzero(&(x), sizeof(x))) 305 #ifdef SPA_DEBUG_MEMCPY 306 #define spa_memcpy(d,s,n) \ 308 fprintf(stderr, "%s:%u %s() memcpy(%p, %p, %zd)\n", \ 309 __FILE__, __LINE__, __func__, (d), (s), (size_t)(n)); \ 312 #define spa_memmove(d,s,n) \ 314 fprintf(stderr, "%s:%u %s() memmove(%p, %p, %zd)\n", \ 315 __FILE__, __LINE__, __func__, (d), (s), (size_t)(n)); \ 319 #define spa_memcpy(d,s,n) memcpy(d,s,n) 320 #define spa_memmove(d,s,n) memmove(d,s,n) 323 #define spa_aprintf(_fmt, ...) \ 326 if (asprintf(&(_strp), (_fmt), ## __VA_ARGS__ ) == -1) \ int32_t x
Definition: defs.h:93
uint32_t num
Definition: defs.h:105
uint32_t denom
Definition: defs.h:106
spa_direction
Definition: defs.h:78
uint32_t height
Definition: defs.h:88
uint32_t width
Definition: defs.h:87
int32_t y
Definition: defs.h:94