stdio-common/printf.h

   1 /* Copyright (C) 1991,92,93,95,96,97,98,99 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3
   4    The GNU C Library is free software; you can redistribute it and/or
   5    modify it under the terms of the GNU Library General Public License as
   6    published by the Free Software Foundation; either version 2 of the
   7    License, or (at your option) any later version.
   8
   9    The GNU C Library 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 GNU
  12    Library General Public License for more details.
  13
  14    You should have received a copy of the GNU Library General Public
  15    License along with the GNU C Library; see the file COPYING.LIB.  If not,
  16    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17    Boston, MA 02111-1307, USA.  */
  18
  19 #ifndef _PRINTF_H
  20
  21 #define _PRINTF_H       1
  22 #include <features.h>
  23
  24 __BEGIN_DECLS
  25
  26 #define __need_FILE
  27 #include <stdio.h>
  28 #define __need_size_t
  29 #define __need_wchar_t
  30 #include <stddef.h>
  31
  32
  33 struct printf_info
  34 {
  35   int prec;                     /* Precision.  */
  36   int width;                    /* Width.  */
  37   wchar_t spec;                 /* Format letter.  */
  38   unsigned int is_long_double:1;/* L flag.  */
  39   unsigned int is_short:1;      /* h flag.  */
  40   unsigned int is_long:1;       /* l flag.  */
  41   unsigned int alt:1;           /* # flag.  */
  42   unsigned int space:1;         /* Space flag.  */
  43   unsigned int left:1;          /* - flag.  */
  44   unsigned int showsign:1;      /* + flag.  */
  45   unsigned int group:1;         /* ' flag.  */
  46   unsigned int extra:1;         /* For special use.  */
  47   unsigned int is_char:1;       /* hh flag.  */
  48   unsigned int wide:1;          /* Nonzero for wide character streams.  */
  49   wchar_t pad;                  /* Padding character.  */
  50 };
  51
  52
  53 /* Type of a printf specifier-handler function.
  54    STREAM is the FILE on which to write output.
  55    INFO gives information about the format specification.
  56    ARGS is a vector of pointers to the argument data;
  57    the number of pointers will be the number returned
  58    by the associated arginfo function for the same INFO.
  59
  60    The function should return the number of characters written,
  61    or -1 for errors.  */
  62
  63 typedef int printf_function (FILE *__stream,
  64                              __const struct printf_info *__info,
  65                              __const void *__const *__args);
  66
  67 /* Type of a printf specifier-arginfo function.
  68    INFO gives information about the format specification.
  69    N, ARGTYPES, and return value are as for printf_parse_format.  */
  70
  71 typedef int printf_arginfo_function (__const struct printf_info *__info,
  72                                      size_t __n, int *__argtypes);
  73
  74
  75 /* Register FUNC to be called to format SPEC specifiers; ARGINFO must be
  76    specified to determine how many arguments a SPEC conversion requires and
  77    what their types are.  */
  78
  79 extern int register_printf_function (int __spec, printf_function __func,
  80                                      printf_arginfo_function __arginfo);
  81
  82
  83 /* Parse FMT, and fill in N elements of ARGTYPES with the
  84    types needed for the conversions FMT specifies.  Returns
  85    the number of arguments required by FMT.
  86
  87    The ARGINFO function registered with a user-defined format is passed a
  88    `struct printf_info' describing the format spec being parsed.  A width
  89    or precision of INT_MIN means a `*' was used to indicate that the
  90    width/precision will come from an arg.  The function should fill in the
  91    array it is passed with the types of the arguments it wants, and return
  92    the number of arguments it wants.  */
  93
  94 extern size_t parse_printf_format (__const char *__restrict __fmt, size_t __n,
  95                                    int *__restrict __argtypes) __THROW;
  96
  97
  98 /* Codes returned by `parse_printf_format' for basic types.
  99
 100    These values cover all the standard format specifications.
 101    Users can add new values after PA_LAST for their own types.  */
 102
 103 enum
 104 {                               /* C type: */
 105   PA_INT,                       /* int */
 106   PA_CHAR,                      /* int, cast to char */
 107   PA_WCHAR,                     /* wide char */
 108   PA_STRING,                    /* const char *, a '\0'-terminated string */
 109   PA_WSTRING,                   /* const wchar_t *, wide character string */
 110   PA_POINTER,                   /* void * */
 111   PA_FLOAT,                     /* float */
 112   PA_DOUBLE,                    /* double */
 113   PA_LAST
 114 };
 115
 116 /* Flag bits that can be set in a type returned by `parse_printf_format'.  */
 117 #define PA_FLAG_MASK            0xff00
 118 #define PA_FLAG_LONG_LONG       (1 << 8)
 119 #define PA_FLAG_LONG_DOUBLE     PA_FLAG_LONG_LONG
 120 #define PA_FLAG_LONG            (1 << 9)
 121 #define PA_FLAG_SHORT           (1 << 10)
 122 #define PA_FLAG_PTR             (1 << 11)
 123
 124
 125
 126 /* Function which can be registered as `printf'-handlers.  */
 127
 128 /* Print floating point value using using abbreviations for the orders
 129    of magnitude used for numbers ('k' for kilo, 'm' for mega etc).  If
 130    the format specifier is a uppercase character powers of 1000 are
 131    used.  Otherwise powers of 1024.  */
 132 extern int printf_size (FILE *__restrict __fp,
 133                         __const struct printf_info *__info,
 134                         __const void *__const *__restrict __args) __THROW;
 135
 136 /* This is the appropriate argument information function for `printf_size'.  */
 137 extern int printf_size_info (__const struct printf_info *__restrict
 138                              __info, size_t __n, int *__restrict __argtypes)
 139      __THROW;
 140
 141
 142 __END_DECLS
 143
 144 #endif /* printf.h  */