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

   1 /*
   2  * Copyright (C) 2004-2007  Internet Systems Consortium, Inc. ("ISC")
   3  * Copyright (C) 1999-2001, 2003  Internet Software Consortium.
   4  *
   5  * Permission to use, copy, modify, and/or 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.26 2007/06/19 23:47:18 tbox Exp $ */
  19
  20 #ifndef ISC_PRINT_H
  21 #define ISC_PRINT_H 1
  22
  23 /*! \file isc/print.h */
  24
  25 /***
  26  *** Imports
  27  ***/
  28
  29 #include <isc/formatcheck.h>    /* Required for ISC_FORMAT_PRINTF() macro. */
  30 #include <isc/lang.h>
  31 #include <isc/platform.h>
  32
  33 /*!
  34  * This block allows lib/isc/print.c to be cleanly compiled even if
  35  * the platform does not need it.  The standard Makefile will still
  36  * not compile print.c or archive print.o, so this is just to make test
  37  * compilation ("make print.o") easier.
  38  */
  39 #if !defined(ISC_PLATFORM_NEEDVSNPRINTF) && defined(ISC__PRINT_SOURCE)
  40 #define ISC_PLATFORM_NEEDVSNPRINTF
  41 #endif
  42
  43 #if !defined(ISC_PLATFORM_NEEDSPRINTF) && defined(ISC__PRINT_SOURCE)
  44 #define ISC_PLATFORM_NEEDSPRINTF
  45 #endif
  46
  47 /***
  48  *** Macros
  49  ***/
  50 #define ISC_PRINT_QUADFORMAT ISC_PLATFORM_QUADFORMAT
  51
  52 /***
  53  *** Functions
  54  ***/
  55
  56 #ifdef ISC_PLATFORM_NEEDVSNPRINTF
  57 #include <stdarg.h>
  58 #include <stddef.h>
  59 #endif
  60 #ifdef ISC_PLATFORM_NEEDSPRINTF
  61 #include <stdio.h>
  62 #endif
  63
  64
  65 ISC_LANG_BEGINDECLS
  66
  67 #ifdef ISC_PLATFORM_NEEDVSNPRINTF
  68 int
  69 isc_print_vsnprintf(char *str, size_t size, const char *format, va_list ap)
  70      ISC_FORMAT_PRINTF(3, 0);
  71 #define vsnprintf isc_print_vsnprintf
  72
  73 int
  74 isc_print_snprintf(char *str, size_t size, const char *format, ...)
  75      ISC_FORMAT_PRINTF(3, 4);
  76 #define snprintf isc_print_snprintf
  77 #endif /* ISC_PLATFORM_NEEDVSNPRINTF */
  78
  79 #ifdef ISC_PLATFORM_NEEDSPRINTF
  80 int
  81 isc_print_sprintf(char *str, const char *format, ...) ISC_FORMAT_PRINTF(2, 3);
  82 #define sprintf isc_print_sprintf
  83 #endif
  84
  85 ISC_LANG_ENDDECLS
  86
  87 #endif /* ISC_PRINT_H */