inttypes.h revision a27d2baa0c1a2ec70f47ea9199b1dd6762c8a349 
1/*	$OpenBSD: inttypes.h,v 1.9 2006/01/15 00:47:51 millert Exp $	*/
2
3/*
4 * Copyright (c) 1997, 2005 Todd C. Miller <Todd.Miller@courtesan.com>
5 *
6 * Permission to use, copy, modify, and distribute this software for any
7 * purpose with or without fee is hereby granted, provided that the above
8 * copyright notice and this permission notice appear in all copies.
9 *
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 */
18
19#ifndef	_INTTYPES_H_
20#define	_INTTYPES_H_
21
22#include <stdint.h>
23#include <sys/cdefs.h>
24
25#if !defined(__cplusplus) || defined(__STDC_FORMAT_MACROS)
26/*
27 * 7.8.1 Macros for format specifiers
28 *
29 * Each of the following object-like macros expands to a string
30 * literal containing a conversion specifier, possibly modified by
31 * a prefix such as hh, h, l, or ll, suitable for use within the
32 * format argument of a formatted input/output function when
33 * converting the corresponding integer type.  These macro names
34 * have the general form of PRI (character string literals for the
35 * fprintf family) or SCN (character string literals for the fscanf
36 * family), followed by the conversion specifier, followed by a
37 * name corresponding to a similar typedef name.  For example,
38 * PRIdFAST32 can be used in a format string to print the value of
39 * an integer of type int_fast32_t.
40 */
41
42/* fprintf macros for signed integers */
43#define	PRId8			"d"		/* int8_t */
44#define	PRId16			"d"		/* int16_t */
45#define	PRId32			"d"		/* int32_t */
46#define	PRId64			"lld"		/* int64_t */
47
48#define	PRIdLEAST8		"d"		/* int_least8_t */
49#define	PRIdLEAST16		"d"		/* int_least16_t */
50#define	PRIdLEAST32		"d"		/* int_least32_t */
51#define	PRIdLEAST64		"lld"		/* int_least64_t */
52
53#define	PRIdFAST8		"d"		/* int_fast8_t */
54#define	PRIdFAST16		"d"		/* int_fast16_t */
55#define	PRIdFAST32		"d"		/* int_fast32_t */
56#define	PRIdFAST64		"lld"		/* int_fast64_t */
57
58#define	PRIdMAX			"jd"		/* intmax_t */
59#define	PRIdPTR			"ld"		/* intptr_t */
60
61#define	PRIi8			"i"		/* int8_t */
62#define	PRIi16			"i"		/* int16_t */
63#define	PRIi32			"i"		/* int32_t */
64#define	PRIi64			"lli"		/* int64_t */
65
66#define	PRIiLEAST8		"i"		/* int_least8_t */
67#define	PRIiLEAST16		"i"		/* int_least16_t */
68#define	PRIiLEAST32		"i"		/* int_least32_t */
69#define	PRIiLEAST64		"lli"		/* int_least64_t */
70
71#define	PRIiFAST8		"i"		/* int_fast8_t */
72#define	PRIiFAST16		"i"		/* int_fast16_t */
73#define	PRIiFAST32		"i"		/* int_fast32_t */
74#define	PRIiFAST64		"lli"		/* int_fast64_t */
75
76#define	PRIiMAX			"ji"		/* intmax_t */
77#define	PRIiPTR			"li"		/* intptr_t */
78
79/* fprintf macros for unsigned integers */
80#define	PRIo8			"o"		/* int8_t */
81#define	PRIo16			"o"		/* int16_t */
82#define	PRIo32			"o"		/* int32_t */
83#define	PRIo64			"llo"		/* int64_t */
84
85#define	PRIoLEAST8		"o"		/* int_least8_t */
86#define	PRIoLEAST16		"o"		/* int_least16_t */
87#define	PRIoLEAST32		"o"		/* int_least32_t */
88#define	PRIoLEAST64		"llo"		/* int_least64_t */
89
90#define	PRIoFAST8		"o"		/* int_fast8_t */
91#define	PRIoFAST16		"o"		/* int_fast16_t */
92#define	PRIoFAST32		"o"		/* int_fast32_t */
93#define	PRIoFAST64		"llo"		/* int_fast64_t */
94
95#define	PRIoMAX			"jo"		/* intmax_t */
96#define	PRIoPTR			"lo"		/* intptr_t */
97
98#define	PRIu8			"u"		/* uint8_t */
99#define	PRIu16			"u"		/* uint16_t */
100#define	PRIu32			"u"		/* uint32_t */
101#define	PRIu64			"llu"		/* uint64_t */
102
103#define	PRIuLEAST8		"u"		/* uint_least8_t */
104#define	PRIuLEAST16		"u"		/* uint_least16_t */
105#define	PRIuLEAST32		"u"		/* uint_least32_t */
106#define	PRIuLEAST64		"llu"		/* uint_least64_t */
107
108#define	PRIuFAST8		"u"		/* uint_fast8_t */
109#define	PRIuFAST16		"u"		/* uint_fast16_t */
110#define	PRIuFAST32		"u"		/* uint_fast32_t */
111#define	PRIuFAST64		"llu"		/* uint_fast64_t */
112
113#define	PRIuMAX			"ju"		/* uintmax_t */
114#define	PRIuPTR			"lu"		/* uintptr_t */
115
116#define	PRIx8			"x"		/* uint8_t */
117#define	PRIx16			"x"		/* uint16_t */
118#define	PRIx32			"x"		/* uint32_t */
119#define	PRIx64			"llx"		/* uint64_t */
120
121#define	PRIxLEAST8		"x"		/* uint_least8_t */
122#define	PRIxLEAST16		"x"		/* uint_least16_t */
123#define	PRIxLEAST32		"x"		/* uint_least32_t */
124#define	PRIxLEAST64		"llx"		/* uint_least64_t */
125
126#define	PRIxFAST8		"x"		/* uint_fast8_t */
127#define	PRIxFAST16		"x"		/* uint_fast16_t */
128#define	PRIxFAST32		"x"		/* uint_fast32_t */
129#define	PRIxFAST64		"llx"		/* uint_fast64_t */
130
131#define	PRIxMAX			"jx"		/* uintmax_t */
132#define	PRIxPTR			"lx"		/* uintptr_t */
133
134#define	PRIX8			"X"		/* uint8_t */
135#define	PRIX16			"X"		/* uint16_t */
136#define	PRIX32			"X"		/* uint32_t */
137#define	PRIX64			"llX"		/* uint64_t */
138
139#define	PRIXLEAST8		"X"		/* uint_least8_t */
140#define	PRIXLEAST16		"X"		/* uint_least16_t */
141#define	PRIXLEAST32		"X"		/* uint_least32_t */
142#define	PRIXLEAST64		"llX"		/* uint_least64_t */
143
144#define	PRIXFAST8		"X"		/* uint_fast8_t */
145#define	PRIXFAST16		"X"		/* uint_fast16_t */
146#define	PRIXFAST32		"X"		/* uint_fast32_t */
147#define	PRIXFAST64		"llX"		/* uint_fast64_t */
148
149#define	PRIXMAX			"jX"		/* uintmax_t */
150#define	PRIXPTR			"lX"		/* uintptr_t */
151
152/* fscanf macros for signed integers */
153#define	SCNd8			"hhd"		/* int8_t */
154#define	SCNd16			"hd"		/* int16_t */
155#define	SCNd32			"d"		/* int32_t */
156#define	SCNd64			"lld"		/* int64_t */
157
158#define	SCNdLEAST8		"hhd"		/* int_least8_t */
159#define	SCNdLEAST16		"hd"		/* int_least16_t */
160#define	SCNdLEAST32		"d"		/* int_least32_t */
161#define	SCNdLEAST64		"lld"		/* int_least64_t */
162
163#define	SCNdFAST8		"hhd"		/* int_fast8_t */
164#define	SCNdFAST16		"hd"		/* int_fast16_t */
165#define	SCNdFAST32		"d"		/* int_fast32_t */
166#define	SCNdFAST64		"lld"		/* int_fast64_t */
167
168#define	SCNdMAX			"jd"		/* intmax_t */
169#define	SCNdPTR			"ld"		/* intptr_t */
170
171#define	SCNi8			"hhi"		/* int8_t */
172#define	SCNi16			"hi"		/* int16_t */
173#define	SCNi32			"i"		/* int32_t */
174#define	SCNi64			"lli"		/* int64_t */
175
176#define	SCNiLEAST8		"hhi"		/* int_least8_t */
177#define	SCNiLEAST16		"hi"		/* int_least16_t */
178#define	SCNiLEAST32		"i"		/* int_least32_t */
179#define	SCNiLEAST64		"lli"		/* int_least64_t */
180
181#define	SCNiFAST8		"hhi"		/* int_fast8_t */
182#define	SCNiFAST16		"hi"		/* int_fast16_t */
183#define	SCNiFAST32		"i"		/* int_fast32_t */
184#define	SCNiFAST64		"lli"		/* int_fast64_t */
185
186#define	SCNiMAX			"ji"		/* intmax_t */
187#define	SCNiPTR			"li"		/* intptr_t */
188
189/* fscanf macros for unsigned integers */
190#define	SCNo8			"hho"		/* uint8_t */
191#define	SCNo16			"ho"		/* uint16_t */
192#define	SCNo32			"o"		/* uint32_t */
193#define	SCNo64			"llo"		/* uint64_t */
194
195#define	SCNoLEAST8		"hho"		/* uint_least8_t */
196#define	SCNoLEAST16		"ho"		/* uint_least16_t */
197#define	SCNoLEAST32		"o"		/* uint_least32_t */
198#define	SCNoLEAST64		"llo"		/* uint_least64_t */
199
200#define	SCNoFAST8		"hho"		/* uint_fast8_t */
201#define	SCNoFAST16		"ho"		/* uint_fast16_t */
202#define	SCNoFAST32		"o"		/* uint_fast32_t */
203#define	SCNoFAST64		"llo"		/* uint_fast64_t */
204
205#define	SCNoMAX			"jo"		/* uintmax_t */
206#define	SCNoPTR			"lo"		/* uintptr_t */
207
208#define	SCNu8			"hhu"		/* uint8_t */
209#define	SCNu16			"hu"		/* uint16_t */
210#define	SCNu32			"u"		/* uint32_t */
211#define	SCNu64			"llu"		/* uint64_t */
212
213#define	SCNuLEAST8		"hhu"		/* uint_least8_t */
214#define	SCNuLEAST16		"hu"		/* uint_least16_t */
215#define	SCNuLEAST32		"u"		/* uint_least32_t */
216#define	SCNuLEAST64		"llu"		/* uint_least64_t */
217
218#define	SCNuFAST8		"hhu"		/* uint_fast8_t */
219#define	SCNuFAST16		"hu"		/* uint_fast16_t */
220#define	SCNuFAST32		"u"		/* uint_fast32_t */
221#define	SCNuFAST64		"llu"		/* uint_fast64_t */
222
223#define	SCNuMAX			"ju"		/* uintmax_t */
224#define	SCNuPTR			"lu"		/* uintptr_t */
225
226#define	SCNx8			"hhx"		/* uint8_t */
227#define	SCNx16			"hx"		/* uint16_t */
228#define	SCNx32			"x"		/* uint32_t */
229#define	SCNx64			"llx"		/* uint64_t */
230
231#define	SCNxLEAST8		"hhx"		/* uint_least8_t */
232#define	SCNxLEAST16		"hx"		/* uint_least16_t */
233#define	SCNxLEAST32		"x"		/* uint_least32_t */
234#define	SCNxLEAST64		"llx"		/* uint_least64_t */
235
236#define	SCNxFAST8		"hhx"		/* uint_fast8_t */
237#define	SCNxFAST16		"hx"		/* uint_fast16_t */
238#define	SCNxFAST32		"x"		/* uint_fast32_t */
239#define	SCNxFAST64		"llx"		/* uint_fast64_t */
240
241#define	SCNxMAX			"jx"		/* uintmax_t */
242#define	SCNxPTR			"lx"		/* uintptr_t */
243
244#endif /* __cplusplus || __STDC_FORMAT_MACROS */
245
246typedef struct {
247	intmax_t quot;		/* quotient */
248	intmax_t rem;		/* remainder */
249} imaxdiv_t;
250
251__BEGIN_DECLS
252intmax_t	imaxabs(intmax_t);
253imaxdiv_t	imaxdiv(intmax_t, intmax_t);
254intmax_t	strtoimax(const char *, char **, int);
255uintmax_t	strtoumax(const char *, char **, int);
256__END_DECLS
257
258#endif /* _INTTYPES_H_ */
259