home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / gettext-0.10.24-src.tgz / tar.out / fsf / gettext / lib / printf.h < prev    next >
C/C++ Source or Header  |  1996-09-28  |  3KB  |  109 lines
  1. /*  Copyright (C) 1991, 1992, 1993, 1995 Free Software Foundation, Inc.
  2.  
  3. This program is free software; you can redistribute it and/or modify
  4. it under the terms of the GNU General Public License as published by
  5. the Free Software Foundation; either version 2, or (at your option)
  6. any later version.
  7.  
  8. This program is distributed in the hope that it will be useful,
  9. but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11. GNU General Public License for more details.
  12.  
  13. You should have received a copy of the GNU General Public License
  14. along with this program; if not, write to the Free Software
  15. Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  16.  
  17. #ifndef    _PRINTF_H
  18.  
  19. #define    _PRINTF_H    1
  20.  
  21. #include <stdio.h>
  22. #include <sys/types.h>
  23.  
  24. #ifdef STDC_HEADERS
  25. # include <stddef.h>
  26. #endif
  27.  
  28. #ifndef PARAMS
  29. # if __STDC__
  30. #  define PARAMS(args) args
  31. # else
  32. #  define PARAMS(args) ()
  33. # endif
  34. #endif
  35.  
  36. struct printf_info
  37. {
  38.   int prec;            /* Precision.  */
  39.   int width;            /* Width.  */
  40.   char spec;            /* Format letter.  */
  41.   unsigned is_long_double:1;    /* L flag.  */
  42.   unsigned is_short:1;        /* h flag.  */
  43.   unsigned is_long:1;        /* l flag.  */
  44.   unsigned alt:1;        /* # flag.  */
  45.   unsigned space:1;        /* Space flag.  */
  46.   unsigned left:1;        /* - flag.  */
  47.   unsigned showsign:1;        /* + flag.  */
  48.   unsigned group:1;        /* ' flag.  */
  49.   char 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.    Arguments can be read from ARGS.
  57.    The function should return the number of characters written,
  58.    or -1 for errors.  */
  59.  
  60. typedef int (*printf_function) PARAMS ((FILE * __stream,
  61.                     const struct printf_info * __info,
  62.                     const void **const __args));
  63. typedef int (*printf_arginfo_function) PARAMS ((const struct printf_info
  64.                         *__info,
  65.                         size_t __n,
  66.                         int *__argtypes));
  67.  
  68. /* Parse FMT, and fill in N elements of ARGTYPES with the
  69.    types needed for the conversions FMT specifies.  Returns
  70.    the number of arguments required by FMT.
  71.  
  72.    The ARGINFO function registered with a user-defined format is passed a
  73.    `struct printf_info' describing the format spec being parsed.  A width
  74.    or precision of INT_MIN means a `*' was used to indicate that the
  75.    width/precision will come from an arg.  The function should fill in the
  76.    array it is passed with the types of the arguments it wants, and return
  77.    the number of arguments it wants.  */
  78.  
  79. extern size_t parse_printf_format PARAMS ((const char *__fmt,
  80.                        size_t __n,
  81.                        int *__argtypes));
  82.  
  83. /* Codes returned by `parse_printf_format' for basic types.
  84.  
  85.    These values cover all the standard format specifications.
  86.    Users can add new values after PA_LAST for their own types.  */
  87.  
  88. enum
  89. {                /* C type: */
  90.   PA_INT,            /* int */
  91.   PA_CHAR,            /* int, cast to char */
  92.   PA_STRING,            /* const char *, a '\0'-terminated string */
  93.   PA_POINTER,            /* void * */
  94.   PA_FLOAT,            /* float */
  95.   PA_DOUBLE,            /* double */
  96.   PA_LAST
  97. };
  98.  
  99. /* Flag bits that can be set in a type returned by `parse_printf_format'.  */
  100. #define    PA_FLAG_MASK        0xff00
  101. #define    PA_FLAG_LONG_LONG    (1 << 8)
  102. #define    PA_FLAG_LONG_DOUBLE    PA_FLAG_LONG_LONG
  103. #define    PA_FLAG_LONG        (1 << 9)
  104. #define    PA_FLAG_SHORT        (1 << 10)
  105. #define    PA_FLAG_PTR        (1 << 11)
  106.  
  107.  
  108. #endif /* printf.h  */
  109.