X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Fvalprint.h;h=e242134d85643747e4bad20897931812e7ab5f93;hb=301a9420d947da145884261ac31a7a52438c2894;hp=5bea657b2031e23a6f7fde98d645ea250d7aeeaa;hpb=72ec28b8afa357cdde70c612b4e0e9f37a34f8e4;p=deliverable%2Fbinutils-gdb.git

diff --git a/gdb/valprint.h b/gdb/valprint.h
index 5bea657b20..e242134d85 100644
--- a/gdb/valprint.h
+++ b/gdb/valprint.h
@@ -1,11 +1,12 @@
 /* Declarations for value printing routines for GDB, the GNU debugger.
-   Copyright 1986, 1988, 1989, 1991-1994, 2000 Free Software Foundation, Inc.
+
+   Copyright (C) 1986-2020 Free Software Foundation, Inc.
 
    This file is part of GDB.
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
-   the Free Software Foundation; either version 2 of the License, or
+   the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
@@ -14,44 +15,271 @@
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
-   along with this program; if not, write to the Free Software
-   Foundation, Inc., 59 Temple Place - Suite 330,
-   Boston, MA 02111-1307, USA.  */
+   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
+
+#ifndef VALPRINT_H
+#define VALPRINT_H
+
+#include "cli/cli-option.h"
+
+/* This is used to pass formatting options to various value-printing
+   functions.  */
+struct value_print_options
+{
+  /* Pretty-formatting control.  */
+  enum val_prettyformat prettyformat;
+
+  /* Controls pretty formatting of arrays.  */
+  bool prettyformat_arrays;
+
+  /* Controls pretty formatting of structures.  */
+  bool prettyformat_structs;
+
+  /* Controls printing of virtual tables.  */
+  bool vtblprint;
+
+  /* Controls printing of nested unions.  */
+  bool unionprint;
+
+  /* Controls printing of addresses.  */
+  bool addressprint;
+
+  /* Controls looking up an object's derived type using what we find
+     in its vtables.  */
+  bool objectprint;
+
+  /* Maximum number of chars to print for a string pointer value or vector
+     contents, or UINT_MAX for no limit.  Note that "set print elements 0"
+     stores UINT_MAX in print_max, which displays in a show command as
+     "unlimited".  */
+  unsigned int print_max;
+
+  /* Print repeat counts if there are more than this many repetitions
+     of an element in an array.  */
+  unsigned int repeat_count_threshold;
+
+  /* The global output format letter.  */
+  int output_format;
+
+  /* The current format letter.  This is set locally for a given call,
+     e.g. when the user passes a format to "print".  */
+  int format;
+
+  /* Stop printing at null character?  */
+  bool stop_print_at_null;
+
+  /* True if we should print the index of each element when printing
+     an array.  */
+  bool print_array_indexes;
+
+  /* If true, then dereference references, otherwise just print
+     them like pointers.  */
+  bool deref_ref;
+
+  /* If true, print static fields.  */
+  bool static_field_print;
+
+  /* If true, print static fields for Pascal.  FIXME: C++ has a
+     flag, why not share with Pascal too?  */
+  bool pascal_static_field_print;
+
+  /* If true, don't do Python pretty-printing.  */
+  bool raw;
+
+  /* If true, print the value in "summary" form.
+     If raw and summary are both true, don't print non-scalar values
+     ("..." is printed instead).  */
+  bool summary;
+
+  /* If true, when printing a pointer, print the symbol to which it
+     points, if any.  */
+  bool symbol_print;
+
+  /* Maximum print depth when printing nested aggregates.  */
+  int max_depth;
+
+  /* Whether "finish" should print the value.  */
+  bool finish_print;
+};
+
+/* Create an option_def_group for the value_print options, with OPTS
+   as context.  */
+extern gdb::option::option_def_group make_value_print_options_def_group
+  (value_print_options *opts);
+
+/* The global print options set by the user.  In general this should
+   not be directly accessed, except by set/show commands.  Ordinary
+   code should call get_user_print_options instead.  */
+extern struct value_print_options user_print_options;
+
+/* Initialize *OPTS to be a copy of the user print options.  */
+extern void get_user_print_options (struct value_print_options *opts);
+
+/* Initialize *OPTS to be a copy of the user print options, but with
+   pretty-formatting disabled.  */
+extern void get_no_prettyformat_print_options (struct value_print_options *);
+
+/* Initialize *OPTS to be a copy of the user print options, but using
+   FORMAT as the formatting option.  */
+extern void get_formatted_print_options (struct value_print_options *opts,
+					 char format);
+
+extern void maybe_print_array_index (struct type *index_type, LONGEST index,
+                                     struct ui_file *stream,
+				     const struct value_print_options *);
+
+extern void val_print_array_elements (struct type *, LONGEST,
+				      CORE_ADDR, struct ui_file *, int,
+				      struct value *,
+				      const struct value_print_options *,
+				      unsigned int);
+
+extern void val_print_scalar_formatted (struct type *,
+					LONGEST,
+					struct value *,
+					const struct value_print_options *,
+					int,
+					struct ui_file *);
+
+extern void print_binary_chars (struct ui_file *, const gdb_byte *,
+				unsigned int, enum bfd_endian, bool);
+
+extern void print_octal_chars (struct ui_file *, const gdb_byte *,
+			       unsigned int, enum bfd_endian);
+
+extern void print_decimal_chars (struct ui_file *, const gdb_byte *,
+				 unsigned int, bool, enum bfd_endian);
+
+extern void print_hex_chars (struct ui_file *, const gdb_byte *,
+			     unsigned int, enum bfd_endian, bool);
+
+extern void print_char_chars (struct ui_file *, struct type *,
+			      const gdb_byte *, unsigned int, enum bfd_endian);
+
+extern void print_function_pointer_address (const struct value_print_options *options,
+					    struct gdbarch *gdbarch,
+					    CORE_ADDR address,
+					    struct ui_file *stream);
+
+extern int read_string (CORE_ADDR addr, int len, int width,
+			unsigned int fetchlimit,
+			enum bfd_endian byte_order,
+			gdb::unique_xmalloc_ptr<gdb_byte> *buffer,
+			int *bytes_read);
+
+extern void val_print_optimized_out (const struct value *val,
+				     struct ui_file *stream);
+
+/* Prints "<not saved>" to STREAM.  */
+extern void val_print_not_saved (struct ui_file *stream);
+
+extern void val_print_unavailable (struct ui_file *stream);
+
+extern void val_print_invalid_address (struct ui_file *stream);
+
+/* An instance of this is passed to generic_val_print and describes
+   some language-specific ways to print things.  */
+
+struct generic_val_print_decorations
+{
+  /* Printing complex numbers: what to print before, between the
+     elements, and after.  */
+
+  const char *complex_prefix;
+  const char *complex_infix;
+  const char *complex_suffix;
+
+  /* Boolean true and false.  */
+
+  const char *true_name;
+  const char *false_name;
+
+  /* What to print when we see TYPE_CODE_VOID.  */
+
+  const char *void_name;
+
+  /* Array start and end strings.  */
+  const char *array_start;
+  const char *array_end;
+};
+
+
+extern void generic_val_print (struct type *type,
+			       int embedded_offset, CORE_ADDR address,
+			       struct ui_file *stream, int recurse,
+			       struct value *original_value,
+			       const struct value_print_options *options,
+			       const struct generic_val_print_decorations *);
+
+extern void generic_emit_char (int c, struct type *type, struct ui_file *stream,
+			       int quoter, const char *encoding);
+
+extern void generic_printstr (struct ui_file *stream, struct type *type, 
+			      const gdb_byte *string, unsigned int length, 
+			      const char *encoding, int force_ellipses,
+			      int quote_char, int c_style_terminator,
+			      const struct value_print_options *options);
+
+/* Run the "output" command.  ARGS and FROM_TTY are the usual
+   arguments passed to all command implementations, except ARGS is
+   const.  */
 
