contrib/bind-9.3/lib/isc/include/isc/print.h

   1 /*
   2  * Copyright (C) 2004, 2005  Internet Systems Consortium, Inc. ("ISC")
   3  * Copyright (C) 1999-2001, 2003  Internet Software Consortium.
   4  *
   5  * Permission to use, copy, modify, and distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  10  * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  11  * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  12  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  13  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  14  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  15  * PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 /* $Id: print.h,v 1.17.188.4 2005/06/09 23:54:30 marka Exp $ */
  19
  20 #ifndef ISC_PRINT_H
  21 #define ISC_PRINT_H 1
  22
  23 /***
  24  *** Imports
  25  ***/
  26
  27 #include <isc/formatcheck.h>    /* Required for ISC_FORMAT_PRINTF() macro. */
  28 #include <isc/lang.h>
  29 #include <isc/platform.h>
  30
  31 /*
  32  * This block allows lib/isc/print.c to be cleanly compiled even if
  33  * the platform does not need it.  The standard Makefile will still
  34  * not compile print.c or archive print.o, so this is just to make test
  35  * compilation ("make print.o") easier.
  36  */
  37 #if !defined(ISC_PLATFORM_NEEDVSNPRINTF) && defined(ISC__PRINT_SOURCE)
  38 #define ISC_PLATFORM_NEEDVSNPRINTF
  39 #endif
  40
  41 #if !defined(ISC_PLATFORM_NEEDSPRINTF) && defined(ISC__PRINT_SOURCE)
  42 #define ISC_PLATFORM_NEEDSPRINTF
  43 #endif
  44
  45 /***
  46  *** Macros
  47  ***/
  48 #define ISC_PRINT_QUADFORMAT ISC_PLATFORM_QUADFORMAT
  49
  50 /***
  51  *** Functions
  52  ***/
  53
  54 #ifdef ISC_PLATFORM_NEEDVSNPRINTF
  55 #include <stdarg.h>
  56 #include <stddef.h>
  57 #endif
  58 #ifdef ISC_PLATFORM_NEEDSPRINTF
  59 #include <stdio.h>
  60 #endif
  61
  62
  63 ISC_LANG_BEGINDECLS
  64
  65 #ifdef ISC_PLATFORM_NEEDVSNPRINTF
  66 int
  67 isc_print_vsnprintf(char *str, size_t size, const char *format, va_list ap)
  68      ISC_FORMAT_PRINTF(3, 0);
  69 #define vsnprintf isc_print_vsnprintf
  70
  71 int
  72 isc_print_snprintf(char *str, size_t size, const char *format, ...)
  73      ISC_FORMAT_PRINTF(3, 4);
  74 #define snprintf isc_print_snprintf
  75 #endif /* ISC_PLATFORM_NEEDVSNPRINTF */
  76
  77 #ifdef ISC_PLATFORM_NEEDSPRINTF
  78 int
  79 isc_print_sprintf(char *str, const char *format, ...) ISC_FORMAT_PRINTF(2, 3);
  80 #define sprintf isc_print_sprintf
  81 #endif
  82
  83 ISC_LANG_ENDDECLS
  84
  85 #endif /* ISC_PRINT_H */