]>
code.delx.au - pulseaudio/blob - src/pulse/gccmacro.h
1 #ifndef foopulsegccmacrohfoo
2 #define foopulsegccmacrohfoo
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
26 * GCC attribute macros */
30 /* libintl overrides printf with a #define. As this breaks this attribute,
31 * it has a workaround. However the workaround isn't enabled for MINGW
32 * builds (only cygwin) */
33 #define PA_GCC_PRINTF_ATTR(a,b) __attribute__ ((format (__printf__, a, b)))
35 #define PA_GCC_PRINTF_ATTR(a,b) __attribute__ ((format (printf, a, b)))
38 /** If we're in GNU C, use some magic for detecting invalid format strings */
39 #define PA_GCC_PRINTF_ATTR(a,b)
42 #if defined(__GNUC__) && (__GNUC__ >= 4)
43 #define PA_GCC_SENTINEL __attribute__ ((sentinel))
45 /** Macro for usage of GCC's sentinel compilation warnings */
46 #define PA_GCC_SENTINEL
50 #define PA_GCC_NORETURN __attribute__((noreturn))
52 /** Macro for no-return functions */
53 #define PA_GCC_NORETURN
57 #define PA_GCC_UNUSED __attribute__ ((unused))
59 /** Macro for not used function, variable or parameter */
64 #define PA_GCC_DESTRUCTOR __attribute__ ((destructor))
66 /** Call this function when process terminates */
67 #define PA_GCC_DESTRUCTOR
72 #define PA_GCC_PURE __attribute__ ((pure))
74 /** This function's return value depends only the arguments list and global state **/
81 #define PA_GCC_CONST __attribute__ ((const))
83 /** This function's return value depends only the arguments list (stricter version of PA_GCC_PURE) **/
88 #ifndef PA_GCC_DEPRECATED
90 #define PA_GCC_DEPRECATED __attribute__ ((deprecated))
92 /** This function is deprecated **/
93 #define PA_GCC_DEPRECATED
99 #define PA_GCC_PACKED __attribute__ ((packed))
101 /** Structure shall be packed in memory **/
102 #define PA_GCC_PACKED
106 #ifndef PA_GCC_ALLOC_SIZE
107 #if defined(__GNUC__) && (__GNUC__ >= 4) && (__GNUC_MINOR__ >= 3)
108 #define PA_GCC_ALLOC_SIZE(x) __attribute__ ((__alloc_size__(x)))
109 #define PA_GCC_ALLOC_SIZE2(x,y) __attribute__ ((__alloc_size__(x,y)))
111 /** Macro for usage of GCC's alloc_size attribute */
112 #define PA_GCC_ALLOC_SIZE(x)
113 /** Macro for usage of GCC's alloc_size attribute */
114 #define PA_GCC_ALLOC_SIZE2(x,y)
118 #ifndef PA_GCC_MALLOC
120 #define PA_GCC_MALLOC __attribute__ ((malloc))
122 /** Macro for usage of GCC's malloc attribute */
123 #define PA_GCC_MALLOC
127 #ifndef PA_GCC_WEAKREF
128 #if defined(__GNUC__) && defined(__ELF__) && (((__GNUC__ == 4) && (__GNUC_MINOR__ > 1)) || (__GNUC__ > 4))
129 /** Macro for usage of GCC's weakref attribute */
130 #define PA_GCC_WEAKREF(x) __attribute__((weakref(#x)))