+extern void output_command (const char *args, int from_tty);
 
-extern int prettyprint_arrays;	/* Controls pretty printing of arrays.  */
-extern int prettyprint_structs;	/* Controls pretty printing of structures */
-extern int prettyprint_arrays;	/* Controls pretty printing of arrays.  */
+extern int val_print_scalar_type_p (struct type *type);
 
-extern int vtblprint;		/* Controls printing of vtbl's */
-extern int unionprint;		/* Controls printing of nested unions.  */
-extern int addressprint;	/* Controls pretty printing of addresses.  */
-extern int objectprint;		/* Controls looking up an object's derived type
-				   using what we find in its vtables.  */
+struct format_data
+  {
+    int count;
+    char format;
+    char size;
 
-extern unsigned int print_max;	/* Max # of chars for strings/vectors */
+    /* True if the value should be printed raw -- that is, bypassing
+       python-based formatters.  */
+    unsigned char raw;
+  };
 
-/* Print repeat counts if there are more than this many repetitions of an
-   element in an array.  Referenced by the low level language dependent
-   print routines. */
-extern unsigned int repeat_count_threshold;
+extern void print_command_parse_format (const char **expp, const char *cmdname,
+					value_print_options *opts);
 
-extern int output_format;
+/* Print VAL to console according to OPTS, including recording it to
+   the history.  */
+extern void print_value (value *val, const value_print_options &opts);
 
