printf.h
上传用户:szlgq88
上传日期:2009-04-28
资源大小:48287k
文件大小:5k
- /* Copyright (C) 1991-1993,1995-1999,2000,2001 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 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
- Lesser General Public License for more details.
- 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
- #define _PRINTF_H 1
- #include <features.h>
- __BEGIN_DECLS
- #define __need_FILE
- #include <stdio.h>
- #define __need_size_t
- #define __need_wchar_t
- #include <stddef.h>
- struct printf_info
- {
- int prec; /* Precision. */
- int width; /* Width. */
- wchar_t spec; /* Format letter. */
- unsigned int is_long_double:1;/* L flag. */
- unsigned int is_short:1; /* h flag. */
- unsigned int is_long:1; /* l flag. */
- unsigned int alt:1; /* # flag. */
- unsigned int space:1; /* Space flag. */
- unsigned int left:1; /* - flag. */
- unsigned int showsign:1; /* + flag. */
- unsigned int group:1; /* ' flag. */
- 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. */
- };
- /* Type of a printf specifier-handler function.
- STREAM is the FILE on which to write output.
- INFO gives information about the format specification.
- ARGS is a vector of pointers to the argument data;
- the number of pointers will be the number returned
- by the associated arginfo function for the same INFO.
- The function should return the number of characters written,
- or -1 for errors. */
- 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 parse_printf_format. */
- 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. */
- 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
- types needed for the conversions FMT specifies. Returns
- the number of arguments required by FMT.
- The ARGINFO function registered with a user-defined format is passed a
- `struct printf_info' describing the format spec being parsed. A width
- or precision of INT_MIN means a `*' was used to indicate that the
- width/precision will come from an arg. The function should fill in the
- 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 (__const char *__restrict __fmt, size_t __n,
- int *__restrict __argtypes) __THROW;
- /* Codes returned by `parse_printf_format' for basic types.
- These values cover all the standard format specifications.
- Users can add new values after PA_LAST for their own types. */
- enum
- { /* C type: */
- PA_INT, /* int */
- PA_CHAR, /* int, cast to char */
- PA_WCHAR, /* wide char */
- PA_STRING, /* const char *, a ' '-terminated string */
- PA_WSTRING, /* const wchar_t *, wide character string */
- PA_POINTER, /* void * */
- PA_FLOAT, /* float */
- PA_DOUBLE, /* double */
- PA_LAST
- };
- /* Flag bits that can be set in a type returned by `parse_printf_format'. */
- #define PA_FLAG_MASK 0xff00
- #define PA_FLAG_LONG_LONG (1 << 8)
- #define PA_FLAG_LONG_DOUBLE PA_FLAG_LONG_LONG
- #define PA_FLAG_LONG (1 << 9)
- #define PA_FLAG_SHORT (1 << 10)
- #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;
- __END_DECLS
- #endif /* printf.h */