* utils.c (prompt_for_continue): Annotate prompt.
[external/binutils.git] / gdb / cp-valprint.c
1 /* Support for printing C++ values for GDB, the GNU debugger.
2    Copyright 1986, 1988, 1989, 1991 Free Software Foundation, Inc.
3
4 This file is part of GDB.
5
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
19
20 #include "defs.h"
21 #include "obstack.h"
22 #include "symtab.h"
23 #include "gdbtypes.h"
24 #include "expression.h"
25 #include "value.h"
26 #include "command.h"
27 #include "gdbcmd.h"
28 #include "demangle.h"
29
30 int vtblprint;                  /* Controls printing of vtbl's */
31 int objectprint;                /* Controls looking up an object's derived type
32                                    using what we find in its vtables.  */
33 struct obstack dont_print_obstack;
34
35 static void
36 cplus_print_value PARAMS ((struct type *, char *, GDB_FILE *, int, int,
37                            enum val_prettyprint, struct type **));
38
39 /* BEGIN-FIXME:  Hooks into typeprint.c, find a better home for prototypes. */
40
41 extern void
42 c_type_print_base PARAMS ((struct type *, GDB_FILE *, int, int));
43
44 extern void
45 c_type_print_varspec_prefix PARAMS ((struct type *, GDB_FILE *, int, int));
46
47 extern void
48 cp_type_print_method_args PARAMS ((struct type **, char *, char *, int,
49                                    GDB_FILE *));
50
51 extern struct obstack dont_print_obstack;
52
53 /* END-FIXME */
54
55 void
56 cp_print_class_method (valaddr, type, stream)
57      char *valaddr;
58      struct type *type;
59      GDB_FILE *stream;
60 {
61   struct type *domain;
62   struct fn_field *f = NULL;
63   int j = 0;
64   int len2;
65   int offset;
66   char *kind = "";
67   CORE_ADDR addr;
68   struct symbol *sym;
69   unsigned len;
70   unsigned int i;
71
72   check_stub_type (TYPE_TARGET_TYPE (type));
73   domain = TYPE_DOMAIN_TYPE (TYPE_TARGET_TYPE (type));
74   if (domain == (struct type *)NULL)
75     {
76       fprintf_filtered (stream, "<unknown>");
77       return;
78     }
79   addr = unpack_pointer (lookup_pointer_type (builtin_type_void), valaddr);
80   if (METHOD_PTR_IS_VIRTUAL (addr))
81     {
82       offset = METHOD_PTR_TO_VOFFSET (addr);
83       len = TYPE_NFN_FIELDS (domain);
84       for (i = 0; i < len; i++)
85         {
86           f = TYPE_FN_FIELDLIST1 (domain, i);
87           len2 = TYPE_FN_FIELDLIST_LENGTH (domain, i);
88           
89           for (j = 0; j < len2; j++)
90             {
91               QUIT;
92               if (TYPE_FN_FIELD_VOFFSET (f, j) == offset)
93                 {
94                   kind = "virtual ";
95                   goto common;
96                 }
97             }
98         }
99     }
100   else
101     {
102       sym = find_pc_function (addr);
103       if (sym == 0)
104         {
105           error ("invalid pointer to member function");
106         }
107       len = TYPE_NFN_FIELDS (domain);
108       for (i = 0; i < len; i++)
109         {
110           f = TYPE_FN_FIELDLIST1 (domain, i);
111           len2 = TYPE_FN_FIELDLIST_LENGTH (domain, i);
112           
113           for (j = 0; j < len2; j++)
114             {
115               QUIT;
116               if (TYPE_FN_FIELD_STUB (f, j))
117                 check_stub_method (domain, i, j);
118               if (STREQ (SYMBOL_NAME (sym), TYPE_FN_FIELD_PHYSNAME (f, j)))
119                 {
120                   goto common;
121                 }
122             }
123         }
124     }
125   common:
126   if (i < len)
127     {
128       fprintf_filtered (stream, "&");
129       c_type_print_varspec_prefix (TYPE_FN_FIELD_TYPE (f, j), stream, 0, 0);
130       fprintf_unfiltered (stream, kind);
131       if (TYPE_FN_FIELD_PHYSNAME (f, j)[0] == '_'
132           && TYPE_FN_FIELD_PHYSNAME (f, j)[1] == CPLUS_MARKER)
133         {
134           cp_type_print_method_args (TYPE_FN_FIELD_ARGS (f, j) + 1, "~",
135                                      TYPE_FN_FIELDLIST_NAME (domain, i),
136                                      0, stream);
137         }
138       else
139         {
140           cp_type_print_method_args (TYPE_FN_FIELD_ARGS (f, j), "",
141                                      TYPE_FN_FIELDLIST_NAME (domain, i),
142                                      0, stream);
143         }
144     }
145   else
146     {
147       fprintf_filtered (stream, "(");
148       type_print (type, "", stream, -1);
149       fprintf_filtered (stream, ") %d", (int) addr >> 3);
150     }
151 }
152
153 /* Return truth value for assertion that TYPE is of the type
154    "pointer to virtual function".  */
155
156 int
157 cp_is_vtbl_ptr_type(type)
158      struct type *type;
159 {
160   char *typename = type_name_no_tag (type);
161   /* This was what it was for gcc 2.4.5 and earlier.  */
162   static const char vtbl_ptr_name_old[] =
163     { CPLUS_MARKER,'v','t','b','l','_','p','t','r','_','t','y','p','e', 0 };
164   /* It was changed to this after 2.4.5.  */
165   static const char vtbl_ptr_name[] =
166     { '_','_','v','t','b','l','_','p','t','r','_','t','y','p','e', 0 };
167
168   return (typename != NULL
169           && (STREQ (typename, vtbl_ptr_name)
170               || STREQ (typename, vtbl_ptr_name_old)));
171 }
172
173 /* Return truth value for the assertion that TYPE is of the type
174    "pointer to virtual function table".  */
175
176 int
177 cp_is_vtbl_member(type)
178      struct type *type;
179 {
180   if (TYPE_CODE (type) == TYPE_CODE_PTR)
181     type = TYPE_TARGET_TYPE (type);
182   else
183     return 0;
184
185   if (TYPE_CODE (type) == TYPE_CODE_ARRAY
186       && TYPE_CODE (TYPE_TARGET_TYPE (type)) == TYPE_CODE_STRUCT)
187     /* Virtual functions tables are full of pointers to virtual functions.  */
188     return cp_is_vtbl_ptr_type (TYPE_TARGET_TYPE (type));
189   return 0;
190 }
191
192 /* Mutually recursive subroutines of cplus_print_value and c_val_print to
193    print out a structure's fields: cp_print_value_fields and cplus_print_value.
194
195    TYPE, VALADDR, STREAM, RECURSE, and PRETTY have the
196    same meanings as in cplus_print_value and c_val_print.
197
198    DONT_PRINT is an array of baseclass types that we
199    should not print, or zero if called from top level.  */
200
201 void
202 cp_print_value_fields (type, valaddr, stream, format, recurse, pretty,
203                        dont_print)
204      struct type *type;
205      char *valaddr;
206      GDB_FILE *stream;
207      int format;
208      int recurse;
209      enum val_prettyprint pretty;
210      struct type **dont_print;
211 {
212   int i, len, n_baseclasses;
213
214   check_stub_type (type);
215
216   fprintf_filtered (stream, "{");
217   len = TYPE_NFIELDS (type);
218   n_baseclasses = TYPE_N_BASECLASSES (type);
219
220   /* Print out baseclasses such that we don't print
221      duplicates of virtual baseclasses.  */
222   if (n_baseclasses > 0)
223     cplus_print_value (type, valaddr, stream, format, recurse+1, pretty,
224                        dont_print);
225
226   if (!len && n_baseclasses == 1)
227     fprintf_filtered (stream, "<No data fields>");
228   else
229     {
230       extern int inspect_it;
231       int fields_seen = 0;
232
233       for (i = n_baseclasses; i < len; i++)
234         {
235           /* Check if static field */
236           if (TYPE_FIELD_STATIC (type, i))
237             continue;
238           if (fields_seen)
239             fprintf_filtered (stream, ", ");
240           else if (n_baseclasses > 0)
241             {
242               if (pretty)
243                 {
244                   fprintf_filtered (stream, "\n");
245                   print_spaces_filtered (2 + 2 * recurse, stream);
246                   fputs_filtered ("members of ", stream);
247                   fputs_filtered (type_name_no_tag (type), stream);
248                   fputs_filtered (": ", stream);
249                 }
250             }
251           fields_seen = 1;
252
253           if (pretty)
254             {
255               fprintf_filtered (stream, "\n");
256               print_spaces_filtered (2 + 2 * recurse, stream);
257             }
258           else 
259             {
260               wrap_here (n_spaces (2 + 2 * recurse));
261             }
262           if (inspect_it)
263             {
264               if (TYPE_CODE (TYPE_FIELD_TYPE (type, i)) == TYPE_CODE_PTR)
265                 fputs_filtered ("\"( ptr \"", stream);
266               else
267                 fputs_filtered ("\"( nodef \"", stream);
268               fprintf_symbol_filtered (stream, TYPE_FIELD_NAME (type, i),
269                                        language_cplus,
270                                        DMGL_PARAMS | DMGL_ANSI);
271               fputs_filtered ("\" \"", stream);
272               fprintf_symbol_filtered (stream, TYPE_FIELD_NAME (type, i),
273                                        language_cplus,
274                                        DMGL_PARAMS | DMGL_ANSI);
275               fputs_filtered ("\") \"", stream);
276             }
277           else
278             {
279               if (annotation_level > 1)
280                 {
281                   printf_filtered ("\n\032\032field-begin ");
282                   print_value_flags (TYPE_FIELD_TYPE (type, i));
283                   printf_filtered ("\n");
284                 }
285
286               fprintf_symbol_filtered (stream, TYPE_FIELD_NAME (type, i),
287                                        language_cplus,
288                                        DMGL_PARAMS | DMGL_ANSI);
289               if (annotation_level > 1)
290                 printf_filtered ("\n\032\032field-name-end\n");
291               fputs_filtered (" = ", stream);
292               if (annotation_level > 1)
293                 printf_filtered ("\n\032\032field-value\n");
294             }
295
296           if (TYPE_FIELD_PACKED (type, i))
297             {
298               value_ptr v;
299
300               /* Bitfields require special handling, especially due to byte
301                  order problems.  */
302               if (TYPE_FIELD_IGNORE (type, i))
303                 {
304                    fputs_filtered ("<optimized out or zero length>", stream);
305                 }
306               else
307                 {
308                    v = value_from_longest (TYPE_FIELD_TYPE (type, i),
309                                    unpack_field_as_long (type, valaddr, i));
310
311                    val_print (TYPE_FIELD_TYPE(type, i), VALUE_CONTENTS (v), 0,
312                               stream, format, 0, recurse + 1, pretty);
313                 }
314             }
315           else
316             {
317               if (TYPE_FIELD_IGNORE (type, i))
318                 {
319                    fputs_filtered ("<optimized out or zero length>", stream);
320                 }
321               else
322                 {
323                    val_print (TYPE_FIELD_TYPE (type, i), 
324                               valaddr + TYPE_FIELD_BITPOS (type, i) / 8,
325                               0, stream, format, 0, recurse + 1, pretty);
326                 }
327             }
328           if (annotation_level > 1)
329             printf_filtered ("\n\032\032field-end\n");
330         }
331
332       if (pretty)
333         {
334           fprintf_filtered (stream, "\n");
335           print_spaces_filtered (2 * recurse, stream);
336         }
337     }
338   fprintf_filtered (stream, "}");
339 }
340
341 /* Special val_print routine to avoid printing multiple copies of virtual
342    baseclasses.  */
343
344 static void
345 cplus_print_value (type, valaddr, stream, format, recurse, pretty, dont_print)
346      struct type *type;
347      char *valaddr;
348      GDB_FILE *stream;
349      int format;
350      int recurse;
351      enum val_prettyprint pretty;
352      struct type **dont_print;
353 {
354   struct obstack tmp_obstack;
355   struct type **last_dont_print
356     = (struct type **)obstack_next_free (&dont_print_obstack);
357   int i, n_baseclasses = TYPE_N_BASECLASSES (type);
358
359   if (dont_print == 0)
360     {
361       /* If we're at top level, carve out a completely fresh
362          chunk of the obstack and use that until this particular
363          invocation returns.  */
364       tmp_obstack = dont_print_obstack;
365       /* Bump up the high-water mark.  Now alpha is omega.  */
366       obstack_finish (&dont_print_obstack);
367     }
368
369   for (i = 0; i < n_baseclasses; i++)
370     {
371       /* FIXME-32x64--assumes that a target pointer can fit in a char *.
372          Fix it by nuking baseclass_addr.  */
373       char *baddr;
374       int err;
375       char *basename;
376
377       check_stub_type (TYPE_BASECLASS (type, i));
378       basename = TYPE_NAME (TYPE_BASECLASS (type, i));
379
380       if (BASETYPE_VIA_VIRTUAL (type, i))
381         {
382           struct type **first_dont_print
383             = (struct type **)obstack_base (&dont_print_obstack);
384
385           int j = (struct type **)obstack_next_free (&dont_print_obstack)
386             - first_dont_print;
387
388           while (--j >= 0)
389             if (TYPE_BASECLASS (type, i) == first_dont_print[j])
390               goto flush_it;
391
392           obstack_ptr_grow (&dont_print_obstack, TYPE_BASECLASS (type, i));
393         }
394
395       /* Fix to use baseclass_offset instead. FIXME */
396       baddr = baseclass_addr (type, i, valaddr, 0, &err);
397       if (err == 0 && baddr == 0)
398         error ("could not find virtual baseclass %s\n",
399                basename ? basename : "");
400
401       if (pretty)
402         {
403           fprintf_filtered (stream, "\n");
404           print_spaces_filtered (2 * recurse, stream);
405         }
406       fputs_filtered ("<", stream);
407       /* Not sure what the best notation is in the case where there is no
408          baseclass name.  */
409       fputs_filtered (basename ? basename : "", stream);
410       fputs_filtered ("> = ", stream);
411       if (err != 0)
412         {
413           fprintf_filtered (stream, "<invalid address ");
414           print_address_numeric ((CORE_ADDR) baddr, stream);
415           fprintf_filtered (stream, ">");
416         }
417       else
418         cp_print_value_fields (TYPE_BASECLASS (type, i), baddr, stream, format,
419                                recurse, pretty,
420                                (struct type **) obstack_base (&dont_print_obstack));
421       fputs_filtered (", ", stream);
422
423     flush_it:
424       ;
425     }
426
427   if (dont_print == 0)
428     {
429       /* Free the space used to deal with the printing
430          of this type from top level.  */
431       obstack_free (&dont_print_obstack, last_dont_print);
432       /* Reset watermark so that we can continue protecting
433          ourselves from whatever we were protecting ourselves.  */
434       dont_print_obstack = tmp_obstack;
435     }
436 }
437
438 void
439 cp_print_class_member (valaddr, domain, stream, prefix)
440      char *valaddr;
441      struct type *domain;
442      GDB_FILE *stream;
443      char *prefix;
444 {
445   
446   /* VAL is a byte offset into the structure type DOMAIN.
447      Find the name of the field for that offset and
448      print it.  */
449   int extra = 0;
450   int bits = 0;
451   register unsigned int i;
452   unsigned len = TYPE_NFIELDS (domain);
453   /* @@ Make VAL into bit offset */
454   LONGEST val = unpack_long (builtin_type_int, valaddr) << 3;
455   for (i = TYPE_N_BASECLASSES (domain); i < len; i++)
456     {
457       int bitpos = TYPE_FIELD_BITPOS (domain, i);
458       QUIT;
459       if (val == bitpos)
460         break;
461       if (val < bitpos && i != 0)
462         {
463           /* Somehow pointing into a field.  */
464           i -= 1;
465           extra = (val - TYPE_FIELD_BITPOS (domain, i));
466           if (extra & 0x7)
467             bits = 1;
468           else
469             extra >>= 3;
470           break;
471         }
472     }
473   if (i < len)
474     {
475       char *name;
476       fprintf_filtered (stream, prefix);
477       name = type_name_no_tag (domain);
478       if (name)
479         fputs_filtered (name, stream);
480       else
481         c_type_print_base (domain, stream, 0, 0);
482       fprintf_filtered (stream, "::");
483       fputs_filtered (TYPE_FIELD_NAME (domain, i), stream);
484       if (extra)
485         fprintf_filtered (stream, " + %d bytes", extra);
486       if (bits)
487         fprintf_filtered (stream, " (offset in bits)");
488     }
489   else
490     fprintf_filtered (stream, "%d", val >> 3);
491 }
492
493 void
494 _initialize_cp_valprint ()
495 {
496   add_show_from_set
497     (add_set_cmd ("vtbl", class_support, var_boolean, (char *)&vtblprint,
498                   "Set printing of C++ virtual function tables.",
499                   &setprintlist),
500      &showprintlist);
501
502   add_show_from_set
503     (add_set_cmd ("object", class_support, var_boolean, (char *)&objectprint,
504           "Set printing of object's derived type based on vtable info.",
505                   &setprintlist),
506      &showprintlist);
507
508   /* Give people the defaults which they are used to.  */
509   objectprint = 0;
510   vtblprint = 0;
511   obstack_begin (&dont_print_obstack, 32 * sizeof (struct type *));
512 }