Blame gnulib/lib/printf-parse.h

Packit 06dd63
/* Parse printf format string.
Packit 06dd63
   Copyright (C) 1999, 2002-2003, 2005, 2007, 2010-2019 Free Software
Packit 06dd63
   Foundation, Inc.
Packit 06dd63
Packit 06dd63
   This program is free software; you can redistribute it and/or modify
Packit 06dd63
   it under the terms of the GNU Lesser General Public License as published by
Packit 06dd63
   the Free Software Foundation; either version 2.1, or (at your option)
Packit 06dd63
   any later version.
Packit 06dd63
Packit 06dd63
   This program is distributed in the hope that it will be useful,
Packit 06dd63
   but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 06dd63
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit 06dd63
   GNU Lesser General Public License for more details.
Packit 06dd63
Packit 06dd63
   You should have received a copy of the GNU Lesser General Public License along
Packit 06dd63
   with this program; if not, see <https://www.gnu.org/licenses/>.  */
Packit 06dd63
Packit 06dd63
#ifndef _PRINTF_PARSE_H
Packit 06dd63
#define _PRINTF_PARSE_H
Packit 06dd63
Packit 06dd63
/* This file can be parametrized with the following macros:
Packit 06dd63
     ENABLE_UNISTDIO    Set to 1 to enable the unistdio extensions.
Packit 06dd63
     STATIC             Set to 'static' to declare the function static.  */
Packit 06dd63
Packit 06dd63
#if HAVE_FEATURES_H
Packit 06dd63
# include <features.h> /* for __GLIBC__, __UCLIBC__ */
Packit 06dd63
#endif
Packit 06dd63
Packit 06dd63
#include "printf-args.h"
Packit 06dd63
Packit 06dd63
Packit 06dd63
/* Flags */
Packit 06dd63
#define FLAG_GROUP       1      /* ' flag */
Packit 06dd63
#define FLAG_LEFT        2      /* - flag */
Packit 06dd63
#define FLAG_SHOWSIGN    4      /* + flag */
Packit 06dd63
#define FLAG_SPACE       8      /* space flag */
Packit 06dd63
#define FLAG_ALT        16      /* # flag */
Packit 06dd63
#define FLAG_ZERO       32
Packit 06dd63
#if __GLIBC__ >= 2 && !defined __UCLIBC__
Packit 06dd63
# define FLAG_LOCALIZED 64      /* I flag, uses localized digits */
Packit 06dd63
#endif
Packit 06dd63
Packit 06dd63
/* arg_index value indicating that no argument is consumed.  */
Packit 06dd63
#define ARG_NONE        (~(size_t)0)
Packit 06dd63
Packit 06dd63
/* xxx_directive: A parsed directive.
Packit 06dd63
   xxx_directives: A parsed format string.  */
