Home | History | Annotate | Download | only in libxml2 
      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 */
    231