]> git.saurik.com Git - apt.git/blame - apt-pkg/contrib/macros.h
fix test/integration/test-apt-helper
[apt.git] / apt-pkg / contrib / macros.h
CommitLineData
578bfd0a
AL
1// -*- mode: cpp; mode: fold -*-
2// Description /*{{{*/
578bfd0a
AL
3/* ######################################################################
4
5c0d3668 5 Macros Header - Various useful macro definitions
578bfd0a
AL
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
5c0d3668
DK
13#ifndef MACROS_H
14#define MACROS_H
578bfd0a
AL
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
1ae93c94 21#if !defined(MIN)
578bfd0a
AL
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
1ae93c94 39#endif
578bfd0a
AL
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
1e3f4083 47/* Useful count macro, use on an array of things and it will return the
578bfd0a
AL
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
54298f49
DK
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
7d15572b
DK
66 #define likely(x) __builtin_expect (!!(x), 1)
67 #define unlikely(x) __builtin_expect (!!(x), 0)
3d43e539 68#else
7d15572b
DK
69 #define likely(x) (x)
70 #define unlikely(x) (x)
3d43e539
DK
71#endif
72
54298f49 73#if APT_GCC_VERSION >= 0x0300
453b82a3 74 #define APT_DEPRECATED __attribute__ ((deprecated))
54298f49
DK
75 #define APT_CONST __attribute__((const))
76 #define APT_PURE __attribute__((pure))
77 #define APT_NORETURN __attribute__((noreturn))
78 #define APT_PRINTF(n) __attribute__((format(printf, n, n + 1)))
79#else
453b82a3 80 #define APT_DEPRECATED
54298f49
DK
81 #define APT_CONST
82 #define APT_PURE
83 #define APT_NORETURN
84 #define APT_PRINTF(n)
85#endif
86
87#if APT_GCC_VERSION > 0x0302
88 #define APT_NONNULL(...) __attribute__((nonnull(__VA_ARGS__)))
89 #define APT_MUSTCHECK __attribute__((warn_unused_result))
90#else
91 #define APT_NONNULL(...)
92 #define APT_REQRET
93#endif
94
95#if APT_GCC_VERSION >= 0x0400
96 #define APT_SENTINEL __attribute__((sentinel))
97#else
98 #define APT_SENTINEL
99#endif
100
3d43e539 101// cold functions are unlikely() to be called
54298f49
DK
102#if APT_GCC_VERSION >= 0x0403
103 #define APT_COLD __attribute__ ((__cold__))
104 #define APT_HOT __attribute__ ((__hot__))
3d43e539 105#else
453b82a3
DK
106 #define APT_COLD
107 #define APT_HOT
3d43e539
DK
108#endif
109
54298f49
DK
110#ifndef APT_10_CLEANER_HEADERS
111#if APT_GCC_VERSION >= 0x0300
112 #define __must_check __attribute__ ((warn_unused_result))
113 #define __deprecated __attribute__ ((deprecated))
114 #define __attrib_const __attribute__ ((__const__))
6dc60370 115 #define __like_printf(n) __attribute__((format(printf, n, n + 1)))
8f3d83ee 116#else
54298f49
DK
117 #define __must_check /* no warn_unused_result */
118 #define __deprecated /* no deprecated */
119 #define __attrib_const /* no const attribute */
6dc60370 120 #define __like_printf(n) /* no like-printf */
8f3d83ee 121#endif
54298f49
DK
122#if APT_GCC_VERSION >= 0x0403
123 #define __cold __attribute__ ((__cold__))
124 #define __hot __attribute__ ((__hot__))
125#else
126 #define __cold /* no cold marker */
127 #define __hot /* no hot marker */
128#endif
129#endif
130
131// These lines are extracted by the makefiles and the buildsystem
132// Increasing MAJOR or MINOR results in the need of recompiling all
133// reverse-dependencies of libapt-pkg against the new SONAME.
134// Non-ABI-Breaks should only increase RELEASE number.
135// See also buildlib/libversion.mak
136#define APT_PKG_MAJOR 4
137#define APT_PKG_MINOR 12
138#define APT_PKG_RELEASE 0
8f3d83ee 139
578bfd0a 140#endif