Update NOTES.opensolaris with scheduling details
[kopensolaris-gnu/glibc.git] / stdio-common / printf-parse.h
1 /* Internal header for parsing printf format strings.
2    Copyright (C) 1995-1999, 2000, 2002, 2003, 2007
3    Free Software Foundation, Inc.
4    This file is part of th GNU C Library.
5
6    The GNU C Library is free software; you can redistribute it and/or
7    modify it under the terms of the GNU Lesser General Public
8    License as published by the Free Software Foundation; either
9    version 2.1 of the License, or (at your option) any later version.
10
11    The GNU C Library is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14    Lesser General Public License for more details.
15
16    You should have received a copy of the GNU Lesser General Public
17    License along with the GNU C Library; if not, write to the Free
18    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
19    02111-1307 USA.  */
20
21 #include <printf.h>
22 #include <stdint.h>
23 #include <stddef.h>
24 #include <string.h>
25 #include <wchar.h>
26
27
28 struct printf_spec
29   {
30     /* Information parsed from the format spec.  */
31     struct printf_info info;
32
33     /* Pointers into the format string for the end of this format
34        spec and the next (or to the end of the string if no more).  */
35     const UCHAR_T *end_of_fmt, *next_fmt;
36
37     /* Position of arguments for precision and width, or -1 if `info' has
38        the constant value.  */
39     int prec_arg, width_arg;
40
41     int data_arg;               /* Position of data argument.  */
42     int data_arg_type;          /* Type of first argument.  */
43     /* Number of arguments consumed by this format specifier.  */
44     size_t ndata_args;
45   };
46
47
48 /* The various kinds off arguments that can be passed to printf.  */
49 union printf_arg
50   {
51     wchar_t pa_wchar;
52     int pa_int;
53     long int pa_long_int;
54     long long int pa_long_long_int;
55     unsigned int pa_u_int;
56     unsigned long int pa_u_long_int;
57     unsigned long long int pa_u_long_long_int;
58     double pa_double;
59     long double pa_long_double;
60     const char *pa_string;
61     const wchar_t *pa_wstring;
62     void *pa_pointer;
63   };
64
65
66 #ifndef DONT_NEED_READ_INT
67 /* Read a simple integer from a string and update the string pointer.
68    It is assumed that the first character is a digit.  */
69 static unsigned int
70 read_int (const UCHAR_T * *pstr)
71 {
72   unsigned int retval = **pstr - L_('0');
73
74   while (ISDIGIT (*++(*pstr)))
75     {
76       retval *= 10;
77       retval += **pstr - L_('0');
78     }
79
80   return retval;
81 }
82 #endif
83
84
85 /* These are defined in reg-printf.c.  */
86 extern printf_arginfo_function **__printf_arginfo_table attribute_hidden;
87 extern printf_function **__printf_function_table attribute_hidden;
88
89
90 /* Find the next spec in FORMAT, or the end of the string.  Returns
91    a pointer into FORMAT, to a '%' or a '\0'.  */
92 __extern_always_inline const unsigned char *
93 __find_specmb (const unsigned char *format)
94 {
95   return (const unsigned char *) __strchrnul ((const char *) format, '%');
96 }
97
98 __extern_always_inline const unsigned int *
99 __find_specwc (const unsigned int *format)
100 {
101   return (const unsigned int *) __wcschrnul ((const wchar_t *) format, L'%');
102 }
103
104
105 /* FORMAT must point to a '%' at the beginning of a spec.  Fills in *SPEC
106    with the parsed details.  POSN is the number of arguments already
107    consumed.  At most MAXTYPES - POSN types are filled in TYPES.  Return
108    the number of args consumed by this spec; *MAX_REF_ARG is updated so it
109    remains the highest argument index used.  */
110 extern size_t __parse_one_specmb (const unsigned char *format, size_t posn,
111                                   struct printf_spec *spec,
112                                   size_t *max_ref_arg) attribute_hidden;
113
114 extern size_t __parse_one_specwc (const unsigned int *format, size_t posn,
115                                   struct printf_spec *spec,
116                                   size_t *max_ref_arg) attribute_hidden;