lib/xprintf.h

   1 /* printf wrappers that fail immediately for non-file-related errors
   2    Copyright (C) 2007-2024 Free Software Foundation, Inc.
   3
   4    This program is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU General Public License as published by
   6    the Free Software Foundation, either version 3 of the License, or
   7    (at your option) any later version.
   8
   9    This program is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12    GNU General Public License for more details.
  13
  14    You should have received a copy of the GNU General Public License
  15    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  16
  17 #ifndef _XPRINTF_H
  18 #define _XPRINTF_H
  19
  20 /* This file uses _GL_ATTRIBUTE_FORMAT.  */
  21 #if !_GL_CONFIG_H_INCLUDED
  22  #error "Please include config.h first."
  23 #endif
  24
  25 #include <stdarg.h>
  26 #include <stdio.h>
  27
  28 #ifdef __cplusplus
  29 extern "C" {
  30 #endif
  31
  32
  33 extern int xprintf (char const *restrict format, ...)
  34 #if GNULIB_VPRINTF_POSIX
  35      _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 1, 2))
  36 #else
  37      _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM, 1, 2))
  38 #endif
  39      ;
  40
  41 extern int xvprintf (char const *restrict format, va_list args)
  42 #if GNULIB_VPRINTF_POSIX
  43      _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 1, 0))
  44 #else
  45      _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM, 1, 0))
  46 #endif
  47      ;
  48
  49 extern int xfprintf (FILE *restrict stream, char const *restrict format, ...)
  50 #if GNULIB_VFPRINTF_POSIX
  51      _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 2, 3))
  52 #else
  53      _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM, 2, 3))
  54 #endif
  55      ;
  56
  57 extern int xvfprintf (FILE *restrict stream, char const *restrict format,
  58                       va_list args)
  59 #if GNULIB_VFPRINTF_POSIX
  60      _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 2, 0))
  61 #else
  62      _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM, 2, 0))
  63 #endif
  64      ;
  65
  66
  67 #ifdef __cplusplus
  68 }
  69 #endif
  70
  71 #endif