Packit 06dd63
Packit 06dd63
/* Number of directly allocated directives (no malloc() needed).  */
Packit 06dd63
#define N_DIRECT_ALLOC_DIRECTIVES 7
Packit 06dd63
Packit 06dd63
/* A parsed directive.  */
Packit 06dd63
typedef struct
Packit 06dd63
{
Packit 06dd63
  const char* dir_start;
Packit 06dd63
  const char* dir_end;
Packit 06dd63
  int flags;
Packit 06dd63
  const char* width_start;
Packit 06dd63
  const char* width_end;
Packit 06dd63
  size_t width_arg_index;
Packit 06dd63
  const char* precision_start;
Packit 06dd63
  const char* precision_end;
Packit 06dd63
  size_t precision_arg_index;
Packit 06dd63
  char conversion; /* d i o u x X f F e E g G a A c s p n U % but not C S */
Packit 06dd63
  size_t arg_index;
Packit 06dd63
}
Packit 06dd63
char_directive;
Packit 06dd63
Packit 06dd63
/* A parsed format string.  */
Packit 06dd63
typedef struct
Packit 06dd63
{
Packit 06dd63
  size_t count;
Packit 06dd63
  char_directive *dir;
Packit 06dd63
  size_t max_width_length;
Packit 06dd63
  size_t max_precision_length;
Packit 06dd63
  char_directive direct_alloc_dir[N_DIRECT_ALLOC_DIRECTIVES];
Packit 06dd63
}
Packit 06dd63
char_directives;
Packit 06dd63
Packit 06dd63
#if ENABLE_UNISTDIO
Packit 06dd63
Packit 06dd63
/* A parsed directive.  */
Packit 06dd63
typedef struct
Packit 06dd63
{
Packit 06dd63
  const uint8_t* dir_start;
Packit 06dd63
  const uint8_t* dir_end;
Packit 06dd63
  int flags;
Packit 06dd63
  const uint8_t* width_start;
Packit 06dd63
  const uint8_t* width_end;
Packit 06dd63
  size_t width_arg_index;
Packit 06dd63
  const uint8_t* precision_start;
Packit 06dd63
  const uint8_t* precision_end;
Packit 06dd63
  size_t precision_arg_index;
Packit 06dd63
  uint8_t conversion; /* d i o u x X f F e E g G a A c s p n U % but not C S */
Packit 06dd63
  size_t arg_index;
Packit 06dd63
}
Packit 06dd63
u8_directive;
Packit 06dd63
Packit 06dd63
/* A parsed format string.  */
Packit 06dd63
typedef struct
Packit 06dd63
{
Packit 06dd63
  size_t count;
Packit 06dd63
  u8_directive *dir;
Packit 06dd63
  size_t max_width_length;
Packit 06dd63
  size_t max_precision_length;
Packit 06dd63
  u8_directive direct_alloc_dir[N_DIRECT_ALLOC_DIRECTIVES];
Packit 06dd63
}
Packit 06dd63
u8_directives;
Packit 06dd63
Packit 06dd63
/* A parsed directive.  */
Packit 06dd63
typedef struct
Packit 06dd63
{
Packit 06dd63
  const uint16_t* dir_start;
Packit 06dd63
  const uint16_t* dir_end;
Packit 06dd63
  int flags;
Packit 06dd63
  const uint16_t* width_start;
Packit 06dd63
  const uint16_t* width_end;
Packit 06dd63
  size_t width_arg_index;
Packit 06dd63
  const uint16_t* precision_start;
Packit 06dd63
  const uint16_t* precision_end;
Packit 06dd63
  size_t precision_arg_index;
Packit 06dd63
  uint16_t conversion; /* d i o u x X f F e E g G a A c s p n U % but not C S */
Packit 06dd63
  size_t arg_index;
Packit 06dd63
}
Packit 06dd63
u16_directive;
Packit 06dd63
Packit 06dd63
/* A parsed format string.  */
Packit 06dd63
typedef struct
Packit 06dd63
{
Packit 06dd63
  size_t count;
Packit 06dd63
  u16_directive *dir;
Packit 06dd63
  size_t max_width_length;
Packit 06dd63
  size_t max_precision_length;
Packit 06dd63
  u16_directive direct_alloc_dir[N_DIRECT_ALLOC_DIRECTIVES];
Packit 06dd63
}
Packit 06dd63
u16_directives;
Packit 06dd63
Packit 06dd63
/* A parsed directive.  */
Packit 06dd63
typedef struct
Packit 06dd63
{
Packit 06dd63
  const uint32_t* dir_start;
Packit 06dd63
  const uint32_t* dir_end;
Packit 06dd63
  int flags;
Packit 06dd63
  const uint32_t* width_start;
Packit 06dd63
  const uint32_t* width_end;
Packit 06dd63
  size_t width_arg_index;
Packit 06dd63
  const uint32_t* precision_start;
Packit 06dd63
  const uint32_t* precision_end;
Packit 06dd63
  size_t precision_arg_index;
Packit 06dd63
  uint32_t conversion; /* d i o u x X f F e E g G a A c s p n U % but not C S */
Packit 06dd63
  size_t arg_index;
Packit 06dd63
}
Packit 06dd63
u32_directive;
Packit 06dd63
Packit 06dd63
/* A parsed format string.  */
Packit 06dd63
typedef struct
Packit 06dd63
{
Packit 06dd63
  size_t count;
Packit 06dd63
  u32_directive *dir;
Packit 06dd63
  size_t max_width_length;
Packit 06dd63
  size_t max_precision_length;
Packit 06dd63
  u32_directive direct_alloc_dir[N_DIRECT_ALLOC_DIRECTIVES];
Packit 06dd63
}
Packit 06dd63
u32_directives;
Packit 06dd63
Packit 06dd63
#endif
Packit 06dd63
Packit 06dd63
Packit 06dd63
/* Parses the format string.  Fills in the number N of directives, and fills
Packit 06dd63
   in directives[0], ..., directives[N-1], and sets directives[N].dir_start
Packit 06dd63
   to the end of the format string.  Also fills in the arg_type fields of the
Packit 06dd63
   arguments and the needed count of arguments.  */
Packit 06dd63
#if ENABLE_UNISTDIO
Packit 06dd63
extern int
Packit 06dd63
       ulc_printf_parse (const char *format, char_directives *d, arguments *a);
Packit 06dd63
extern int
Packit 06dd63
       u8_printf_parse (const uint8_t *format, u8_directives *d, arguments *a);
Packit 06dd63
extern int
Packit 06dd63
       u16_printf_parse (const uint16_t *format, u16_directives *d,
Packit 06dd63
                         arguments *a);
Packit 06dd63
extern int
Packit 06dd63
       u32_printf_parse (const uint32_t *format, u32_directives *d,
Packit 06dd63
                         arguments *a);
Packit 06dd63
#else
Packit 06dd63
# ifdef STATIC
Packit 06dd63
STATIC
Packit 06dd63
# else
Packit 06dd63
extern
Packit 06dd63
# endif
Packit 06dd63
int printf_parse (const char *format, char_directives *d, arguments *a);
Packit 06dd63
#endif
Packit 06dd63
Packit 06dd63
#endif /* _PRINTF_PARSE_H */