third_party/libxml/src/trio.h

   1 /*************************************************************************
   2  *
   3  * $Id$
   4  *
   5  * Copyright (C) 1998 Bjorn Reese and Daniel Stenberg.
   6  *
   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.
  10  *
  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.
  15  *
  16  *************************************************************************
  17  *
  18  * http://ctrio.sourceforge.net/
  19  *
  20  ************************************************************************/
  21
  22 #ifndef TRIO_TRIO_H
  23 #define TRIO_TRIO_H
  24
  25 #if !defined(WITHOUT_TRIO)
  26
  27 /*
  28  * Use autoconf defines if present. Packages using trio must define
  29  * HAVE_CONFIG_H as a compiler option themselves.
  30  */
  31 #if defined(TRIO_HAVE_CONFIG_H)
  32 # include "config.h"
  33 #endif
  34
  35 #include "triodef.h"
  36
  37 #include <stdio.h>
  38 #include <stdlib.h>
  39 #if defined(TRIO_COMPILER_ANCIENT)
  40 # include <varargs.h>
  41 #else
  42 # include <stdarg.h>
  43 #endif
  44
  45 #ifdef __cplusplus
  46 extern "C" {
  47 #endif
  48
  49 /*
  50  * Error codes.
  51  *
  52  * Remember to add a textual description to trio_strerror.
  53  */
  54 enum {
  55   TRIO_EOF      = 1,
  56   TRIO_EINVAL   = 2,
  57   TRIO_ETOOMANY = 3,
  58   TRIO_EDBLREF  = 4,
  59   TRIO_EGAP     = 5,
  60   TRIO_ENOMEM   = 6,
  61   TRIO_ERANGE   = 7,
  62   TRIO_ERRNO    = 8,
  63   TRIO_ECUSTOM  = 9
  64 };
  65
  66 /* Error macros */
  67 #define TRIO_ERROR_CODE(x) ((-(x)) & 0x00FF)
  68 #define TRIO_ERROR_POSITION(x) ((-(x)) >> 8)
  69 #define TRIO_ERROR_NAME(x) trio_strerror(x)
  70
  71 typedef int (*trio_outstream_t) TRIO_PROTO((trio_pointer_t, int));
  72 typedef int (*trio_instream_t) TRIO_PROTO((trio_pointer_t));
  73
  74 TRIO_CONST char *trio_strerror TRIO_PROTO((int));
  75
  76 /*************************************************************************
  77  * Print Functions
  78  */
  79
  80 int trio_printf TRIO_PROTO((TRIO_CONST char *format, ...));
  81 int trio_vprintf TRIO_PROTO((TRIO_CONST char *format, va_list args));
  82 int trio_printfv TRIO_PROTO((TRIO_CONST char *format, void **args));
  83
  84 int trio_fprintf TRIO_PROTO((FILE *file, TRIO_CONST char *format, ...));
  85 int trio_vfprintf TRIO_PROTO((FILE *file, TRIO_CONST char *format, va_list args));
  86 int trio_fprintfv TRIO_PROTO((FILE *file, TRIO_CONST char *format, void **args));
  87
  88 int trio_dprintf TRIO_PROTO((int fd, TRIO_CONST char *format, ...));
  89 int trio_vdprintf TRIO_PROTO((int fd, TRIO_CONST char *format, va_list args));
  90 int trio_dprintfv TRIO_PROTO((int fd, TRIO_CONST char *format, void **args));
  91
  92 int trio_cprintf TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
  93                              TRIO_CONST char *format, ...));
  94 int trio_vcprintf TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
  95                               TRIO_CONST char *format, va_list args));
  96 int trio_cprintfv TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
  97                               TRIO_CONST char *format, void **args));
  98
  99 int trio_sprintf TRIO_PROTO((char *buffer, TRIO_CONST char *format, ...));
 100 int trio_vsprintf TRIO_PROTO((char *buffer, TRIO_CONST char *format, va_list args));
 101 int trio_sprintfv TRIO_PROTO((char *buffer, TRIO_CONST char *format, void **args));
 102
 103 int trio_snprintf TRIO_PROTO((char *buffer, size_t max, TRIO_CONST char *format, ...));
 104 int trio_vsnprintf TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
 105                    va_list args));
 106 int trio_snprintfv TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
 107                    void **args));
 108
 109 int trio_snprintfcat TRIO_PROTO((char *buffer, size_t max, TRIO_CONST char *format, ...));
 110 int trio_vsnprintfcat TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
 111                       va_list args));
 112
 113 char *trio_aprintf TRIO_PROTO((TRIO_CONST char *format, ...));
 114 char *trio_vaprintf TRIO_PROTO((TRIO_CONST char *format, va_list args));
 115
 116 int trio_asprintf TRIO_PROTO((char **ret, TRIO_CONST char *format, ...));
 117 int trio_vasprintf TRIO_PROTO((char **ret, TRIO_CONST char *format, va_list args));
 118
 119 /*************************************************************************
 120  * Scan Functions
 121  */
 122 int trio_scanf TRIO_PROTO((TRIO_CONST char *format, ...));
 123 int trio_vscanf TRIO_PROTO((TRIO_CONST char *format, va_list args));
 124 int trio_scanfv TRIO_PROTO((TRIO_CONST char *format, void **args));
 125
 126 int trio_fscanf TRIO_PROTO((FILE *file, TRIO_CONST char *format, ...));
 127 int trio_vfscanf TRIO_PROTO((FILE *file, TRIO_CONST char *format, va_list args));
 128 int trio_fscanfv TRIO_PROTO((FILE *file, TRIO_CONST char *format, void **args));
 129
 130 int trio_dscanf TRIO_PROTO((int fd, TRIO_CONST char *format, ...));
 131 int trio_vdscanf TRIO_PROTO((int fd, TRIO_CONST char *format, va_list args));
 132 int trio_dscanfv TRIO_PROTO((int fd, TRIO_CONST char *format, void **args));
 133
 134 int trio_cscanf TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
 135                             TRIO_CONST char *format, ...));
 136 int trio_vcscanf TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
 137                              TRIO_CONST char *format, va_list args));
 138 int trio_cscanfv TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
 139                              TRIO_CONST char *format, void **args));
 140
 141 int trio_sscanf TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, ...));
 142 int trio_vsscanf TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, va_list args));
 143 int trio_sscanfv TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, void **args));
 144
 145 /*************************************************************************
 146  * Locale Functions
 147  */
 148 void trio_locale_set_decimal_point TRIO_PROTO((char *decimalPoint));
 149 void trio_locale_set_thousand_separator TRIO_PROTO((char *thousandSeparator));
 150 void trio_locale_set_grouping TRIO_PROTO((char *grouping));
 151
 152 /*************************************************************************
 153  * Renaming
 154  */
 155 #ifdef TRIO_REPLACE_STDIO
 156 /* Replace the <stdio.h> functions */
 157 #ifndef HAVE_PRINTF
 158 # undef printf
 159 # define printf trio_printf
 160 #endif
 161 #ifndef HAVE_VPRINTF
 162 # undef vprintf
 163 # define vprintf trio_vprintf
 164 #endif
 165 #ifndef HAVE_FPRINTF
 166 # undef fprintf
 167 # define fprintf trio_fprintf
 168 #endif
 169 #ifndef HAVE_VFPRINTF
 170 # undef vfprintf
 171 # define vfprintf trio_vfprintf
 172 #endif
 173 #ifndef HAVE_SPRINTF
 174 # undef sprintf
 175 # define sprintf trio_sprintf
 176 #endif
 177 #ifndef HAVE_VSPRINTF
 178 # undef vsprintf
 179 # define vsprintf trio_vsprintf
 180 #endif
 181 #ifndef HAVE_SNPRINTF
 182 # undef snprintf
 183 # define snprintf trio_snprintf
 184 #endif
 185 #ifndef HAVE_VSNPRINTF
 186 # undef vsnprintf
 187 # define vsnprintf trio_vsnprintf
 188 #endif
 189 #ifndef HAVE_SCANF
 190 # undef scanf
 191 # define scanf trio_scanf
 192 #endif
 193 #ifndef HAVE_VSCANF
 194 # undef vscanf
 195 # define vscanf trio_vscanf
 196 #endif
 197 #ifndef HAVE_FSCANF
 198 # undef fscanf
 199 # define fscanf trio_fscanf
 200 #endif
 201 #ifndef HAVE_VFSCANF
 202 # undef vfscanf
 203 # define vfscanf trio_vfscanf
 204 #endif
 205 #ifndef HAVE_SSCANF
 206 # undef sscanf
 207 # define sscanf trio_sscanf
 208 #endif
 209 #ifndef HAVE_VSSCANF
 210 # undef vsscanf
 211 # define vsscanf trio_vsscanf
 212 #endif
 213 /* These aren't stdio functions, but we make them look similar */
 214 #define dprintf trio_dprintf
 215 #define vdprintf trio_vdprintf
 216 #define aprintf trio_aprintf
 217 #define vaprintf trio_vaprintf
 218 #define asprintf trio_asprintf
 219 #define vasprintf trio_vasprintf
 220 #define dscanf trio_dscanf
 221 #define vdscanf trio_vdscanf
 222 #endif
 223
 224 #ifdef __cplusplus
 225 } /* extern "C" */
 226 #endif
 227
 228 #endif /* WITHOUT_TRIO */
 229
 230 #endif /* TRIO_TRIO_H */