Include the specification header.
[gnulib.git] / lib / stdint_.h
1 /* Copyright (C) 2001-2002, 2004-2006 Free Software Foundation, Inc.
2    Written by Paul Eggert, Bruno Haible, Sam Steingold, Peter Burwood.
3    This file is part of gnulib.
4
5    This program is free software; you can redistribute it and/or modify
6    it under the terms of the GNU General Public License as published by
7    the Free Software Foundation; either version 2, or (at your option)
8    any later version.
9
10    This program is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13    GNU General Public License for more details.
14
15    You should have received a copy of the GNU General Public License
16    along with this program; if not, write to the Free Software Foundation,
17    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
18
19 #ifndef _GL_STDINT_H
20 #define _GL_STDINT_H
21
22 /*
23  * ISO C 99 <stdint.h> for platforms that lack it.
24  * <http://www.opengroup.org/susv3xbd/stdint.h.html>
25  */
26
27 /* Get those types that are already defined in other system include
28    files, so that we can "#define int8_t signed char" below without
29    worrying about a later system include file containing a "typedef
30    signed char int8_t;" that will get messed up by our macro.  Our
31    macros should all be consistent with the system versions, except
32    for the "fast" types and macros, which we recommend against using
33    in public interfaces due to compiler differences.  */
34
35 #if @HAVE_STDINT_H@
36 # if defined __sgi && ! defined __c99
37    /* Bypass IRIX's <stdint.h> if in C89 mode, since it merely annoys users
38       with "This header file is to be used only for c99 mode compilations"
39       diagnostics.  */
40 #  define __STDINT_H__
41 # endif
42   /* Other systems may have an incomplete or buggy <stdint.h>.
43      Include it before <inttypes.h>, since any "#include <stdint.h>"
44      in <inttypes.h> would reinclude us, skipping our contents because
45      _GL_STDINT_H is defined.  */
46 # include @ABSOLUTE_STDINT_H@
47 #endif
48
49 /* <sys/types.h> defines some of the stdint.h types as well, on glibc,
50    IRIX 6.5, and OpenBSD 3.8 (via <machine/types.h>).
51    MacOS X 10.4.6 <sys/types.h> includes <stdint.h> (which is us), but
52    relies on the system <stdint.h> definitions, so include
53    <sys/types.h> after @ABSOLUTE_STDINT_H@.  */
54 #if @HAVE_SYS_TYPES_H@
55 # include <sys/types.h>
56 #endif
57
58 /* Get LONG_MIN, LONG_MAX, ULONG_MAX.  */
59 #include <limits.h>
60
61 #if @HAVE_INTTYPES_H@
62   /* In OpenBSD 3.8, <inttypes.h> includes <machine/types.h>, which defines
63      int{8,16,32,64}_t, uint{8,16,32,64}_t and __BIT_TYPES_DEFINED__.
64      <inttypes.h> also defines intptr_t and uintptr_t.  */
65 # define _GL_JUST_INCLUDE_ABSOLUTE_INTTYPES_H
66 # include <inttypes.h>
67 # undef _GL_JUST_INCLUDE_ABSOLUTE_INTTYPES_H
68 #elif @HAVE_SYS_INTTYPES_H@
69   /* Solaris 7 <sys/inttypes.h> has the types except the *_fast*_t types, and
70      the macros except for *_FAST*_*, INTPTR_MIN, PTRDIFF_MIN, PTRDIFF_MAX.  */
71 # include <sys/inttypes.h>
72 #endif
73
74 #if @HAVE_SYS_BITYPES_H@ && ! defined __BIT_TYPES_DEFINED__
75   /* Linux libc4 >= 4.6.7 and libc5 have a <sys/bitypes.h> that defines
76      int{8,16,32,64}_t and __BIT_TYPES_DEFINED__.  In libc5 >= 5.2.2 it is
77      included by <sys/types.h>.  */
78 # include <sys/bitypes.h>
79 #endif
80
81 #if ! defined __cplusplus || defined __STDC_CONSTANT_MACROS
82
83 /* Get WCHAR_MIN, WCHAR_MAX.  */
84 # if @HAVE_WCHAR_H@ && ! (defined WCHAR_MIN && defined WCHAR_MAX)
85    /* BSD/OS 4.1 has a bug: <stdio.h> and <time.h> must be included before
86       <wchar.h>.  */
87 #  include <stdio.h>
88 #  include <time.h>
89 #  include <wchar.h>
90 # endif
91
92 #endif
93
94 /* Minimum and maximum values for a integer type under the usual assumption.
95    Return an unspecified value if BITS == 0, adding a check to pacify
96    picky compilers.  */
97
98 #define _STDINT_MIN(signed, bits, zero) \
99   ((signed) ? (- ((zero) + 1) << ((bits) ? (bits) - 1 : 0)) : (zero))
100
101 #define _STDINT_MAX(signed, bits, zero) \
102   ((signed) \
103    ? ~ _STDINT_MIN (signed, bits, zero) \
104    : ((((zero) + 1) << ((bits) ? (bits) - 1 : 0)) - 1) * 2 + 1)
105
106 /* 7.18.1.1. Exact-width integer types */
107
108 /* Here we assume a standard architecture where the hardware integer
109    types have 8, 16, 32, optionally 64 bits.  */
110
111 #undef int8_t
112 #undef uint8_t
113 #define int8_t signed char
114 #define uint8_t unsigned char
115
116 #undef int16_t
117 #undef uint16_t
118 #define int16_t short int
119 #define uint16_t unsigned short int
120
121 #undef int32_t
122 #undef uint32_t
123 #define int32_t int
124 #define uint32_t unsigned int
125
126 #undef int64_t
127 #if LONG_MAX >> 31 >> 31 == 1
128 # define int64_t long int
129 #elif defined _MSC_VER
130 # define int64_t __int64
131 #elif @HAVE_LONG_LONG_INT@
132 # define int64_t long long int
133 #endif
134
135 #undef uint64_t
136 #if ULONG_MAX >> 31 >> 31 >> 1 == 1
137 # define uint64_t unsigned long int
138 #elif defined _MSC_VER
139 # define uint64_t unsigned __int64
140 #elif @HAVE_UNSIGNED_LONG_LONG_INT@
141 # define uint64_t unsigned long long int
142 #endif
143
144 /* Avoid collision with Solaris 2.5.1 <pthread.h> etc.  */
145 #define _UINT8_T
146 #define _UINT32_T
147 #define _UINT64_T
148
149
150 /* 7.18.1.2. Minimum-width integer types */
151
152 /* Here we assume a standard architecture where the hardware integer
153    types have 8, 16, 32, optionally 64 bits. Therefore the leastN_t types
154    are the same as the corresponding N_t types.  */
155
156 #undef int_least8_t
157 #undef uint_least8_t
158 #undef int_least16_t
159 #undef uint_least16_t
160 #undef int_least32_t
161 #undef uint_least32_t
162 #undef int_least64_t
163 #undef uint_least64_t
164 #define int_least8_t int8_t
165 #define uint_least8_t uint8_t
166 #define int_least16_t int16_t
167 #define uint_least16_t uint16_t
168 #define int_least32_t int32_t
169 #define uint_least32_t uint32_t
170 #ifdef int64_t
171 # define int_least64_t int64_t
172 #endif
173 #ifdef uint64_t
174 # define uint_least64_t uint64_t
175 #endif
176
177 /* 7.18.1.3. Fastest minimum-width integer types */
178
179 /* Note: Other <stdint.h> substitutes may define these types differently.
180    It is not recommended to use these types in public header files. */
181
182 /* Here we assume a standard architecture where the hardware integer
183    types have 8, 16, 32, optionally 64 bits. Therefore the fastN_t types
184    are taken from the same list of types.  Assume that 'long int'
185    is fast enough for all narrower integers.  */
186
187 #undef int_fast8_t
188 #undef uint_fast8_t
189 #undef int_fast16_t
190 #undef uint_fast16_t
191 #undef int_fast32_t
192 #undef uint_fast32_t
193 #undef int_fast64_t
194 #undef uint_fast64_t
195 #define int_fast8_t long int
196 #define uint_fast8_t unsigned int_fast8_t
197 #define int_fast16_t long int
198 #define uint_fast16_t unsigned int_fast16_t
199 #define int_fast32_t long int
200 #define uint_fast32_t unsigned int_fast32_t
201 #ifdef int64_t
202 # define int_fast64_t int64_t
203 #endif
204 #ifdef uint64_t
205 # define uint_fast64_t uint64_t
206 #endif
207
208 /* 7.18.1.4. Integer types capable of holding object pointers */
209
210 #undef intptr_t
211 #undef uintptr_t
212 #define intptr_t long int
213 #define uintptr_t unsigned long int
214
215 /* 7.18.1.5. Greatest-width integer types */
216
217 /* Note: These types are compiler dependent. It may be unwise to use them in
218    public header files. */
219
220 #undef intmax_t
221 #if @HAVE_LONG_LONG_INT@ && LONG_MAX >> 30 == 1
222 # define intmax_t long long int
223 #elif defined int64_t
224 # define intmax_t int64_t
225 #else
226 # define intmax_t long int
227 #endif
228
229 #undef uintmax_t
230 #if @HAVE_UNSIGNED_LONG_LONG_INT@ && ULONG_MAX >> 31 == 1
231 # define uintmax_t unsigned long long int
232 #elif defined int64_t
233 # define uintmax_t uint64_t
234 #else
235 # define uintmax_t unsigned long int
236 #endif
237
238 /* 7.18.2. Limits of specified-width integer types */
239
240 #if ! defined __cplusplus || defined __STDC_LIMIT_MACROS
241
242 /* 7.18.2.1. Limits of exact-width integer types */
243
244 /* Here we assume a standard architecture where the hardware integer
245    types have 8, 16, 32, optionally 64 bits.  */
246
247 #undef INT8_MIN
248 #undef INT8_MAX
249 #undef UINT8_MAX
250 #define INT8_MIN  (~ INT8_MAX)
251 #define INT8_MAX  127
252 #define UINT8_MAX  255
253
254 #undef INT16_MIN
255 #undef INT16_MAX
256 #undef UINT16_MAX
257 #define INT16_MIN  (~ INT16_MAX)
258 #define INT16_MAX  32767
259 #define UINT16_MAX  65535
260
261 #undef INT32_MIN
262 #undef INT32_MAX
263 #undef UINT32_MAX
264 #define INT32_MIN  (~ INT32_MAX)
265 #define INT32_MAX  2147483647
266 #define UINT32_MAX  4294967295U
267
268 #undef INT64_MIN
269 #undef INT64_MAX
270 #ifdef int64_t
271 # define INT64_MIN  (~ INT64_MAX)
272 # define INT64_MAX  INTMAX_C (9223372036854775807)
273 #endif
274
275 #undef UINT64_MAX
276 #ifdef uint64_t
277 # define UINT64_MAX  UINTMAX_C (18446744073709551615)
278 #endif
279
280 /* 7.18.2.2. Limits of minimum-width integer types */
281
282 /* Here we assume a standard architecture where the hardware integer
283    types have 8, 16, 32, optionally 64 bits. Therefore the leastN_t types
284    are the same as the corresponding N_t types.  */
285
286 #undef INT_LEAST8_MIN
287 #undef INT_LEAST8_MAX
288 #undef UINT_LEAST8_MAX
289 #define INT_LEAST8_MIN  INT8_MIN
290 #define INT_LEAST8_MAX  INT8_MAX
291 #define UINT_LEAST8_MAX  UINT8_MAX
292
293 #undef INT_LEAST16_MIN
294 #undef INT_LEAST16_MAX
295 #undef UINT_LEAST16_MAX
296 #define INT_LEAST16_MIN  INT16_MIN
297 #define INT_LEAST16_MAX  INT16_MAX
298 #define UINT_LEAST16_MAX  UINT16_MAX
299
300 #undef INT_LEAST32_MIN
301 #undef INT_LEAST32_MAX
302 #undef UINT_LEAST32_MAX
303 #define INT_LEAST32_MIN  INT32_MIN
304 #define INT_LEAST32_MAX  INT32_MAX
305 #define UINT_LEAST32_MAX  UINT32_MAX
306
307 #undef INT_LEAST64_MIN
308 #undef INT_LEAST64_MAX
309 #ifdef int64_t
310 # define INT_LEAST64_MIN  INT64_MIN
311 # define INT_LEAST64_MAX  INT64_MAX
312 #endif
313
314 #undef UINT_LEAST64_MAX
315 #ifdef uint64_t
316 # define UINT_LEAST64_MAX  UINT64_MAX
317 #endif
318
319 /* 7.18.2.3. Limits of fastest minimum-width integer types */
320
321 /* Here we assume a standard architecture where the hardware integer
322    types have 8, 16, 32, optionally 64 bits. Therefore the fastN_t types
323    are taken from the same list of types.  */
324
325 #undef INT_FAST8_MIN
326 #undef INT_FAST8_MAX
327 #undef UINT_FAST8_MAX
328 #define INT_FAST8_MIN  LONG_MIN
329 #define INT_FAST8_MAX  LONG_MAX
330 #define UINT_FAST8_MAX  ULONG_MAX
331
332 #undef INT_FAST16_MIN
333 #undef INT_FAST16_MAX
334 #undef UINT_FAST16_MAX
335 #define INT_FAST16_MIN  LONG_MIN
336 #define INT_FAST16_MAX  LONG_MAX
337 #define UINT_FAST16_MAX  ULONG_MAX
338
339 #undef INT_FAST32_MIN
340 #undef INT_FAST32_MAX
341 #undef UINT_FAST32_MAX
342 #define INT_FAST32_MIN  LONG_MIN
343 #define INT_FAST32_MAX  LONG_MAX
344 #define UINT_FAST32_MAX  ULONG_MAX
345
346 #undef INT_FAST64_MIN
347 #undef INT_FAST64_MAX
348 #ifdef int64_t
349 # define INT_FAST64_MIN  INT64_MIN
350 # define INT_FAST64_MAX  INT64_MAX
351 #endif
352
353 #undef UINT_FAST64_MAX
354 #ifdef uint64_t
355 # define UINT_FAST64_MAX  UINT64_MAX
356 #endif
357
358 /* 7.18.2.4. Limits of integer types capable of holding object pointers */
359
360 #undef INTPTR_MIN
361 #undef INTPTR_MAX
362 #undef UINTPTR_MAX
363 #define INTPTR_MIN  LONG_MIN
364 #define INTPTR_MAX  LONG_MAX
365 #define UINTPTR_MAX  ULONG_MAX
366
367 /* 7.18.2.5. Limits of greatest-width integer types */
368
369 #undef INTMAX_MIN
370 #undef INTMAX_MAX
371 #define INTMAX_MIN  (~ INTMAX_MAX)
372 #ifdef INT64_MAX
373 # define INTMAX_MAX  INT64_MAX
374 #else
375 # define INTMAX_MAX  INT32_MAX
376 #endif
377
378 #undef UINTMAX_MAX
379 #ifdef UINT64_MAX
380 # define UINTMAX_MAX  UINT64_MAX
381 #else
382 # define UINTMAX_MAX  UINT32_MAX
383 #endif
384
385 /* 7.18.3. Limits of other integer types */
386
387 /* ptrdiff_t limits */
388 #undef PTRDIFF_MIN
389 #undef PTRDIFF_MAX
390 #define PTRDIFF_MIN  \
391    _STDINT_MIN (1, @BITSIZEOF_PTRDIFF_T@, 0@PTRDIFF_T_SUFFIX@)
392 #define PTRDIFF_MAX  \
393    _STDINT_MAX (1, @BITSIZEOF_PTRDIFF_T@, 0@PTRDIFF_T_SUFFIX@)
394
395 /* sig_atomic_t limits */
396 #undef SIG_ATOMIC_MIN
397 #undef SIG_ATOMIC_MAX
398 #define SIG_ATOMIC_MIN  \
399    _STDINT_MIN (@HAVE_SIGNED_SIG_ATOMIC_T@, @BITSIZEOF_SIG_ATOMIC_T@, \
400                 0@SIG_ATOMIC_T_SUFFIX@)
401 #define SIG_ATOMIC_MAX  \
402    _STDINT_MAX (@HAVE_SIGNED_SIG_ATOMIC_T@, @BITSIZEOF_SIG_ATOMIC_T@, \
403                 0@SIG_ATOMIC_T_SUFFIX@)
404
405
406 /* size_t limit */
407 #undef SIZE_MAX
408 #define SIZE_MAX  _STDINT_MAX (0, @BITSIZEOF_SIZE_T@, 0@SIZE_T_SUFFIX@)
409
410 /* wchar_t limits */
411 #undef WCHAR_MIN
412 #undef WCHAR_MAX
413 #define WCHAR_MIN  \
414    _STDINT_MIN (@HAVE_SIGNED_WCHAR_T@, @BITSIZEOF_WCHAR_T@, 0@WCHAR_T_SUFFIX@)
415 #define WCHAR_MAX  \
416    _STDINT_MAX (@HAVE_SIGNED_WCHAR_T@, @BITSIZEOF_WCHAR_T@, 0@WCHAR_T_SUFFIX@)
417
418 /* wint_t limits */
419 #undef WINT_MIN
420 #undef WINT_MAX
421 #define WINT_MIN  \
422    _STDINT_MIN (@HAVE_SIGNED_WINT_T@, @BITSIZEOF_WINT_T@, 0@WINT_T_SUFFIX@)
423 #define WINT_MAX  \
424    _STDINT_MAX (@HAVE_SIGNED_WINT_T@, @BITSIZEOF_WINT_T@, 0@WINT_T_SUFFIX@)
425
426 #endif /* !defined __cplusplus || defined __STDC_LIMIT_MACROS */
427
428 /* 7.18.4. Macros for integer constants */
429
430 #if ! defined __cplusplus || defined __STDC_CONSTANT_MACROS
431
432 /* 7.18.4.1. Macros for minimum-width integer constants */
433 /* According to ISO C 99 Technical Corrigendum 1 */
434
435 /* Here we assume a standard architecture where the hardware integer
436    types have 8, 16, 32, optionally 64 bits, and int is 32 bits.  */
437
438 #undef INT8_C
439 #undef UINT8_C
440 #define INT8_C(x) x
441 #define UINT8_C(x) x
442
443 #undef INT16_C
444 #undef UINT16_C
445 #define INT16_C(x) x
446 #define UINT16_C(x) x
447
448 #undef INT32_C
449 #undef UINT32_C
450 #define INT32_C(x) x
451 #define UINT32_C(x) x ## U
452
453 #undef INT64_C
454 #undef UINT64_C
455 #if LONG_MAX >> 31 >> 31 == 1
456 # define INT64_C(x) x##L
457 #elif defined _MSC_VER
458 # define INT64_C(x) x##i64
459 #elif @HAVE_LONG_LONG_INT@
460 # define INT64_C(x) x##LL
461 #endif
462 #if ULONG_MAX >> 31 >> 31 >> 1 == 1
463 # define UINT64_C(x) x##UL
464 #elif defined _MSC_VER
465 # define UINT64_C(x) x##ui64
466 #elif @HAVE_UNSIGNED_LONG_LONG_INT@
467 # define UINT64_C(x) x##ULL
468 #endif
469
470 /* 7.18.4.2. Macros for greatest-width integer constants */
471
472 #undef INTMAX_C
473 #if @HAVE_LONG_LONG_INT@ && LONG_MAX >> 30 == 1
474 # define INTMAX_C(x)   x##LL
475 #elif defined int64_t
476 # define INTMAX_C(x)   INT64_C(x)
477 #else
478 # define INTMAX_C(x)   x##L
479 #endif
480
481 #undef UINTMAX_C
482 #if @HAVE_UNSIGNED_LONG_LONG_INT@ && ULONG_MAX >> 31 == 1
483 # define UINTMAX_C(x)  x##ULL
484 #elif defined uint64_t
485 # define UINTMAX_C(x)  UINT64_C(x)
486 #else
487 # define UINTMAX_C(x)  x##UL
488 #endif
489
490 #endif /* !defined __cplusplus || defined __STDC_CONSTANT_MACROS */
491
492 #endif /* _GL_STDINT_H */