]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blobdiff - gdb/valprint.h
Update years in copyright notice for the GDB files.
[thirdparty/binutils-gdb.git] / gdb / valprint.h
index 5bea657b2031e23a6f7fde98d645ea250d7aeeaa..493f627b1420ccecbb533de77b63fd5faf480cd8 100644 (file)
@@ -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-2013 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,
    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
+
+/* This is used to pass formatting options to various value-printing
+   functions.  */
+struct value_print_options
+{
+  /* Pretty-printing control.  */
+  enum val_prettyprint pretty;
+
+  /* Controls pretty printing of arrays.  */
+  int prettyprint_arrays;
+
+  /* Controls pretty printing of structures.  */
+  int prettyprint_structs;
+
+  /* Controls printing of virtual tables.  */
+  int vtblprint;
+
+  /* Controls printing of nested unions.  */
+  int unionprint;
+
+  /* Controls printing of addresses.  */
+  int addressprint;
+
+  /* Controls looking up an object's derived type using what we find
+     in its vtables.  */
+  int 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;
 
-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.  */
+  /* The current format letter.  This is set locally for a given call,
+     e.g. when the user passes a format to "print".  */
+  int format;
 
-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.  */
+  /* Stop printing at null character?  */
+  int stop_print_at_null;
 
-extern unsigned int print_max; /* Max # of chars for strings/vectors */
+  /* True if this value is being printed in an epoch window.  */
+  int inspect_it;
 
-/* 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;
+  /* True if we should print the index of each element when printing
+     an array.  */
+  int print_array_indexes;
 
-extern int output_format;
+  /* If nonzero, then dereference references, otherwise just print
+     them like pointers.  */
+  int deref_ref;
 
-extern int stop_print_at_null; /* Stop printing at null char? */
+  /* If nonzero, print static fields.  */
+  int static_field_print;
 
-extern void val_print_array_elements (struct type *, char *, CORE_ADDR,
-                                     struct ui_file *, int, int, int,
-                                     enum val_prettyprint, unsigned int);
+  /* If nonzero, print static fields for Pascal.  FIXME: C++ and Java
+     share one flag, why not Pascal too?  */
+  int pascal_static_field_print;
 
-extern void val_print_type_code_int (struct type *, char *,
+  /* Controls Python pretty-printing.  */
+  int raw;
+
+  /* If nonzero, print the value in "summary" form.  */
+  int summary;
+
+  /* If nonzero, when printing a pointer, print the symbol to which it
+     points, if any.  */
+  int symbol_print;
+};
+
+/* 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-printing disabled.  */
+extern void get_raw_print_options (struct value_print_options *opts);
+
+/* 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 *, const gdb_byte *, int,
+                                     CORE_ADDR, struct ui_file *, int,
+                                     const struct value *,
+                                     const struct value_print_options *,
+                                     unsigned int);
+
+extern void val_print_type_code_int (struct type *, const gdb_byte *,
                                     struct ui_file *);
 
-extern void print_binary_chars (struct ui_file *, unsigned char *,
-                               unsigned int);
+extern void val_print_type_code_flags (struct type *type,
+                                      const gdb_byte *valaddr,
+                                      struct ui_file *stream);
+
+extern void val_print_scalar_formatted (struct type *,
+                                       const gdb_byte *, int,
+                                       const 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);
+
+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, enum bfd_endian);
+
+extern void print_hex_chars (struct ui_file *, const gdb_byte *,
+                            unsigned int, enum bfd_endian);
+
+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);
+
+int read_string (CORE_ADDR addr, int len, int width, unsigned int fetchlimit,
+                enum bfd_endian byte_order, gdb_byte **buffer,
+                int *bytes_read);
+
+extern void val_print_optimized_out (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;
+};
+
+
+extern void generic_val_print (struct type *type, const gdb_byte *valaddr,
+                              int embedded_offset, CORE_ADDR address,
+                              struct ui_file *stream, int recurse,
+                              const 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 print_octal_chars (struct ui_file *, unsigned char *,
-                              unsigned int);
+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);
 
-extern void print_decimal_chars (struct ui_file *, unsigned char *,
-                                unsigned int);
+#endif