-extern int stop_print_at_null;	/* Stop printing at null char? */
+/* Completer for the "print", "call", and "compile print"
+   commands.  */
+extern void print_command_completer (struct cmd_list_element *ignore,
+				     completion_tracker &tracker,
+				     const char *text, const char *word);
 
-extern void val_print_array_elements (struct type *, char *, CORE_ADDR,
-				      struct ui_file *, int, int, int,
-				      enum val_prettyprint, unsigned int);
+/* Given an address ADDR return all the elements needed to print the
+   address in a symbolic form.  NAME can be mangled or not depending
+   on DO_DEMANGLE (and also on the asm_demangle global variable,
+   manipulated via ''set print asm-demangle'').  When
+   PREFER_SYM_OVER_MINSYM is true, names (and offsets) from minimal
+   symbols won't be used except in instances where no symbol was
+   found; otherwise, a minsym might be used in some instances (mostly
+   involving function with non-contiguous address ranges).  Return
+   0 in case of success, when all the info in the OUT parameters is
+   valid.  Return 1 otherwise.  */
 
-extern void val_print_type_code_int (struct type *, char *,
-				     struct ui_file *);
+extern int build_address_symbolic (struct gdbarch *,
+				   CORE_ADDR addr,
+				   bool do_demangle,
+				   bool prefer_sym_over_minsym,
+				   std::string *name,
+				   int *offset,
+				   std::string *filename,
+				   int *line,
+				   int *unmapped);
 
-extern void print_binary_chars (struct ui_file *, unsigned char *,
-				unsigned int);
+/* Check to see if RECURSE is greater than or equal to the allowed
+   printing max-depth (see 'set print max-depth').  If it is then print an
+   ellipsis expression to STREAM and return true, otherwise return false.
+   LANGUAGE determines what type of ellipsis expression is printed.  */
 
-extern void print_octal_chars (struct ui_file *, unsigned char *,
-			       unsigned int);
+extern bool val_print_check_max_depth (struct ui_file *stream, int recurse,
+				       const struct value_print_options *opts,
+				       const struct language_defn *language);
 
-extern void print_decimal_chars (struct ui_file *, unsigned char *,
-				 unsigned int);
+#endif