mdw@git.distorted.org.uk Git - disorder/blob - lib/printf.h

   1 /*
   2  * This file is part of DisOrder
   3  * Copyright (C) 2004, 2006-2008 Richard Kettlewell
   4  *
   5  * This program is free software: you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation, either version 3 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17  */
  18 /** @file lib/printf.h
  19  * @brief UTF-8 *printf workalikes
  20  */
  21 #ifndef PRINTF_H
  22 #define PRINTF_H
  23
  24 #include <stdarg.h>
  25
  26 struct sink;
  27
  28 int byte_vsinkprintf(struct sink *output,
  29                      const char *fmt,
  30                      va_list ap);
  31 int byte_sinkprintf(struct sink *output, const char *fmt, ...);
  32 /* partial printf implementation that takes ASCII format strings but
  33  * arbitrary byte strings as args to %s and friends.  Lots of bits are
  34  * missing! */
  35
  36 int byte_vsnprintf(char buffer[],
  37                    size_t bufsize,
  38                    const char *fmt,
  39                    va_list ap);
  40 int byte_snprintf(char buffer[],
  41                   size_t bufsize,
  42                   const char *fmt,
  43                   ...)
  44 #ifndef INHIBIT_PRINTF_FORMAT_CHECKING
  45   attribute((format (printf, 3, 4)))
  46 #endif
  47   ;
  48 /* analogues of [v]snprintf */
  49
  50 int byte_vasprintf(char **ptrp,
  51                    const char *fmt,
  52                    va_list ap);
  53 int byte_asprintf(char **ptrp,
  54                   const char *fmt,
  55                   ...)
  56 #ifndef INHIBIT_PRINTF_FORMAT_CHECKING
  57   attribute((format (printf, 2, 3)))
  58 #endif
  59   ;
  60 /* analogues of [v]asprintf (uses xmalloc/xrealloc) */
  61
  62 int byte_xvasprintf(char **ptrp,
  63                     const char *fmt,
  64                     va_list ap);
  65 int byte_xasprintf(char **ptrp,
  66                    const char *fmt,
  67                    ...)
  68 #ifndef INHIBIT_PRINTF_FORMAT_CHECKING
  69   attribute((format (printf, 2, 3)))
  70 #endif
  71   ;
  72 /* same but terminate on error */
  73
  74 int byte_vfprintf(FILE *fp, const char *fmt, va_list ap);
  75 int byte_fprintf(FILE *fp, const char *fmt, ...)
  76 #ifndef INHIBIT_PRINTF_FORMAT_CHECKING
  77   attribute((format (printf, 2, 3)))
  78 #endif
  79   ;
  80 /* analogues of [v]fprintf */
  81
  82 #endif /* PRINTF_H */
  83
  84 /*
  85 Local Variables:
  86 c-basic-offset:2
  87 comment-column:40
  88 End:
  89 */