gdb/common/format.h - gdb

Data types defined

Macros defined

Source code

  1. /* Parse a printf-style format string.

  3.    Copyright (C) 1986-2015 Free Software Foundation, Inc.

  5.    This file is part of GDB.

  7.    This program is free software; you can redistribute it and/or modify
  8.    it under the terms of the GNU General Public License as published by
  9.    the Free Software Foundation; either version 3 of the License, or
  10.    (at your option) any later version.

  12.    This program is distributed in the hope that it will be useful,
  13.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15.    GNU General Public License for more details.

  17.    You should have received a copy of the GNU General Public License
  18.    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */

  20. #if defined(__MINGW32__) && !defined(PRINTF_HAS_LONG_LONG)
  21. ‌# define USE_PRINTF_I64 1
  22. ‌# define PRINTF_HAS_LONG_LONG
  23. #else
  24. ‌# define USE_PRINTF_I64 0
  25. #endif

  27. /* The argclass represents the general type of data that goes with a
  28.    format directive; int_arg for %d, long_arg for %l, and so forth.
  29.    Note that these primarily distinguish types by size and need for
  30.    special handling, so for instance %u and %x are (at present) also
  31.    classed as int_arg.  */

  33. ‌enum argclass
  34.   {
  35.     literal_piece,
  36.     int_arg, long_arg, long_long_arg, ptr_arg,
  37.     string_arg, wide_string_arg, wide_char_arg,
  38.     double_arg, long_double_arg, decfloat_arg
  39.   };

  41. /* A format piece is a section of the format string that may include a
  42.    single print directive somewhere in it, and the associated class
  43.    for the argument.  */

  45. ‌struct format_piece
  46. {
  47.   char *string;
  48.   enum argclass argclass;
  49. };

  51. /* Return an array of printf fragments found at the given string, and
  52.    rewrite ARG with a pointer to the end of the format string.  */

  54. extern struct format_piece *parse_format_string (const char **arg);

  56. /* Given a pointer to an array of format pieces, free any memory that
  57.    would have been allocated by parse_format_string.  */

  59. extern void free_format_pieces (struct format_piece *frags);

  61. /* Freeing, cast as a cleanup.  */

  63. extern void free_format_pieces_cleanup (void *);