Update NOTES.opensolaris with scheduling details
[kopensolaris-gnu/glibc.git] / stdio-common / printf.h
index 6e90154..360cdcc 100644 (file)
@@ -1,20 +1,21 @@
-/* Copyright (C) 1991, 92, 93, 95, 96 Free Software Foundation, Inc.
-This file is part of the GNU C Library.
+/* Copyright (C) 1991-1993,1995-1999,2000,2001,2006
+       Free Software Foundation, Inc.
+   This file is part of the GNU C Library.
 
-The GNU C Library is free software; you can redistribute it and/or
-modify it under the terms of the GNU Library General Public License as
-published by the Free Software Foundation; either version 2 of the
-License, or (at your option) any later version.
+   The GNU C Library is free software; you can redistribute it and/or
+   modify it under the terms of the GNU Lesser General Public
+   License as published by the Free Software Foundation; either
+   version 2.1 of the License, or (at your option) any later version.
 
-The GNU C Library is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-Library General Public License for more details.
+   The GNU C Library is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+   Lesser General Public License for more details.
 
-You should have received a copy of the GNU Library General Public
-License along with the GNU C Library; see the file COPYING.LIB.  If
-not, write to the, 1992 Free Software Foundation, Inc., 675 Mass Ave,
-Cambridge, MA 02139, USA.  */
+   You should have received a copy of the GNU Lesser General Public
+   License along with the GNU C Library; if not, write to the Free
+   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
+   02111-1307 USA.  */
 
 #ifndef        _PRINTF_H
 
@@ -34,11 +35,7 @@ struct printf_info
 {
   int prec;                    /* Precision.  */
   int width;                   /* Width.  */
-#ifdef THIS_IS_INCOMPATIBLE_WITH_LINUX_LIBC
   wchar_t spec;                        /* Format letter.  */
-#else
-  char spec;                   /* Format letter.  */
-#endif
   unsigned int is_long_double:1;/* L flag.  */
   unsigned int is_short:1;     /* h flag.  */
   unsigned int is_long:1;      /* l flag.  */
@@ -47,7 +44,11 @@ struct printf_info
   unsigned int left:1;         /* - flag.  */
   unsigned int showsign:1;     /* + flag.  */
   unsigned int group:1;                /* ' flag.  */
-  char pad;                    /* Padding character.  */
+  unsigned int extra:1;                /* For special use.  */
+  unsigned int is_char:1;      /* hh flag.  */
+  unsigned int wide:1;         /* Nonzero for wide character streams.  */
+  unsigned int i18n:1;         /* I flag.  */
+  wchar_t pad;                 /* Padding character.  */
 };
 
 
@@ -61,26 +62,24 @@ struct printf_info
    The function should return the number of characters written,
    or -1 for errors.  */
 
-typedef int printf_function __P ((FILE *__stream,
-                                 __const struct printf_info *__info,
-                                 __const void *__const *__args));
+typedef int printf_function (FILE *__stream,
+                            __const struct printf_info *__info,
+                            __const void *__const *__args);
 
 /* Type of a printf specifier-arginfo function.
    INFO gives information about the format specification.
-   N, ARGTYPES, and return value are as for printf_parse_format.  */
+   N, ARGTYPES, and return value are as for parse_printf_format.  */
 
-typedef int printf_arginfo_function __P ((__const struct printf_info * __info,
-                                         size_t __n,
-                                         int *__argtypes));
+typedef int printf_arginfo_function (__const struct printf_info *__info,
+                                    size_t __n, int *__argtypes);
 
 
 /* Register FUNC to be called to format SPEC specifiers; ARGINFO must be
    specified to determine how many arguments a SPEC conversion requires and
-   what their types are, even if your program never calls
-   `parse_printf_format'.  */
+   what their types are.  */
 
-extern int register_printf_function __P ((int __spec, printf_function __func,
-                                         printf_arginfo_function __arginfo));
+extern int register_printf_function (int __spec, printf_function __func,
+                                    printf_arginfo_function __arginfo);
 
 
 /* Parse FMT, and fill in N elements of ARGTYPES with the
@@ -94,9 +93,8 @@ extern int register_printf_function __P ((int __spec, printf_function __func,
    array it is passed with the types of the arguments it wants, and return
    the number of arguments it wants.  */
 
-extern size_t parse_printf_format __P ((__const char *__fmt,
-                                       size_t __n,
-                                       int *__argtypes));
+extern size_t parse_printf_format (__const char *__restrict __fmt, size_t __n,
+                                  int *__restrict __argtypes) __THROW;
 
 
 /* Codes returned by `parse_printf_format' for basic types.
@@ -108,7 +106,9 @@ enum
 {                              /* C type: */
   PA_INT,                      /* int */
   PA_CHAR,                     /* int, cast to char */
+  PA_WCHAR,                    /* wide char */
   PA_STRING,                   /* const char *, a '\0'-terminated string */
+  PA_WSTRING,                  /* const wchar_t *, wide character string */
   PA_POINTER,                  /* void * */
   PA_FLOAT,                    /* float */
   PA_DOUBLE,                   /* double */
@@ -124,6 +124,26 @@ enum
 #define        PA_FLAG_PTR             (1 << 11)
 
 
+
+/* Function which can be registered as `printf'-handlers.  */
+
+/* Print floating point value using using abbreviations for the orders
+   of magnitude used for numbers ('k' for kilo, 'm' for mega etc).  If
+   the format specifier is a uppercase character powers of 1000 are
+   used.  Otherwise powers of 1024.  */
+extern int printf_size (FILE *__restrict __fp,
+                       __const struct printf_info *__info,
+                       __const void *__const *__restrict __args) __THROW;
+
+/* This is the appropriate argument information function for `printf_size'.  */
+extern int printf_size_info (__const struct printf_info *__restrict
+                            __info, size_t __n, int *__restrict __argtypes)
+     __THROW;
+
+#ifdef __LDBL_COMPAT
+# include <bits/printf-ldbl.h>
+#endif
+
 __END_DECLS
 
 #endif /* printf.h  */