1 /*************************************************************************
3 * $Id: trio.h,v 1.19 2009/09/13 10:12:22 breese Exp $
5 * Copyright (C) 1998 Bjorn Reese and Daniel Stenberg.
7 * Permission to use, copy, modify, and distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
11 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
12 * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
13 * MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND
14 * CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER.
16 *************************************************************************
18 * http://ctrio.sourceforge.net/
20 ************************************************************************/
25 #if !defined(WITHOUT_TRIO)
27 #if WANT_FETCHMAIL_CONFIG_H_FOR_TRIO - 0
28 /* if used as part of fetchmail, do not include config.h, as that would break
29 * the regression test. */
32 * Use autoconf defines if present. Packages using trio must define
33 * HAVE_CONFIG_H as a compiler option themselves.
35 #if defined(HAVE_CONFIG_H)
51 * Remember to add a textual description to trio_strerror.
66 #define TRIO_ERROR_CODE(x) ((-(x)) & 0x00FF)
67 #define TRIO_ERROR_POSITION(x) ((-(x)) >> 8)
68 #define TRIO_ERROR_NAME(x) trio_strerror(x)
70 typedef int (*trio_outstream_t) TRIO_PROTO((trio_pointer_t, int));
71 typedef int (*trio_instream_t) TRIO_PROTO((trio_pointer_t));
73 TRIO_CONST char *trio_strerror TRIO_PROTO((int));
75 /*************************************************************************
79 int trio_printf TRIO_PROTO((TRIO_CONST char *format, ...));
80 int trio_vprintf TRIO_PROTO((TRIO_CONST char *format, va_list args));
81 int trio_printfv TRIO_PROTO((TRIO_CONST char *format, void **args));
83 int trio_fprintf TRIO_PROTO((FILE *file, TRIO_CONST char *format, ...));
84 int trio_vfprintf TRIO_PROTO((FILE *file, TRIO_CONST char *format, va_list args));
85 int trio_fprintfv TRIO_PROTO((FILE *file, TRIO_CONST char *format, void **args));
87 int trio_dprintf TRIO_PROTO((int fd, TRIO_CONST char *format, ...));
88 int trio_vdprintf TRIO_PROTO((int fd, TRIO_CONST char *format, va_list args));
89 int trio_dprintfv TRIO_PROTO((int fd, TRIO_CONST char *format, void **args));
91 int trio_cprintf TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
92 TRIO_CONST char *format, ...));
93 int trio_vcprintf TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
94 TRIO_CONST char *format, va_list args));
95 int trio_cprintfv TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
96 TRIO_CONST char *format, void **args));
98 int trio_sprintf TRIO_PROTO((char *buffer, TRIO_CONST char *format, ...));
99 int trio_vsprintf TRIO_PROTO((char *buffer, TRIO_CONST char *format, va_list args));
100 int trio_sprintfv TRIO_PROTO((char *buffer, TRIO_CONST char *format, void **args));
102 int trio_snprintf TRIO_PROTO((char *buffer, size_t max, TRIO_CONST char *format, ...));
103 int trio_vsnprintf TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
105 int trio_snprintfv TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
108 int trio_snprintfcat TRIO_PROTO((char *buffer, size_t max, TRIO_CONST char *format, ...));
109 int trio_vsnprintfcat TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
112 #if defined(TRIO_DEPRECATED)
113 char *trio_aprintf TRIO_PROTO((TRIO_CONST char *format, ...));
114 char *trio_vaprintf TRIO_PROTO((TRIO_CONST char *format, va_list args));
117 int trio_asprintf TRIO_PROTO((char **ret, TRIO_CONST char *format, ...));
118 int trio_vasprintf TRIO_PROTO((char **ret, TRIO_CONST char *format, va_list args));
119 int trio_asprintfv TRIO_PROTO((char **result, TRIO_CONST char *format, trio_pointer_t * args));
121 /*************************************************************************
124 int trio_scanf TRIO_PROTO((TRIO_CONST char *format, ...));
125 int trio_vscanf TRIO_PROTO((TRIO_CONST char *format, va_list args));
126 int trio_scanfv TRIO_PROTO((TRIO_CONST char *format, void **args));
128 int trio_fscanf TRIO_PROTO((FILE *file, TRIO_CONST char *format, ...));
129 int trio_vfscanf TRIO_PROTO((FILE *file, TRIO_CONST char *format, va_list args));
130 int trio_fscanfv TRIO_PROTO((FILE *file, TRIO_CONST char *format, void **args));
132 int trio_dscanf TRIO_PROTO((int fd, TRIO_CONST char *format, ...));
133 int trio_vdscanf TRIO_PROTO((int fd, TRIO_CONST char *format, va_list args));
134 int trio_dscanfv TRIO_PROTO((int fd, TRIO_CONST char *format, void **args));
136 int trio_cscanf TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
137 TRIO_CONST char *format, ...));
138 int trio_vcscanf TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
139 TRIO_CONST char *format, va_list args));
140 int trio_cscanfv TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
141 TRIO_CONST char *format, void **args));
143 int trio_sscanf TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, ...));
144 int trio_vsscanf TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, va_list args));
145 int trio_sscanfv TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, void **args));
147 /*************************************************************************
150 void trio_locale_set_decimal_point TRIO_PROTO((char *decimalPoint));
151 void trio_locale_set_thousand_separator TRIO_PROTO((char *thousandSeparator));
152 void trio_locale_set_grouping TRIO_PROTO((char *grouping));
154 /*************************************************************************
157 #ifdef TRIO_REPLACE_STDIO
158 /* Replace the <stdio.h> functions */
161 # define printf trio_printf
165 # define vprintf trio_vprintf
169 # define fprintf trio_fprintf
171 #ifndef HAVE_VFPRINTF
173 # define vfprintf trio_vfprintf
177 # define sprintf trio_sprintf
179 #ifndef HAVE_VSPRINTF
181 # define vsprintf trio_vsprintf
183 #ifndef HAVE_SNPRINTF
185 # define snprintf trio_snprintf
187 #ifndef HAVE_VSNPRINTF
189 # define vsnprintf trio_vsnprintf
193 # define scanf trio_scanf
197 # define vscanf trio_vscanf
201 # define fscanf trio_fscanf
205 # define vfscanf trio_vfscanf
209 # define sscanf trio_sscanf
213 # define vsscanf trio_vsscanf
215 /* These aren't stdio functions, but we make them look similar */
217 #define dprintf trio_dprintf
219 #define vdprintf trio_vdprintf
221 #define aprintf trio_aprintf
223 #define vaprintf trio_vaprintf
225 #define asprintf trio_asprintf
227 #define vasprintf trio_vasprintf
229 #define dscanf trio_dscanf
231 #define vdscanf trio_vdscanf
238 #endif /* WITHOUT_TRIO */
240 #endif /* TRIO_TRIO_H */