/*************************************************************************
  *
  * $Id$
  *
  * Copyright (C) 1998 Bjorn Reese and Daniel Stenberg.
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
  * copyright notice and this permission notice appear in all copies.
  *
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  * MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND
  * CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER.
  *
  *************************************************************************
  *
  * http://ctrio.sourceforge.net/
  *
  ************************************************************************/
 
 #ifndef TRIO_TRIO_H
 #define TRIO_TRIO_H
 
 #if !defined(WITHOUT_TRIO)
 
 /*
  * Use autoconf defines if present. Packages using trio must define
  * HAVE_CONFIG_H as a compiler option themselves.
  */
 #if defined(TRIO_HAVE_CONFIG_H)
 # include "config.h"
 #endif
 
 #include "triodef.h"
 
 #include <stdio.h>
 #include <stdlib.h>
 #if defined(TRIO_COMPILER_ANCIENT)
 # include <varargs.h>
 #else
 # include <stdarg.h>
 #endif
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 /*
  * Error codes.
  *
  * Remember to add a textual description to trio_strerror.
  */
 enum {
   TRIO_EOF      = 1,
   TRIO_EINVAL   = 2,
   TRIO_ETOOMANY = 3,
   TRIO_EDBLREF  = 4,
   TRIO_EGAP     = 5,
   TRIO_ENOMEM   = 6,
   TRIO_ERANGE   = 7,
   TRIO_ERRNO    = 8,
   TRIO_ECUSTOM  = 9
 };
 
 /* Error macros */
 #define TRIO_ERROR_CODE(x) ((-(x)) & 0x00FF)
 #define TRIO_ERROR_POSITION(x) ((-(x)) >> 8)
 #define TRIO_ERROR_NAME(x) trio_strerror(x)
 
 typedef int (*trio_outstream_t) TRIO_PROTO((trio_pointer_t, int));
 typedef int (*trio_instream_t) TRIO_PROTO((trio_pointer_t));
 
 TRIO_CONST char *trio_strerror TRIO_PROTO((int));
 
 /*************************************************************************
  * Print Functions
  */
 
 int trio_printf TRIO_PROTO((TRIO_CONST char *format, ...));
 int trio_vprintf TRIO_PROTO((TRIO_CONST char *format, va_list args));
 int trio_printfv TRIO_PROTO((TRIO_CONST char *format, void **args));
 
 int trio_fprintf TRIO_PROTO((FILE *file, TRIO_CONST char *format, ...));
 int trio_vfprintf TRIO_PROTO((FILE *file, TRIO_CONST char *format, va_list args));
 int trio_fprintfv TRIO_PROTO((FILE *file, TRIO_CONST char *format, void **args));
 
 int trio_dprintf TRIO_PROTO((int fd, TRIO_CONST char *format, ...));
 int trio_vdprintf TRIO_PROTO((int fd, TRIO_CONST char *format, va_list args));
 int trio_dprintfv TRIO_PROTO((int fd, TRIO_CONST char *format, void **args));
 
 int trio_cprintf TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
 			     TRIO_CONST char *format, ...));
 int trio_vcprintf TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
 			      TRIO_CONST char *format, va_list args));
 int trio_cprintfv TRIO_PROTO((trio_outstream_t stream, trio_pointer_t closure,
 			      TRIO_CONST char *format, void **args));
 
 int trio_sprintf TRIO_PROTO((char *buffer, TRIO_CONST char *format, ...));
 int trio_vsprintf TRIO_PROTO((char *buffer, TRIO_CONST char *format, va_list args));
 int trio_sprintfv TRIO_PROTO((char *buffer, TRIO_CONST char *format, void **args));
 
 int trio_snprintf TRIO_PROTO((char *buffer, size_t max, TRIO_CONST char *format, ...));
 int trio_vsnprintf TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
 		   va_list args));
 int trio_snprintfv TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
 		   void **args));
 
 int trio_snprintfcat TRIO_PROTO((char *buffer, size_t max, TRIO_CONST char *format, ...));
 int trio_vsnprintfcat TRIO_PROTO((char *buffer, size_t bufferSize, TRIO_CONST char *format,
                       va_list args));
 
 char *trio_aprintf TRIO_PROTO((TRIO_CONST char *format, ...));
 char *trio_vaprintf TRIO_PROTO((TRIO_CONST char *format, va_list args));
 
 int trio_asprintf TRIO_PROTO((char **ret, TRIO_CONST char *format, ...));
 int trio_vasprintf TRIO_PROTO((char **ret, TRIO_CONST char *format, va_list args));
 
 /*************************************************************************
  * Scan Functions
  */
 int trio_scanf TRIO_PROTO((TRIO_CONST char *format, ...));
 int trio_vscanf TRIO_PROTO((TRIO_CONST char *format, va_list args));
 int trio_scanfv TRIO_PROTO((TRIO_CONST char *format, void **args));
 
 int trio_fscanf TRIO_PROTO((FILE *file, TRIO_CONST char *format, ...));
 int trio_vfscanf TRIO_PROTO((FILE *file, TRIO_CONST char *format, va_list args));
 int trio_fscanfv TRIO_PROTO((FILE *file, TRIO_CONST char *format, void **args));
 
 int trio_dscanf TRIO_PROTO((int fd, TRIO_CONST char *format, ...));
 int trio_vdscanf TRIO_PROTO((int fd, TRIO_CONST char *format, va_list args));
 int trio_dscanfv TRIO_PROTO((int fd, TRIO_CONST char *format, void **args));
 
 int trio_cscanf TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
 			    TRIO_CONST char *format, ...));
 int trio_vcscanf TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
 			     TRIO_CONST char *format, va_list args));
 int trio_cscanfv TRIO_PROTO((trio_instream_t stream, trio_pointer_t closure,
 			     TRIO_CONST char *format, void **args));
 
 int trio_sscanf TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, ...));
 int trio_vsscanf TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, va_list args));
 int trio_sscanfv TRIO_PROTO((TRIO_CONST char *buffer, TRIO_CONST char *format, void **args));
 
 /*************************************************************************
  * Locale Functions
  */
 void trio_locale_set_decimal_point TRIO_PROTO((char *decimalPoint));
 void trio_locale_set_thousand_separator TRIO_PROTO((char *thousandSeparator));
 void trio_locale_set_grouping TRIO_PROTO((char *grouping));
 
 /*************************************************************************
  * Renaming
  */
 #ifdef TRIO_REPLACE_STDIO
 /* Replace the <stdio.h> functions */
 #ifndef HAVE_PRINTF
 # undef printf
 # define printf trio_printf
 #endif
 #ifndef HAVE_VPRINTF
 # undef vprintf
 # define vprintf trio_vprintf
 #endif
 #ifndef HAVE_FPRINTF
 # undef fprintf
 # define fprintf trio_fprintf
 #endif
 #ifndef HAVE_VFPRINTF
 # undef vfprintf
 # define vfprintf trio_vfprintf
 #endif
 #ifndef HAVE_SPRINTF
 # undef sprintf
 # define sprintf trio_sprintf
 #endif
 #ifndef HAVE_VSPRINTF
 # undef vsprintf
 # define vsprintf trio_vsprintf
 #endif
 #ifndef HAVE_SNPRINTF
 # undef snprintf
 # define snprintf trio_snprintf
 #endif
 #ifndef HAVE_VSNPRINTF
 # undef vsnprintf
 # define vsnprintf trio_vsnprintf
 #endif
 #ifndef HAVE_SCANF
 # undef scanf
 # define scanf trio_scanf
 #endif
 #ifndef HAVE_VSCANF
 # undef vscanf
 # define vscanf trio_vscanf
 #endif
 #ifndef HAVE_FSCANF
 # undef fscanf
 # define fscanf trio_fscanf
 #endif
 #ifndef HAVE_VFSCANF
 # undef vfscanf
 # define vfscanf trio_vfscanf
 #endif
 #ifndef HAVE_SSCANF
 # undef sscanf
 # define sscanf trio_sscanf
 #endif
 #ifndef HAVE_VSSCANF
 # undef vsscanf
 # define vsscanf trio_vsscanf
 #endif
 /* These aren't stdio functions, but we make them look similar */
 #define dprintf trio_dprintf
 #define vdprintf trio_vdprintf
 #define aprintf trio_aprintf
 #define vaprintf trio_vaprintf
 #define asprintf trio_asprintf
 #define vasprintf trio_vasprintf
 #define dscanf trio_dscanf
 #define vdscanf trio_vdscanf
 #endif
 
 #ifdef __cplusplus
 } /* extern "C" */
 #endif
 
 #endif /* WITHOUT_TRIO */
 
 #endif /* TRIO_TRIO_H */