]>
code.delx.au - pulseaudio/blob - src/pulsecore/macro.h
1 #ifndef foopulsemacrohfoo
2 #define foopulsemacrohfoo
5 This file is part of PulseAudio.
7 Copyright 2004-2006 Lennart Poettering
9 PulseAudio is free software; you can redistribute it and/or modify
10 it under the terms of the GNU Lesser General Public License as published
11 by the Free Software Foundation; either version 2.1 of the License,
12 or (at your option) any later version.
14 PulseAudio is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public License
20 along with PulseAudio; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
25 #include <sys/types.h>
36 #error "Please include config.h before including this file!"
41 #define PA_LIKELY(x) (__builtin_expect(!!(x),1))
42 #define PA_UNLIKELY(x) (__builtin_expect(!!(x),0))
44 #define PA_LIKELY(x) (x)
45 #define PA_UNLIKELY(x) (x)
49 #if defined(PAGE_SIZE)
50 #define PA_PAGE_SIZE ((size_t) PAGE_SIZE)
51 #elif defined(PAGESIZE)
52 #define PA_PAGE_SIZE ((size_t) PAGESIZE)
53 #elif defined(HAVE_SYSCONF)
54 #define PA_PAGE_SIZE ((size_t) (sysconf(_SC_PAGE_SIZE)))
56 /* Let's hope it's like x86. */
57 #define PA_PAGE_SIZE ((size_t) 4096)
61 static inline void* PA_ALIGN_PTR(const void *p
) {
62 return (void*) (((size_t) p
) & ~(sizeof(void*) - 1));
66 static inline size_t PA_ALIGN(size_t l
) {
67 return ((l
+ sizeof(void*) - 1) & ~(sizeof(void*) - 1));
71 static inline void* PA_PAGE_ALIGN_PTR(const void *p
) {
72 return (void*) (((size_t) p
) & ~(PA_PAGE_SIZE
- 1));
76 static inline size_t PA_PAGE_ALIGN(size_t l
) {
77 return (l
+ PA_PAGE_SIZE
- 1) & ~(PA_PAGE_SIZE
- 1);
80 #define PA_ELEMENTSOF(x) (sizeof(x)/sizeof((x)[0]))
83 #define PA_DECLARE_ALIGNED(n,t,v) t v __attribute__ ((aligned (n)))
85 #define PA_DECLARE_ALIGNED(n,t,v) t v
89 #define typeof __typeof__
92 /* The users of PA_MIN and PA_MAX, PA_CLAMP, PA_ROUND_UP should be
93 * aware that these macros on non-GCC executed code with side effects
94 * twice. It is thus considered misuse to use code with side effects
95 * as arguments to MIN and MAX. */
100 typeof(a) _a = (a); \
101 typeof(b) _b = (b); \
105 #define PA_MAX(a, b) ((a) > (b) ? (a) : (b))
109 #define PA_MIN(a,b) \
111 typeof(a) _a = (a); \
112 typeof(b) _b = (b); \
116 #define PA_MIN(a, b) ((a) < (b) ? (a) : (b))
120 #define PA_CLAMP(x, low, high) \
122 typeof(x) _x = (x); \
123 typeof(low) _low = (low); \
124 typeof(high) _high = (high); \
125 ((_x > _high) ? _high : ((_x < _low) ? _low : _x)); \
128 #define PA_CLAMP(x, low, high) (((x) > (high)) ? (high) : (((x) < (low)) ? (low) : (x)))
132 #define PA_CLAMP_UNLIKELY(x, low, high) \
134 typeof(x) _x = (x); \
135 typeof(low) _low = (low); \
136 typeof(high) _high = (high); \
137 (PA_UNLIKELY(_x > _high) ? _high : (PA_UNLIKELY(_x < _low) ? _low : _x)); \
140 #define PA_CLAMP_UNLIKELY(x, low, high) (PA_UNLIKELY((x) > (high)) ? (high) : (PA_UNLIKELY((x) < (low)) ? (low) : (x)))
143 /* We don't define a PA_CLAMP_LIKELY here, because it doesn't really
144 * make sense: we cannot know if it is more likely that the values is
145 * lower or greater than the boundaries.*/
148 #define PA_ROUND_UP(a, b) \
150 typeof(a) _a = (a); \
151 typeof(b) _b = (b); \
152 ((_a + _b - 1) / _b) * _b; \
155 #define PA_ROUND_UP(a, b) ((((a) + (b) - 1) / (b)) * (b))
159 #define PA_ROUND_DOWN(a, b) \
161 typeof(a) _a = (a); \
162 typeof(b) _b = (b); \
166 #define PA_ROUND_DOWN(a, b) (((a) / (b)) * (b))
170 #define PA_CLIP_SUB(a, b) \
172 typeof(a) _a = (a); \
173 typeof(b) _b = (b); \
174 _a > _b ? _a - _b : 0; \
177 #define PA_CLIP_SUB(a, b) ((a) > (b) ? (a) - (b) : 0)
181 #define PA_PRETTY_FUNCTION __PRETTY_FUNCTION__
183 #define PA_PRETTY_FUNCTION ""
186 #define pa_return_if_fail(expr) \
188 if (PA_UNLIKELY(!(expr))) { \
189 pa_log_debug("Assertion '%s' failed at %s:%u, function %s.\n", #expr , __FILE__, __LINE__, PA_PRETTY_FUNCTION); \
194 #define pa_return_val_if_fail(expr, val) \
196 if (PA_UNLIKELY(!(expr))) { \
197 pa_log_debug("Assertion '%s' failed at %s:%u, function %s.\n", #expr , __FILE__, __LINE__, PA_PRETTY_FUNCTION); \
202 #define pa_return_null_if_fail(expr) pa_return_val_if_fail(expr, NULL)
204 /* pa_assert_se() is an assert which guarantees side effects of x,
205 * i.e. is never optimized away, regardless of NDEBUG or FASTPATH. */
206 #define pa_assert_se(expr) \
208 if (PA_UNLIKELY(!(expr))) { \
209 pa_log_error("Assertion '%s' failed at %s:%u, function %s(). Aborting.", #expr , __FILE__, __LINE__, PA_PRETTY_FUNCTION); \
214 /* Does exactly nothing */
215 #define pa_nop() do {} while (false)
217 /* pa_assert() is an assert that may be optimized away by defining
218 * NDEBUG. pa_assert_fp() is an assert that may be optimized away by
219 * defining FASTPATH. It is supposed to be used in inner loops. It's
220 * there for extra paranoia checking and should probably be removed in
221 * production builds. */
223 #define pa_assert(expr) pa_nop()
224 #define pa_assert_fp(expr) pa_nop()
225 #elif defined (FASTPATH)
226 #define pa_assert(expr) pa_assert_se(expr)
227 #define pa_assert_fp(expr) pa_nop()
229 #define pa_assert(expr) pa_assert_se(expr)
230 #define pa_assert_fp(expr) pa_assert_se(expr)
234 #define pa_assert_not_reached() pa_nop()
236 #define pa_assert_not_reached() \
238 pa_log_error("Code should not be reached at %s:%u, function %s(). Aborting.", __FILE__, __LINE__, PA_PRETTY_FUNCTION); \
243 /* A compile time assertion */
244 #define pa_assert_cc(expr) \
253 #define PA_PTR_TO_UINT(p) ((unsigned int) ((uintptr_t) (p)))
254 #define PA_UINT_TO_PTR(u) ((void*) ((uintptr_t) (u)))
256 #define PA_PTR_TO_UINT32(p) ((uint32_t) ((uintptr_t) (p)))
257 #define PA_UINT32_TO_PTR(u) ((void*) ((uintptr_t) (u)))
259 #define PA_PTR_TO_INT(p) ((int) ((intptr_t) (p)))
260 #define PA_INT_TO_PTR(u) ((void*) ((intptr_t) (u)))
262 #define PA_PTR_TO_INT32(p) ((int32_t) ((intptr_t) (p)))
263 #define PA_INT32_TO_PTR(u) ((void*) ((intptr_t) (u)))
266 #define PA_PATH_SEP "\\"
267 #define PA_PATH_SEP_CHAR '\\'
269 #define PA_PATH_SEP "/"
270 #define PA_PATH_SEP_CHAR '/'
273 #if defined(__GNUC__) && defined(__ELF__)
275 #define PA_WARN_REFERENCE(sym, msg) \
276 __asm__(".section .gnu.warning." #sym); \
277 __asm__(".asciz \"" msg "\""); \
282 #define PA_WARN_REFERENCE(sym, msg)
286 #if defined(__i386__) || defined(__x86_64__)
287 #define PA_DEBUG_TRAP __asm__("int $3")
289 #define PA_DEBUG_TRAP raise(SIGTRAP)
292 #define pa_memzero(x,l) (memset((x), 0, (l)))
293 #define pa_zero(x) (pa_memzero(&(x), sizeof(x)))
295 #define PA_INT_TYPE_SIGNED(type) (!!((type) 0 > (type) -1))
297 #define PA_INT_TYPE_MAX(type) \
298 ((type) (PA_INT_TYPE_SIGNED(type) \
299 ? ~(~(type) 0 << (8*sizeof(type)-1)) \
302 #define PA_INT_TYPE_MIN(type) \
303 ((type) (PA_INT_TYPE_SIGNED(type) \
304 ? (~(type) 0 << (8*sizeof(type)-1)) \
307 /* We include this at the very last place */
308 #include <pulsecore/log.h>