Allow the use of ad-hoc locations for fix-it hints
[official-gcc.git] / gcc / hwint.h
blob6b4d53737a2db3271196906d536269020f21c335
1 /* HOST_WIDE_INT definitions for the GNU compiler.
2 Copyright (C) 1998-2016 Free Software Foundation, Inc.
4 This file is part of GCC.
6 Provide definitions for macros which depend on HOST_BITS_PER_INT
7 and HOST_BITS_PER_LONG. */
9 #ifndef GCC_HWINT_H
10 #define GCC_HWINT_H
12 /* This describes the machine the compiler is hosted on. */
13 #define HOST_BITS_PER_CHAR CHAR_BIT
14 #define HOST_BITS_PER_SHORT (CHAR_BIT * SIZEOF_SHORT)
15 #define HOST_BITS_PER_INT (CHAR_BIT * SIZEOF_INT)
16 #define HOST_BITS_PER_LONG (CHAR_BIT * SIZEOF_LONG)
18 /* The string that should be inserted into a printf style format to
19 indicate a "long" operand. */
20 #ifndef HOST_LONG_FORMAT
21 #define HOST_LONG_FORMAT "l"
22 #endif
24 /* The string that should be inserted into a printf style format to
25 indicate a "long long" operand. */
26 #ifndef HOST_LONG_LONG_FORMAT
27 #define HOST_LONG_LONG_FORMAT "ll"
28 #endif
30 /* If HAVE_LONG_LONG and SIZEOF_LONG_LONG aren't defined, but
31 GCC_VERSION >= 3000, assume this is the second or later stage of a
32 bootstrap, we do have long long, and it's 64 bits. (This is
33 required by C99; we do have some ports that violate that assumption
34 but they're all cross-compile-only.) Just in case, force a
35 constraint violation if that assumption is incorrect. */
36 #if !defined HAVE_LONG_LONG
37 # if GCC_VERSION >= 3000
38 # define HAVE_LONG_LONG 1
39 # define SIZEOF_LONG_LONG 8
40 extern char sizeof_long_long_must_be_8[sizeof (long long) == 8 ? 1 : -1];
41 # endif
42 #endif
44 #ifdef HAVE_LONG_LONG
45 # define HOST_BITS_PER_LONGLONG (CHAR_BIT * SIZEOF_LONG_LONG)
46 #endif
48 /* Set HOST_WIDE_INT, this should be always 64 bits.
49 The underlying type is matched to that of int64_t and assumed
50 to be either long or long long. */
52 #define HOST_BITS_PER_WIDE_INT 64
53 #if INT64_T_IS_LONG
54 # define HOST_WIDE_INT long
55 # define HOST_WIDE_INT_C(X) X ## L
56 #else
57 # if HOST_BITS_PER_LONGLONG == 64
58 # define HOST_WIDE_INT long long
59 # define HOST_WIDE_INT_C(X) X ## LL
60 # else
61 #error "Unable to find a suitable type for HOST_WIDE_INT"
62 # endif
63 #endif
65 #define HOST_WIDE_INT_UC(X) HOST_WIDE_INT_C (X ## U)
66 #define HOST_WIDE_INT_0 HOST_WIDE_INT_C (0)
67 #define HOST_WIDE_INT_0U HOST_WIDE_INT_UC (0)
68 #define HOST_WIDE_INT_1 HOST_WIDE_INT_C (1)
69 #define HOST_WIDE_INT_1U HOST_WIDE_INT_UC (1)
70 #define HOST_WIDE_INT_M1 HOST_WIDE_INT_C (-1)
71 #define HOST_WIDE_INT_M1U HOST_WIDE_INT_UC (-1)
73 /* This is a magic identifier which allows GCC to figure out the type
74 of HOST_WIDE_INT for %wd specifier checks. You must issue this
75 typedef before using the __asm_fprintf__ format attribute. */
76 typedef HOST_WIDE_INT __gcc_host_wide_int__;
78 /* Provide C99 <inttypes.h> style format definitions for 64bits. */
79 #ifndef HAVE_INTTYPES_H
80 #if INT64_T_IS_LONG
81 # define GCC_PRI64 HOST_LONG_FORMAT
82 #else
83 # define GCC_PRI64 HOST_LONG_LONG_FORMAT
84 #endif
85 #undef PRId64
86 #define PRId64 GCC_PRI64 "d"
87 #undef PRIi64
88 #define PRIi64 GCC_PRI64 "i"
89 #undef PRIo64
90 #define PRIo64 GCC_PRI64 "o"
91 #undef PRIu64
92 #define PRIu64 GCC_PRI64 "u"
93 #undef PRIx64
94 #define PRIx64 GCC_PRI64 "x"
95 #undef PRIX64
96 #define PRIX64 GCC_PRI64 "X"
97 #endif
99 /* Various printf format strings for HOST_WIDE_INT. */
101 #if INT64_T_IS_LONG
102 # define HOST_WIDE_INT_PRINT HOST_LONG_FORMAT
103 # define HOST_WIDE_INT_PRINT_C "L"
104 #else
105 # define HOST_WIDE_INT_PRINT HOST_LONG_LONG_FORMAT
106 # define HOST_WIDE_INT_PRINT_C "LL"
107 #endif
109 #define HOST_WIDE_INT_PRINT_DEC "%" PRId64
110 #define HOST_WIDE_INT_PRINT_DEC_C "%" PRId64 HOST_WIDE_INT_PRINT_C
111 #define HOST_WIDE_INT_PRINT_UNSIGNED "%" PRIu64
112 #define HOST_WIDE_INT_PRINT_HEX "%#" PRIx64
113 #define HOST_WIDE_INT_PRINT_HEX_PURE "%" PRIx64
114 #define HOST_WIDE_INT_PRINT_DOUBLE_HEX "0x%" PRIx64 "%016" PRIx64
115 #define HOST_WIDE_INT_PRINT_PADDED_HEX "%016" PRIx64
117 /* Define HOST_WIDEST_FAST_INT to the widest integer type supported
118 efficiently in hardware. (That is, the widest integer type that fits
119 in a hardware register.) Normally this is "long" but on some hosts it
120 should be "long long" or "__int64". This is no convenient way to
121 autodetect this, so such systems must set a flag in config.host; see there
122 for details. */
124 #ifdef USE_LONG_LONG_FOR_WIDEST_FAST_INT
125 # ifdef HAVE_LONG_LONG
126 # define HOST_WIDEST_FAST_INT long long
127 # define HOST_BITS_PER_WIDEST_FAST_INT HOST_BITS_PER_LONGLONG
128 # else
129 # error "Your host said it wanted to use long long but that does not exist"
130 # endif
131 #else
132 # define HOST_WIDEST_FAST_INT long
133 # define HOST_BITS_PER_WIDEST_FAST_INT HOST_BITS_PER_LONG
134 #endif
136 /* Inline functions operating on HOST_WIDE_INT. */
137 #if GCC_VERSION < 3004
139 extern int clz_hwi (unsigned HOST_WIDE_INT x);
140 extern int ctz_hwi (unsigned HOST_WIDE_INT x);
141 extern int ffs_hwi (unsigned HOST_WIDE_INT x);
143 /* Return the number of set bits in X. */
144 extern int popcount_hwi (unsigned HOST_WIDE_INT x);
146 /* Return log2, or -1 if not exact. */
147 extern int exact_log2 (unsigned HOST_WIDE_INT);
149 /* Return floor of log2, with -1 for zero. */
150 extern int floor_log2 (unsigned HOST_WIDE_INT);
152 /* Return the smallest n such that 2**n >= X. */
153 extern int ceil_log2 (unsigned HOST_WIDE_INT);
155 #else /* GCC_VERSION >= 3004 */
157 /* For convenience, define 0 -> word_size. */
158 static inline int
159 clz_hwi (unsigned HOST_WIDE_INT x)
161 if (x == 0)
162 return HOST_BITS_PER_WIDE_INT;
163 # if HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONG
164 return __builtin_clzl (x);
165 # elif HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONGLONG
166 return __builtin_clzll (x);
167 # else
168 return __builtin_clz (x);
169 # endif
172 static inline int
173 ctz_hwi (unsigned HOST_WIDE_INT x)
175 if (x == 0)
176 return HOST_BITS_PER_WIDE_INT;
177 # if HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONG
178 return __builtin_ctzl (x);
179 # elif HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONGLONG
180 return __builtin_ctzll (x);
181 # else
182 return __builtin_ctz (x);
183 # endif
186 static inline int
187 ffs_hwi (unsigned HOST_WIDE_INT x)
189 # if HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONG
190 return __builtin_ffsl (x);
191 # elif HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONGLONG
192 return __builtin_ffsll (x);
193 # else
194 return __builtin_ffs (x);
195 # endif
198 static inline int
199 popcount_hwi (unsigned HOST_WIDE_INT x)
201 # if HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONG
202 return __builtin_popcountl (x);
203 # elif HOST_BITS_PER_WIDE_INT == HOST_BITS_PER_LONGLONG
204 return __builtin_popcountll (x);
205 # else
206 return __builtin_popcount (x);
207 # endif
210 static inline int
211 floor_log2 (unsigned HOST_WIDE_INT x)
213 return HOST_BITS_PER_WIDE_INT - 1 - clz_hwi (x);
216 static inline int
217 ceil_log2 (unsigned HOST_WIDE_INT x)
219 return floor_log2 (x - 1) + 1;
222 static inline int
223 exact_log2 (unsigned HOST_WIDE_INT x)
225 return x == (x & -x) && x ? ctz_hwi (x) : -1;
228 #endif /* GCC_VERSION >= 3004 */
230 #define HOST_WIDE_INT_MIN (HOST_WIDE_INT) \
231 (HOST_WIDE_INT_1U << (HOST_BITS_PER_WIDE_INT - 1))
232 #define HOST_WIDE_INT_MAX (~(HOST_WIDE_INT_MIN))
234 extern HOST_WIDE_INT abs_hwi (HOST_WIDE_INT);
235 extern unsigned HOST_WIDE_INT absu_hwi (HOST_WIDE_INT);
236 extern HOST_WIDE_INT gcd (HOST_WIDE_INT, HOST_WIDE_INT);
237 extern HOST_WIDE_INT pos_mul_hwi (HOST_WIDE_INT, HOST_WIDE_INT);
238 extern HOST_WIDE_INT mul_hwi (HOST_WIDE_INT, HOST_WIDE_INT);
239 extern HOST_WIDE_INT least_common_multiple (HOST_WIDE_INT, HOST_WIDE_INT);
241 /* Sign extend SRC starting from PREC. */
243 static inline HOST_WIDE_INT
244 sext_hwi (HOST_WIDE_INT src, unsigned int prec)
246 if (prec == HOST_BITS_PER_WIDE_INT)
247 return src;
248 else
249 #if defined (__GNUC__)
251 /* Take the faster path if the implementation-defined bits it's relying
252 on are implemented the way we expect them to be. Namely, conversion
253 from unsigned to signed preserves bit pattern, and right shift of
254 a signed value propagates the sign bit.
255 We have to convert from signed to unsigned and back, because when left
256 shifting signed values, any overflow is undefined behavior. */
257 gcc_checking_assert (prec < HOST_BITS_PER_WIDE_INT);
258 int shift = HOST_BITS_PER_WIDE_INT - prec;
259 return ((HOST_WIDE_INT) ((unsigned HOST_WIDE_INT) src << shift)) >> shift;
261 #else
263 /* Fall back to the slower, well defined path otherwise. */
264 gcc_checking_assert (prec < HOST_BITS_PER_WIDE_INT);
265 HOST_WIDE_INT sign_mask = HOST_WIDE_INT_1 << (prec - 1);
266 HOST_WIDE_INT value_mask = (HOST_WIDE_INT_1U << prec) - HOST_WIDE_INT_1U;
267 return (((src & value_mask) ^ sign_mask) - sign_mask);
269 #endif
272 /* Zero extend SRC starting from PREC. */
273 static inline unsigned HOST_WIDE_INT
274 zext_hwi (unsigned HOST_WIDE_INT src, unsigned int prec)
276 if (prec == HOST_BITS_PER_WIDE_INT)
277 return src;
278 else
280 gcc_checking_assert (prec < HOST_BITS_PER_WIDE_INT);
281 return src & ((HOST_WIDE_INT_1U << prec) - 1);
285 /* Compute the absolute value of X. */
287 inline HOST_WIDE_INT
288 abs_hwi (HOST_WIDE_INT x)
290 gcc_checking_assert (x != HOST_WIDE_INT_MIN);
291 return x >= 0 ? x : -x;
294 /* Compute the absolute value of X as an unsigned type. */
296 inline unsigned HOST_WIDE_INT
297 absu_hwi (HOST_WIDE_INT x)
299 return x >= 0 ? (unsigned HOST_WIDE_INT)x : -(unsigned HOST_WIDE_INT)x;
302 #endif /* ! GCC_HWINT_H */