printf.h 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247
  1. /* Copyright (C) 1991-1993,1995-1999,2000,2001 Free Software Foundation, Inc.
  2. This file is part of the GNU C Library.
  3. The GNU C Library is free software; you can redistribute it and/or
  4. modify it under the terms of the GNU Lesser General Public
  5. License as published by the Free Software Foundation; either
  6. version 2.1 of the License, or (at your option) any later version.
  7. The GNU C Library is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  10. Lesser General Public License for more details.
  11. You should have received a copy of the GNU Lesser General Public
  12. License along with the GNU C Library; if not, write to the Free
  13. Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  14. 02111-1307 USA. */
  15. /* March 11, 2001 Manuel Novoa III
  16. *
  17. * Modified as appropriate for my new stdio lib.
  18. */
  19. #ifndef _PRINTF_H
  20. #define _PRINTF_H 1
  21. #include <features.h>
  22. __BEGIN_DECLS
  23. #define __need_FILE
  24. #include <stdio.h>
  25. #define __need_size_t
  26. #define __need_wchar_t
  27. #include <stddef.h>
  28. /* WARNING -- This is definitely nonportable... but it seems to work
  29. * with gcc, which is currently the only "supported" compiler.
  30. * The library code uses bitmasks for space-efficiency (you can't
  31. * set/test multiple bitfields in one operation). Unfortunatly, we
  32. * need to support bitfields since that's what glibc uses. So, we take
  33. * advantage of how gcc lays out bitfields to create an appropriate
  34. * mapping. By defining __PRINTF_INFO_NO_BITFIELD we access the
  35. * bitfields using bitmasks in a single flag variable.
  36. *
  37. * WARNING -- This may very well fail if built with -fpack-struct!!!
  38. *
  39. * TODO -- Add a validation test.
  40. * TODO -- Add an option to build in a shim translation function if
  41. * the bitfield<->bitmask mapping fails.
  42. */
  43. /* #define __PRINTF_INFO_NO_BITFIELD */
  44. #include <endian.h>
  45. struct printf_info
  46. {
  47. int prec; /* Precision. */
  48. int width; /* Width. */
  49. #ifdef __STDIO_WIDE /* TODO: temporary fix for uClibc */
  50. wchar_t spec; /* Format letter. */
  51. #else
  52. int spec;
  53. #endif
  54. #ifndef __PRINTF_INFO_NO_BITFIELD
  55. #if __BYTE_ORDER == __LITTLE_ENDIAN
  56. unsigned int space:1; /* Space flag. */
  57. unsigned int showsign:1; /* + flag. */
  58. unsigned int extra:1; /* For special use. */
  59. unsigned int left:1; /* - flag. */
  60. unsigned int alt:1; /* # flag. */
  61. unsigned int group:1; /* ' flag. */
  62. unsigned int i18n:1; /* I flag. */
  63. unsigned int wide:1; /* Nonzero for wide character streams. */
  64. unsigned int is_char:1; /* hh flag. */
  65. unsigned int is_short:1; /* h flag. */
  66. unsigned int is_long:1; /* l flag. */
  67. unsigned int is_long_double:1;/* L flag. */
  68. #elif __BYTE_ORDER == __BIG_ENDIAN
  69. unsigned int __padding:20;/* non-gnu -- total of 32 bits on 32bit arch */
  70. unsigned int is_long_double:1;/* L flag. */
  71. unsigned int is_long:1; /* l flag. */
  72. unsigned int is_short:1; /* h flag. */
  73. unsigned int is_char:1; /* hh flag. */
  74. unsigned int wide:1; /* Nonzero for wide character streams. */
  75. unsigned int i18n:1; /* I flag. */
  76. unsigned int group:1; /* ' flag. */
  77. unsigned int alt:1; /* # flag. */
  78. unsigned int left:1; /* - flag. */
  79. unsigned int extra:1; /* For special use. */
  80. unsigned int showsign:1; /* + flag. */
  81. unsigned int space:1; /* Space flag. */
  82. #else
  83. #error unsupported byte order!
  84. #endif
  85. #define PRINT_INFO_FLAG_VAL(INFO_PTR,BITFIELD) (INFO_PTR)->BITFIELD
  86. #define PRINT_INFO_SET_FLAG(INFO_PTR,BITFIELD) (INFO_PTR)->BITFIELD = 1
  87. #define PRINT_INFO_CLR_FLAG(INFO_PTR,BITFIELD) (INFO_PTR)->BITFIELD = 0
  88. #define PRINT_INFO_SET_extra(INFO_PTR,VAL) (INFO_PTR)->extra = (VAL)
  89. #else /* __PRINTF_INFO_NO_BITFIELD */
  90. unsigned int _flags; /* non-gnu */
  91. #define __PRINT_INFO_FLAG_space (1<<0)
  92. #define __PRINT_INFO_FLAG_showsign (1<<1)
  93. #define __PRINT_INFO_FLAG_extra (1<<2)
  94. #define __PRINT_INFO_FLAG_left (1<<3)
  95. #define __PRINT_INFO_FLAG_alt (1<<4)
  96. #define __PRINT_INFO_FLAG_group (1<<5)
  97. #define __PRINT_INFO_FLAG_i18n (1<<6)
  98. #define __PRINT_INFO_FLAG_wide (1<<7)
  99. #define __PRINT_INFO_FLAG_is_char (1<<8)
  100. #define __PRINT_INFO_FLAG_is_short (1<<9)
  101. #define __PRINT_INFO_FLAG_is_long (1<<10)
  102. #define __PRINT_INFO_FLAG_is_long_double (1<<11)
  103. #if defined(__STDC__) && __STDC__
  104. #define PRINT_INFO_FLAG_VAL(INFO_PTR,BITFIELD) \
  105. ((INFO_PTR)->_flags & __PRINT_INFO_FLAG_##BITFIELD)
  106. #define PRINT_INFO_SET_FLAG(INFO_PTR,BITFIELD) \
  107. ((INFO_PTR)->_flags |= __PRINT_INFO_FLAG_##BITFIELD)
  108. #define PRINT_INFO_CLR_FLAG(INFO_PTR,BITFIELD) \
  109. ((INFO_PTR)->_flags &= ~__PRINT_INFO_FLAG_##BITFIELD)
  110. #else
  111. #define PRINT_INFO_FLAG_VAL(INFO_PTR,BITFIELD) \
  112. ((INFO_PTR)->_flags & __PRINT_INFO_FLAG_/**/BITFIELD)
  113. #define PRINT_INFO_SET_FLAG(INFO_PTR,BITFIELD) \
  114. ((INFO_PTR)->_flags |= __PRINT_INFO_FLAG_/**/BITFIELD)
  115. #define PRINT_INFO_CLR_FLAG(INFO_PTR,BITFIELD) \
  116. ((INFO_PTR)->_flags &= ~__PRINT_INFO_FLAG_/**/BITFIELD)
  117. #endif
  118. #define PRINT_INFO_SET_extra(INFO_PTR,VAL) \
  119. ((INFO_PTR)->_flags |= (((INFO_PTR)->_flags & ~1) | ((VAL) & 1)))
  120. #endif /* __PRINTF_INFO_NO_BITFIELD */
  121. #ifdef __STDIO_WIDE /* TODO: temporary fix for uClibc */
  122. wchar_t pad; /* Padding character. */
  123. #else
  124. int pad;
  125. #endif
  126. };
  127. /* Type of a printf specifier-handler function.
  128. STREAM is the FILE on which to write output.
  129. INFO gives information about the format specification.
  130. ARGS is a vector of pointers to the argument data;
  131. the number of pointers will be the number returned
  132. by the associated arginfo function for the same INFO.
  133. The function should return the number of characters written,
  134. or -1 for errors. */
  135. typedef int (*printf_function) (FILE *__stream,
  136. __const struct printf_info *__info,
  137. __const void *__const *__args);
  138. /* Type of a printf specifier-arginfo function.
  139. INFO gives information about the format specification.
  140. N, ARGTYPES, and return value are as for parse_printf_format. */
  141. typedef int printf_arginfo_function (__const struct printf_info *__info,
  142. size_t __n, int *__argtypes);
  143. /* Register FUNC to be called to format SPEC specifiers; ARGINFO must be
  144. specified to determine how many arguments a SPEC conversion requires and
  145. what their types are. */
  146. extern int register_printf_function (int __spec, printf_function __func,
  147. printf_arginfo_function __arginfo);
  148. /* Parse FMT, and fill in N elements of ARGTYPES with the
  149. types needed for the conversions FMT specifies. Returns
  150. the number of arguments required by FMT.
  151. The ARGINFO function registered with a user-defined format is passed a
  152. `struct printf_info' describing the format spec being parsed. A width
  153. or precision of INT_MIN means a `*' was used to indicate that the
  154. width/precision will come from an arg. The function should fill in the
  155. array it is passed with the types of the arguments it wants, and return
  156. the number of arguments it wants. */
  157. extern size_t parse_printf_format (__const char *__restrict __fmt, size_t __n,
  158. int *__restrict __argtypes) __THROW;
  159. /* Codes returned by `parse_printf_format' for basic types.
  160. These values cover all the standard format specifications.
  161. Users can add new values after PA_LAST for their own types. */
  162. /* WARNING -- The above is not entirely true, even for glibc.
  163. * As far as the library code is concerned, such args are treated
  164. * as 'your type' pointers if qualified by PA_FLAG_PTR. If they
  165. * aren't qualified as pointers, I _think_ glibc just ignores them
  166. * and carries on. I think it should be treated as an error. */
  167. enum
  168. { /* C type: */
  169. PA_INT, /* int */
  170. PA_CHAR, /* int, cast to char */
  171. PA_WCHAR, /* wide char */
  172. PA_STRING, /* const char *, a '\0'-terminated string */
  173. PA_WSTRING, /* const wchar_t *, wide character string */
  174. PA_POINTER, /* void * */
  175. PA_FLOAT, /* float */
  176. PA_DOUBLE, /* double */
  177. __PA_NOARG, /* non-glibc -- signals non-arg width or prec */
  178. PA_LAST
  179. };
  180. /* Flag bits that can be set in a type returned by `parse_printf_format'. */
  181. /* WARNING -- These differ in value from what glibc uses. */
  182. #define PA_FLAG_MASK (0xff00)
  183. #define __PA_FLAG_CHAR (0x0100) /* non-gnu -- to deal with hh */
  184. #define PA_FLAG_SHORT (0x0200)
  185. #define PA_FLAG_LONG (0x0400)
  186. #define PA_FLAG_LONG_LONG (0x0800)
  187. #define PA_FLAG_LONG_DOUBLE PA_FLAG_LONG_LONG
  188. #define PA_FLAG_PTR (0x1000) /* TODO -- make dynamic??? */
  189. #define __PA_INTMASK (0x0f00) /* non-gnu -- all int flags */
  190. /* Function which can be registered as `printf'-handlers. */
  191. /* Print floating point value using using abbreviations for the orders
  192. of magnitude used for numbers ('k' for kilo, 'm' for mega etc). If
  193. the format specifier is a uppercase character powers of 1000 are
  194. used. Otherwise powers of 1024. */
  195. extern int printf_size (FILE *__restrict __fp,
  196. __const struct printf_info *__info,
  197. __const void *__const *__restrict __args) __THROW;
  198. /* This is the appropriate argument information function for `printf_size'. */
  199. extern int printf_size_info (__const struct printf_info *__restrict
  200. __info, size_t __n, int *__restrict __argtypes)
  201. __THROW;
  202. __END_DECLS
  203. #endif /* printf.h */