mirror of
https://sourceware.org/git/glibc.git
synced 2024-12-11 18:43:32 +08:00
146 lines
5.0 KiB
C
146 lines
5.0 KiB
C
/* 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 '\0'-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 */
|