File: /usr/include/inttypes.h
1 /* Copyright (C) 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public License as
6 published by the Free Software Foundation; either version 2 of the
7 License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Library General Public License for more details.
13
14 You should have received a copy of the GNU Library General Public
15 License along with the GNU C Library; see the file COPYING.LIB. If not,
16 write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 Boston, MA 02111-1307, USA. */
18
19 /*
20 * ISO C99: 7.8 Format conversion of integer types <inttypes.h>
21 */
22
23 #ifndef _INTTYPES_H
24 #define _INTTYPES_H 1
25
26 #include <features.h>
27 /* Get the type definitions. */
28 #include <stdint.h>
29
30
31 /* The ISO C99 standard specifies that these macros must only be
32 defined if explicitly requested. */
33 #if !defined __cplusplus || defined __STDC_FORMAT_MACROS
34
35 # if __WORDSIZE == 64
36 # define __PRI64_PREFIX "l"
37 # define __PRIPTR_PREFIX "l"
38 # else
39 # define __PRI64_PREFIX "ll"
40 # define __PRIPTR_PREFIX
41 # endif
42
43 /* Macros for printing format specifiers. */
44
45 /* Decimal notation. */
46 # define PRId8 "d"
47 # define PRId16 "d"
48 # define PRId32 "d"
49 # define PRId64 __PRI64_PREFIX "d"
50
51 # define PRIdLEAST8 "d"
52 # define PRIdLEAST16 "d"
53 # define PRIdLEAST32 "d"
54 # define PRIdLEAST64 __PRI64_PREFIX "d"
55
56 # define PRIdFAST8 "d"
57 # define PRIdFAST16 "d"
58 # define PRIdFAST32 "d"
59 # define PRIdFAST64 __PRI64_PREFIX "d"
60
61
62 # define PRIi8 "i"
63 # define PRIi16 "i"
64 # define PRIi32 "i"
65 # define PRIi64 __PRI64_PREFIX "i"
66
67 # define PRIiLEAST8 "i"
68 # define PRIiLEAST16 "i"
69 # define PRIiLEAST32 "i"
70 # define PRIiLEAST64 __PRI64_PREFIX "i"
71
72 # define PRIiFAST8 "i"
73 # define PRIiFAST16 "i"
74 # define PRIiFAST32 "i"
75 # define PRIiFAST64 __PRI64_PREFIX "i"
76
77 /* Octal notation. */
78 # define PRIo8 "o"
79 # define PRIo16 "o"
80 # define PRIo32 "o"
81 # define PRIo64 __PRI64_PREFIX "o"
82
83 # define PRIoLEAST8 "o"
84 # define PRIoLEAST16 "o"
85 # define PRIoLEAST32 "o"
86 # define PRIoLEAST64 __PRI64_PREFIX "o"
87
88 # define PRIoFAST8 "o"
89 # define PRIoFAST16 "o"
90 # define PRIoFAST32 "o"
91 # define PRIoFAST64 __PRI64_PREFIX "o"
92
93 /* Unsigned integers. */
94 # define PRIu8 "u"
95 # define PRIu16 "u"
96 # define PRIu32 "u"
97 # define PRIu64 __PRI64_PREFIX "u"
98
99 # define PRIuLEAST8 "u"
100 # define PRIuLEAST16 "u"
101 # define PRIuLEAST32 "u"
102 # define PRIuLEAST64 __PRI64_PREFIX "u"
103
104 # define PRIuFAST8 "u"
105 # define PRIuFAST16 "u"
106 # define PRIuFAST32 "u"
107 # define PRIuFAST64 __PRI64_PREFIX "u"
108
109 /* lowercase hexadecimal notation. */
110 # define PRIx8 "x"
111 # define PRIx16 "x"
112 # define PRIx32 "x"
113 # define PRIx64 __PRI64_PREFIX "x"
114
115 # define PRIxLEAST8 "x"
116 # define PRIxLEAST16 "x"
117 # define PRIxLEAST32 "x"
118 # define PRIxLEAST64 __PRI64_PREFIX "x"
119
120 # define PRIxFAST8 "x"
121 # define PRIxFAST16 "x"
122 # define PRIxFAST32 "x"
123 # define PRIxFAST64 __PRI64_PREFIX "x"
124
125 /* UPPERCASE hexadecimal notation. */
126 # define PRIX8 "X"
127 # define PRIX16 "X"
128 # define PRIX32 "X"
129 # define PRIX64 __PRI64_PREFIX "X"
130
131 # define PRIXLEAST8 "X"
132 # define PRIXLEAST16 "X"
133 # define PRIXLEAST32 "X"
134 # define PRIXLEAST64 __PRI64_PREFIX "X"
135
136 # define PRIXFAST8 "X"
137 # define PRIXFAST16 "X"
138 # define PRIXFAST32 "X"
139 # define PRIXFAST64 __PRI64_PREFIX "X"
140
141
142 /* Macros for printing `intmax_t' and `uintmax_t'. */
143 # define PRIdMAX __PRI64_PREFIX "d"
144 # define PRIiMAX __PRI64_PREFIX "i"
145 # define PRIoMAX __PRI64_PREFIX "o"
146 # define PRIuMAX __PRI64_PREFIX "u"
147 # define PRIxMAX __PRI64_PREFIX "x"
148 # define PRIXMAX __PRI64_PREFIX "X"
149
150
151 /* Macros for printing `intptr_t' and `uintptr_t'. */
152 # define PRIdPTR __PRIPTR_PREFIX "d"
153 # define PRIiPTR __PRIPTR_PREFIX "i"
154 # define PRIoPTR __PRIPTR_PREFIX "o"
155 # define PRIuPTR __PRIPTR_PREFIX "u"
156 # define PRIxPTR __PRIPTR_PREFIX "x"
157 # define PRIXPTR __PRIPTR_PREFIX "X"
158
159
160 /* Macros for scanning format specifiers. */
161
162 /* Signed decimal notation. */
163 # define SCNd8 "hhd"
164 # define SCNd16 "hd"
165 # define SCNd32 "d"
166 # define SCNd64 __PRI64_PREFIX "d"
167
168 # define SCNdLEAST8 "hhd"
169 # define SCNdLEAST16 "hd"
170 # define SCNdLEAST32 "d"
171 # define SCNdLEAST64 __PRI64_PREFIX "d"
172
173 # define SCNdFAST8 "hhd"
174 # define SCNdFAST16 __PRIPTR_PREFIX "d"
175 # define SCNdFAST32 __PRIPTR_PREFIX "d"
176 # define SCNdFAST64 __PRI64_PREFIX "d"
177
178 /* Signed decimal notation. */
179 # define SCNi8 "hhi"
180 # define SCNi16 "hi"
181 # define SCNi32 "i"
182 # define SCNi64 __PRI64_PREFIX "i"
183
184 # define SCNiLEAST8 "hhi"
185 # define SCNiLEAST16 "hi"
186 # define SCNiLEAST32 "i"
187 # define SCNiLEAST64 __PRI64_PREFIX "i"
188
189 # define SCNiFAST8 "hhi"
190 # define SCNiFAST16 __PRIPTR_PREFIX "i"
191 # define SCNiFAST32 __PRIPTR_PREFIX "i"
192 # define SCNiFAST64 __PRI64_PREFIX "i"
193
194 /* Unsigned decimal notation. */
195 # define SCNu8 "hhu"
196 # define SCNu16 "hu"
197 # define SCNu32 "u"
198 # define SCNu64 __PRI64_PREFIX "u"
199
200 # define SCNuLEAST8 "hhu"
201 # define SCNuLEAST16 "hu"
202 # define SCNuLEAST32 "u"
203 # define SCNuLEAST64 __PRI64_PREFIX "u"
204
205 # define SCNuFAST8 "hhu"
206 # define SCNuFAST16 __PRIPTR_PREFIX "u"
207 # define SCNuFAST32 __PRIPTR_PREFIX "u"
208 # define SCNuFAST64 __PRI64_PREFIX "u"
209
210 /* Octal notation. */
211 # define SCNo8 "hho"
212 # define SCNo16 "ho"
213 # define SCNo32 "o"
214 # define SCNo64 __PRI64_PREFIX "o"
215
216 # define SCNoLEAST8 "hho"
217 # define SCNoLEAST16 "ho"
218 # define SCNoLEAST32 "o"
219 # define SCNoLEAST64 __PRI64_PREFIX "o"
220
221 # define SCNoFAST8 "hho"
222 # define SCNoFAST16 __PRIPTR_PREFIX "o"
223 # define SCNoFAST32 __PRIPTR_PREFIX "o"
224 # define SCNoFAST64 __PRI64_PREFIX "o"
225
226 /* Hexadecimal notation. */
227 # define SCNx8 "hhx"
228 # define SCNx16 "hx"
229 # define SCNx32 "x"
230 # define SCNx64 __PRI64_PREFIX "x"
231
232 # define SCNxLEAST8 "hhx"
233 # define SCNxLEAST16 "hx"
234 # define SCNxLEAST32 "x"
235 # define SCNxLEAST64 __PRI64_PREFIX "x"
236
237 # define SCNxFAST8 "hhx"
238 # define SCNxFAST16 __PRIPTR_PREFIX "x"
239 # define SCNxFAST32 __PRIPTR_PREFIX "x"
240 # define SCNxFAST64 __PRI64_PREFIX "x"
241
242
243 /* Macros for scanning `intmax_t' and `uintmax_t'. */
244 # define SCNdMAX __PRI64_PREFIX "d"
245 # define SCNiMAX __PRI64_PREFIX "i"
246 # define SCNoMAX __PRI64_PREFIX "o"
247 # define SCNuMAX __PRI64_PREFIX "u"
248 # define SCNxMAX __PRI64_PREFIX "x"
249
250 /* Macros for scaning `intptr_t' and `uintptr_t'. */
251 # define SCNdPTR __PRIPTR_PREFIX "d"
252 # define SCNiPTR __PRIPTR_PREFIX "i"
253 # define SCNoPTR __PRIPTR_PREFIX "o"
254 # define SCNuPTR __PRIPTR_PREFIX "u"
255 # define SCNxPTR __PRIPTR_PREFIX "x"
256
257 #endif /* C++ && format macros */
258
259
260 __BEGIN_DECLS
261
262 #if __WORDSIZE == 64
263
264 /* We have to define the `uintmax_t' type using `ldiv_t'. */
265 typedef struct
266 {
267 long int quot; /* Quotient. */
268 long int rem; /* Remainder. */
269 } imaxdiv_t;
270
271 #else
272
273 /* We have to define the `uintmax_t' type using `lldiv_t'. */
274 typedef struct
275 {
276 long long int quot; /* Quotient. */
277 long long int rem; /* Remainder. */
278 } imaxdiv_t;
279
280 #endif
281
282
283 /* Compute absolute value of N. */
284 extern intmax_t imaxabs (intmax_t __n) __THROW __attribute__ ((__const__));
285
286 /* Return the `imaxdiv_t' representation of the value of NUMER over DENOM. */
287 extern imaxdiv_t imaxdiv (intmax_t __numer, intmax_t __denom)
288 __THROW __attribute__ ((__const__));
289
290 /* Like `strtol' but convert to `intmax_t'. */
291 extern intmax_t strtoimax (__const char *__restrict __nptr,
292 char **__restrict __endptr, int __base) __THROW;
293
294 /* Like `strtoul' but convert to `uintmax_t'. */
295 extern uintmax_t strtoumax (__const char * __restrict __nptr,
296 char ** __restrict __endptr, int __base) __THROW;
297
298 /* Like `wcstol' but convert to `intmax_t'. */
299 extern intmax_t wcstoimax (__const wchar_t * __restrict __nptr,
300 wchar_t **__restrict __endptr, int __base) __THROW;
301
302 /* Like `wcstoul' but convert to `uintmax_t'. */
303 extern uintmax_t wcstoumax (__const wchar_t * __restrict __nptr,
304 wchar_t ** __restrict __endptr, int __base) __THROW;
305
306 #ifdef __USE_EXTERN_INLINES
307
308 # if __WORDSIZE == 64
309
310 /* Like `strtol' but convert to `intmax_t'. */
311 # ifndef __strtol_internal_defined
312 extern long int __strtol_internal (__const char *__restrict __nptr,
313 char **__restrict __endptr,
314 int __base, int __group) __THROW;
315 # define __strtol_internal_defined 1
316 # endif
317 extern __inline intmax_t
318 strtoimax (__const char *__restrict nptr, char **__restrict endptr,
319 int base) __THROW
320 {
321 return __strtol_internal (nptr, endptr, base, 0);
322 }
323
324 /* Like `strtoul' but convert to `uintmax_t'. */
325 # ifndef __strtoul_internal_defined
326 extern unsigned long int __strtoul_internal (__const char *
327 __restrict __nptr,
328 char ** __restrict __endptr,
329 int __base, int __group) __THROW;
330 # define __strtoul_internal_defined 1
331 # endif
332 extern __inline uintmax_t
333 strtoumax (__const char *__restrict nptr, char **__restrict endptr,
334 int base) __THROW
335 {
336 return __strtoul_internal (nptr, endptr, base, 0);
337 }
338
339 /* Like `wcstol' but convert to `intmax_t'. */
340 # ifndef __wcstol_internal_defined
341 extern long int __wcstol_internal (__const wchar_t * __restrict __nptr,
342 wchar_t **__restrict __endptr,
343 int __base, int __group) __THROW;
344 # define __wcstol_internal_defined 1
345 # endif
346 extern __inline intmax_t
347 wcstoimax (__const wchar_t *__restrict nptr, wchar_t **__restrict endptr,
348 int base) __THROW
349 {
350 return __wcstol_internal (nptr, endptr, base, 0);
351 }
352
353
354 /* Like `wcstoul' but convert to `uintmax_t'. */
355 # ifndef __wcstoul_internal_defined
356 extern unsigned long int __wcstoul_internal (__const wchar_t *
357 __restrict __nptr,
358 wchar_t **
359 __restrict __endptr,
360 int __base, int __group) __THROW;
361 # define __wcstoul_internal_defined 1
362 # endif
363 extern __inline uintmax_t
364 wcstoumax (__const wchar_t *__restrict nptr, wchar_t **__restrict endptr,
365 int base) __THROW
366 {
367 return __wcstoul_internal (nptr, endptr, base, 0);
368 }
369
370 # else /* __WORDSIZE == 32 */
371
372 /* Like `strtol' but convert to `intmax_t'. */
373 # ifndef __strtoll_internal_defined
374 __extension__
375 extern long long int __strtoll_internal (__const char *__restrict __nptr,
376 char **__restrict __endptr,
377 int __base, int __group) __THROW;
378 # define __strtoll_internal_defined 1
379 # endif
380 extern __inline intmax_t
381 strtoimax (__const char *__restrict nptr, char **__restrict endptr,
382 int base) __THROW
383 {
384 return __strtoll_internal (nptr, endptr, base, 0);
385 }
386
387 /* Like `strtoul' but convert to `uintmax_t'. */
388 # ifndef __strtoull_internal_defined
389 __extension__
390 extern unsigned long long int __strtoull_internal (__const char *
391 __restrict __nptr,
392 char **
393 __restrict __endptr,
394 int __base,
395 int __group) __THROW;
396 # define __strtoull_internal_defined 1
397 # endif
398 extern __inline uintmax_t
399 strtoumax (__const char *__restrict nptr, char **__restrict endptr,
400 int base) __THROW
401 {
402 return __strtoull_internal (nptr, endptr, base, 0);
403 }
404
405 /* Like `wcstol' but convert to `intmax_t'. */
406 # ifndef __wcstoll_internal_defined
407 __extension__
408 extern long long int __wcstoll_internal (__const wchar_t *
409 __restrict __nptr,
410 wchar_t **__restrict __endptr,
411 int __base, int __group) __THROW;
412 # define __wcstoll_internal_defined 1
413 # endif
414 extern __inline intmax_t
415 wcstoimax (__const wchar_t *__restrict nptr, wchar_t **__restrict endptr,
416 int base) __THROW
417 {
418 return __wcstoll_internal (nptr, endptr, base, 0);
419 }
420
421
422 /* Like `wcstoul' but convert to `uintmax_t'. */
423 # ifndef __wcstoull_internal_defined
424 __extension__
425 extern unsigned long long int __wcstoull_internal (__const wchar_t *
426 __restrict __nptr,
427 wchar_t **
428 __restrict __endptr,
429 int __base,
430 int __group) __THROW;
431 # define __wcstoull_internal_defined 1
432 # endif
433 extern __inline uintmax_t
434 wcstoumax (__const wchar_t *__restrict nptr, wchar_t **__restrict endptr,
435 int base) __THROW
436 {
437 return __wcstoull_internal (nptr, endptr, base, 0);
438 }
439
440 # endif /* __WORDSIZE == 32 */
441 #endif /* Use extern inlines. */
442
443 __END_DECLS
444
445 #endif /* inttypes.h */
446