]>
Commit | Line | Data |
---|---|---|
1 | // -*- mode: cpp; mode: fold -*- | |
2 | // Description /*{{{*/ | |
3 | /* ###################################################################### | |
4 | ||
5 | Macros Header - Various useful macro definitions | |
6 | ||
7 | This source is placed in the Public Domain, do with it what you will | |
8 | It was originally written by Brian C. White. | |
9 | ||
10 | ##################################################################### */ | |
11 | /*}}}*/ | |
12 | // Private header | |
13 | #ifndef MACROS_H | |
14 | #define MACROS_H | |
15 | ||
16 | // MIN_VAL(SINT16) will return -0x8000 and MAX_VAL(SINT16) = 0x7FFF | |
17 | #define MIN_VAL(t) (((t)(-1) > 0) ? (t)( 0) : (t)(((1L<<(sizeof(t)*8-1)) ))) | |
18 | #define MAX_VAL(t) (((t)(-1) > 0) ? (t)(-1) : (t)(((1L<<(sizeof(t)*8-1))-1))) | |
19 | ||
20 | // Min/Max functions | |
21 | #if !defined(MIN) | |
22 | #if defined(__HIGHC__) | |
23 | #define MIN(x,y) _min(x,y) | |
24 | #define MAX(x,y) _max(x,y) | |
25 | #endif | |
26 | ||
27 | // GNU C++ has a min/max operator <coolio> | |
28 | #if defined(__GNUG__) | |
29 | #define MIN(A,B) ((A) <? (B)) | |
30 | #define MAX(A,B) ((A) >? (B)) | |
31 | #endif | |
32 | ||
33 | /* Templates tend to mess up existing code that uses min/max because of the | |
34 | strict matching requirements */ | |
35 | #if !defined(MIN) | |
36 | #define MIN(A,B) ((A) < (B)?(A):(B)) | |
37 | #define MAX(A,B) ((A) > (B)?(A):(B)) | |
38 | #endif | |
39 | #endif | |
40 | ||
41 | /* Bound functions, bound will return the value b within the limits a-c | |
42 | bounv will change b so that it is within the limits of a-c. */ | |
43 | #define _bound(a,b,c) MIN(c,MAX(b,a)) | |
44 | #define _boundv(a,b,c) b = _bound(a,b,c) | |
45 | #define ABS(a) (((a) < (0)) ?-(a) : (a)) | |
46 | ||
47 | /* Useful count macro, use on an array of things and it will return the | |
48 | number of items in the array */ | |
49 | #define _count(a) (sizeof(a)/sizeof(a[0])) | |
50 | ||
51 | // Flag Macros | |
52 | #define FLAG(f) (1L << (f)) | |
53 | #define SETFLAG(v,f) ((v) |= FLAG(f)) | |
54 | #define CLRFLAG(v,f) ((v) &=~FLAG(f)) | |
55 | #define CHKFLAG(v,f) ((v) & FLAG(f) ? true : false) | |
56 | ||
57 | #ifdef __GNUC__ | |
58 | #define APT_GCC_VERSION (__GNUC__ << 8 | __GNUC_MINOR__) | |
59 | #else | |
60 | #define APT_GCC_VERSION 0 | |
61 | #endif | |
62 | ||
63 | /* likely() and unlikely() can be used to mark boolean expressions | |
64 | as (not) likely true which will help the compiler to optimise */ | |
65 | #if APT_GCC_VERSION >= 0x0300 | |
66 | #define likely(x) __builtin_expect (!!(x), 1) | |
67 | #define unlikely(x) __builtin_expect (!!(x), 0) | |
68 | #else | |
69 | #define likely(x) (x) | |
70 | #define unlikely(x) (x) | |
71 | #endif | |
72 | ||
73 | #if APT_GCC_VERSION >= 0x0300 | |
74 | #define APT_DEPRECATED __attribute__ ((deprecated)) | |
75 | #define APT_DEPRECATED_MSG(X) __attribute__ ((deprecated(X))) | |
76 | #define APT_CONST __attribute__((const)) | |
77 | #define APT_PURE __attribute__((pure)) | |
78 | #define APT_NORETURN __attribute__((noreturn)) | |
79 | #define APT_PRINTF(n) __attribute__((format(printf, n, n + 1))) | |
80 | #define APT_WEAK __attribute__((weak)); | |
81 | #else | |
82 | #define APT_DEPRECATED | |
83 | #define APT_DEPRECATED_MSG | |
84 | #define APT_CONST | |
85 | #define APT_PURE | |
86 | #define APT_NORETURN | |
87 | #define APT_PRINTF(n) | |
88 | #define APT_WEAK | |
89 | #endif | |
90 | ||
91 | #if APT_GCC_VERSION > 0x0302 | |
92 | #define APT_NONNULL(...) __attribute__((nonnull(__VA_ARGS__))) | |
93 | #define APT_MUSTCHECK __attribute__((warn_unused_result)) | |
94 | #else | |
95 | #define APT_NONNULL(...) | |
96 | #define APT_MUSTCHECK | |
97 | #endif | |
98 | ||
99 | #if APT_GCC_VERSION >= 0x0400 | |
100 | #define APT_SENTINEL __attribute__((sentinel)) | |
101 | #define APT_PUBLIC __attribute__ ((visibility ("default"))) | |
102 | #define APT_HIDDEN __attribute__ ((visibility ("hidden"))) | |
103 | #else | |
104 | #define APT_SENTINEL | |
105 | #define APT_PUBLIC | |
106 | #define APT_HIDDEN | |
107 | #endif | |
108 | ||
109 | // cold functions are unlikely() to be called | |
110 | #if APT_GCC_VERSION >= 0x0403 | |
111 | #define APT_COLD __attribute__ ((__cold__)) | |
112 | #define APT_HOT __attribute__ ((__hot__)) | |
113 | #else | |
114 | #define APT_COLD | |
115 | #define APT_HOT | |
116 | #endif | |
117 | ||
118 | #ifndef APT_10_CLEANER_HEADERS | |
119 | #if APT_GCC_VERSION >= 0x0300 | |
120 | #define __must_check __attribute__ ((warn_unused_result)) | |
121 | #define __deprecated __attribute__ ((deprecated)) | |
122 | #define __attrib_const __attribute__ ((__const__)) | |
123 | #define __like_printf(n) __attribute__((format(printf, n, n + 1))) | |
124 | #else | |
125 | #define __must_check /* no warn_unused_result */ | |
126 | #define __deprecated /* no deprecated */ | |
127 | #define __attrib_const /* no const attribute */ | |
128 | #define __like_printf(n) /* no like-printf */ | |
129 | #endif | |
130 | #if APT_GCC_VERSION >= 0x0403 | |
131 | #define __cold __attribute__ ((__cold__)) | |
132 | #define __hot __attribute__ ((__hot__)) | |
133 | #else | |
134 | #define __cold /* no cold marker */ | |
135 | #define __hot /* no hot marker */ | |
136 | #endif | |
137 | #endif | |
138 | ||
139 | #if __GNUC__ >= 4 | |
140 | #define APT_IGNORE_DEPRECATED_PUSH \ | |
141 | _Pragma("GCC diagnostic push") \ | |
142 | _Pragma("GCC diagnostic ignored \"-Wdeprecated-declarations\"") | |
143 | #define APT_IGNORE_DEPRECATED_POP \ | |
144 | _Pragma("GCC diagnostic pop") | |
145 | #define APT_IGNORE_DEPRECATED(XXX) \ | |
146 | APT_IGNORE_DEPRECATED_PUSH \ | |
147 | XXX \ | |
148 | APT_IGNORE_DEPRECATED_POP | |
149 | #else | |
150 | #define APT_IGNORE_DEPRECATED_PUSH | |
151 | #define APT_IGNORE_DEPRECATED_POP | |
152 | #define APT_IGNORE_DEPRECATED(XXX) XXX | |
153 | #endif | |
154 | ||
155 | #if __cplusplus >= 201103L | |
156 | #define APT_OVERRIDE override | |
157 | #else | |
158 | #define APT_OVERRIDE /* no c++11 standard */ | |
159 | #endif | |
160 | ||
161 | // These lines are extracted by the makefiles and the buildsystem | |
162 | // Increasing MAJOR or MINOR results in the need of recompiling all | |
163 | // reverse-dependencies of libapt-pkg against the new SONAME. | |
164 | // Non-ABI-Breaks should only increase RELEASE number. | |
165 | // See also buildlib/libversion.mak | |
166 | #define APT_PKG_MAJOR 5 | |
167 | #define APT_PKG_MINOR 0 | |
168 | #define APT_PKG_RELEASE 0 | |
169 | #define APT_PKG_ABI ((APT_PKG_MAJOR * 100) + APT_PKG_MINOR) | |
170 | ||
171 | #endif |