xref: /freebsd/include/printf.h (revision 1e413cf93298b5b97441a21d9a50fdcd0ee9945e)
1 /*-
2  * Copyright (c) 2005 Poul-Henning Kamp
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 
29 #ifndef _PRINTF_H_
30 #define _PRINTF_H_
31 
32 #include <wchar.h>
33 
34 /*
35  * The API defined by glibc allows a renderer to take multiple arguments
36  * This is obviously usable for things like (ptr+len) pairs etc.
37  * But the do not actually provide support for it at the end of the day,
38  * they offer only one argument to the arginfo function, but do accept
39  * >1 returns, although the do not check the types of those arguments
40  * argument
41  * Be compatible for now.
42  */
43 #define __PRINTFMAXARG		2
44 
45 struct printf_info {
46 	/* GLIBC compatible */
47 	int		prec;
48 	int		width;
49 	wchar_t		spec;
50 	unsigned 	is_long_double;
51 	unsigned 	is_char;
52 	unsigned	is_short;
53 	unsigned	is_long;
54 	unsigned	alt;
55 	unsigned	space;
56 	unsigned	left;
57 	unsigned	showsign;
58 	unsigned	group;
59 	unsigned	extra;
60 	unsigned	wide;
61 	wchar_t		pad;
62 
63 	/* FreeBSD extensions */
64 
65 	unsigned	is_quad;
66 	unsigned	is_intmax;
67 	unsigned	is_ptrdiff;
68 	unsigned	is_size;
69 
70 	/* private */
71 	int		sofar;
72 	unsigned	get_width;
73 	unsigned	get_prec;
74 	const char	*begin;
75 	const char	*end;
76 	void 		*arg[__PRINTFMAXARG];
77 };
78 
79 enum {
80 	PA_INT		= (1 << 0),	/* int */
81 	PA_CHAR		= (1 << 1),	/* int, cast to char */
82 	PA_WCHAR	= (1 << 2),	/* wide char */
83 	PA_STRING	= (1 << 3),	/* const char * (with '\0') */
84 	PA_WSTRING	= (1 << 4),	/* const wchar_t * */
85 	PA_POINTER	= (1 << 5),	/* void * */
86 	PA_FLOAT	= (1 << 6),	/* float */
87 	PA_DOUBLE	= (1 << 7) 	/* double */
88 };
89 
90 #define	PA_FLAG_MASK		0xff0000
91 #define	PA_FLAG_LONG_LONG	(1 << 16)
92 #define	PA_FLAG_LONG		(1 << 17)
93 #define	PA_FLAG_SHORT		(1 << 18)
94 #define	PA_FLAG_PTR		(1 << 19)
95 #define	PA_FLAG_QUAD		(1 << 20)
96 #define	PA_FLAG_INTMAX		(1 << 21)
97 #define	PA_FLAG_SIZE		(1 << 22)
98 #define	PA_FLAG_PTRDIFF		(1 << 23)
99 #define	PA_FLAG_LONG_DOUBLE	PA_FLAG_LONG_LONG
100 
101 typedef int printf_arginfo_function(const struct printf_info *, size_t, int *);
102 typedef int printf_function(FILE *, const struct printf_info *, const void *const *);
103 
104 /* FreeBSD extension */
105 struct __printf_io;
106 typedef int printf_render(struct __printf_io *, const struct printf_info *, const void *const *);
107 
108 /* vprintf.c */
109 extern const char __lowercase_hex[17];
110 extern const char __uppercase_hex[17];
111 
112 void __printf_flush(struct __printf_io *io);
113 int __printf_puts(struct __printf_io *io, const void *ptr, int len);
114 int __printf_pad(struct __printf_io *io, int n, int zero);
115 int __printf_out(struct __printf_io *io, const struct printf_info *pi, const void *ptr, int len);
116 
117 int __xvprintf(FILE *fp, const char *fmt0, va_list ap);
118 extern int __use_xprintf;
119 
120 /* GLIBC compat */
121 int register_printf_function(int spec, printf_function *render, printf_arginfo_function *arginfo);
122 
123 /* FreeBSD */
124 int register_printf_render(int spec, printf_render *render, printf_arginfo_function *arginfo);
125 int register_printf_render_std(const unsigned char *specs);
126 
127 /* vprintf_errno.c */
128 printf_arginfo_function		__printf_arginfo_errno;
129 printf_render			__printf_render_errno;
130 
131 /* vprintf_float.c */
132 printf_arginfo_function		__printf_arginfo_float;
133 printf_render			__printf_render_float;
134 
135 /* vprintf_hexdump.c */
136 printf_arginfo_function		__printf_arginfo_hexdump;
137 printf_render 			__printf_render_hexdump;
138 
139 /* vprintf_int.c */
140 printf_arginfo_function		__printf_arginfo_ptr;
141 printf_arginfo_function		__printf_arginfo_int;
142 printf_render			__printf_render_ptr;
143 printf_render			__printf_render_int;
144 
145 /* vprintf_quoute.c */
146 printf_arginfo_function		__printf_arginfo_quote;
147 printf_render 			__printf_render_quote;
148 
149 /* vprintf_str.c */
150 printf_arginfo_function		__printf_arginfo_chr;
151 printf_render			__printf_render_chr;
152 printf_arginfo_function		__printf_arginfo_str;
153 printf_render			__printf_render_str;
154 
155 /* vprintf_time.c */
156 printf_arginfo_function		__printf_arginfo_time;
157 printf_render			__printf_render_time;
158 
159 /* vprintf_vis.c */
160 printf_arginfo_function		__printf_arginfo_vis;
161 printf_render 			__printf_render_vis;
162 
163 #endif /* !_PRINTF_H */
164