1 /* Language independent support for printing types for GDB, the GNU debugger.
2 Copyright 1986, 1988, 1989, 1991, 1992, 1993, 1994, 1995, 1998, 1999,
3 2000, 2001 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 2 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, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #include "gdb_obstack.h"
24 #include "bfd.h" /* Binary File Description */
27 #include "expression.h"
36 #include "gdb_string.h"
39 /* For real-type printing in whatis_exp() */
40 extern int objectprint; /* Controls looking up an object's derived type
41 using what we find in its vtables. */
43 extern void _initialize_typeprint (void);
45 static void ptype_command (char *, int);
47 static struct type *ptype_eval (struct expression *);
49 static void whatis_command (char *, int);
51 static void whatis_exp (char *, int);
53 /* Print a description of a type in the format of a
54 typedef for the current language.
55 NEW is the new name for a type TYPE. */
58 typedef_print (struct type *type, struct symbol *new, struct ui_file *stream)
61 switch (current_language->la_language)
66 fprintf_filtered (stream, "typedef ");
67 type_print (type, "", stream, 0);
68 if (TYPE_NAME ((SYMBOL_TYPE (new))) == 0
69 || !STREQ (TYPE_NAME ((SYMBOL_TYPE (new))), SYMBOL_NAME (new)))
70 fprintf_filtered (stream, " %s", SYMBOL_SOURCE_NAME (new));
75 fprintf_filtered (stream, "TYPE ");
76 if (!TYPE_NAME (SYMBOL_TYPE (new)) ||
77 !STREQ (TYPE_NAME (SYMBOL_TYPE (new)), SYMBOL_NAME (new)))
78 fprintf_filtered (stream, "%s = ", SYMBOL_SOURCE_NAME (new));
80 fprintf_filtered (stream, "<builtin> = ");
81 type_print (type, "", stream, 0);
86 fprintf_filtered (stream, "type ");
87 fprintf_filtered (stream, "%s = ", SYMBOL_SOURCE_NAME (new));
88 type_print (type, "", stream, 0);
92 error ("Language not supported.");
94 fprintf_filtered (stream, ";\n");
97 /* Print a description of a type TYPE in the form of a declaration of a
98 variable named VARSTRING. (VARSTRING is demangled if necessary.)
99 Output goes to STREAM (via stdio).
100 If SHOW is positive, we show the contents of the outermost level
101 of structure even if there is a type name that could be used instead.
102 If SHOW is negative, we never show the details of elements' types. */
105 type_print (struct type *type, char *varstring, struct ui_file *stream,
108 LA_PRINT_TYPE (type, varstring, stream, show, 0);
111 /* Print type of EXP, or last thing in value history if EXP == NULL.
112 show is passed to type_print. */
115 whatis_exp (char *exp, int show)
117 struct expression *expr;
119 register struct cleanup *old_chain = NULL;
120 struct type *real_type = NULL;
128 expr = parse_expression (exp);
129 old_chain = make_cleanup (free_current_contents, &expr);
130 val = evaluate_type (expr);
133 val = access_value_history (0);
135 type = VALUE_TYPE (val);
139 if (((TYPE_CODE (type) == TYPE_CODE_PTR) ||
140 (TYPE_CODE (type) == TYPE_CODE_REF))
142 (TYPE_CODE (TYPE_TARGET_TYPE (type)) == TYPE_CODE_CLASS))
144 real_type = value_rtti_target_type (val, &full, &top, &using_enc);
147 if (TYPE_CODE (type) == TYPE_CODE_PTR)
148 real_type = lookup_pointer_type (real_type);
150 real_type = lookup_reference_type (real_type);
153 else if (TYPE_CODE (type) == TYPE_CODE_CLASS)
154 real_type = value_rtti_type (val, &full, &top, &using_enc);
157 printf_filtered ("type = ");
161 printf_filtered ("/* real type = ");
162 type_print (real_type, "", gdb_stdout, -1);
164 printf_filtered (" (incomplete object)");
165 printf_filtered (" */\n");
168 type_print (type, "", gdb_stdout, show);
169 printf_filtered ("\n");
172 do_cleanups (old_chain);
177 whatis_command (char *exp, int from_tty)
179 /* Most of the time users do not want to see all the fields
180 in a structure. If they do they can use the "ptype" command.
181 Hence the "-1" below. */
182 whatis_exp (exp, -1);
185 /* Simple subroutine for ptype_command. */
188 ptype_eval (struct expression *exp)
190 if (exp->elts[0].opcode == OP_TYPE)
192 return (exp->elts[1].type);
200 /* TYPENAME is either the name of a type, or an expression. */
204 ptype_command (char *typename, int from_tty)
206 register struct type *type;
207 struct expression *expr;
208 register struct cleanup *old_chain;
210 if (typename == NULL)
212 /* Print type of last thing in value history. */
213 whatis_exp (typename, 1);
217 expr = parse_expression (typename);
218 old_chain = make_cleanup (free_current_contents, &expr);
219 type = ptype_eval (expr);
222 /* User did "ptype <typename>" */
223 printf_filtered ("type = ");
224 type_print (type, "", gdb_stdout, 1);
225 printf_filtered ("\n");
226 do_cleanups (old_chain);
230 /* User did "ptype <symbolname>" */
231 do_cleanups (old_chain);
232 whatis_exp (typename, 1);
237 /* Print integral scalar data VAL, of type TYPE, onto stdio stream STREAM.
238 Used to print data from type structures in a specified type. For example,
239 array bounds may be characters or booleans in some languages, and this
240 allows the ranges to be printed in their "natural" form rather than as
241 decimal integer values.
243 FIXME: This is here simply because only the type printing routines
244 currently use it, and it wasn't clear if it really belonged somewhere
245 else (like printcmd.c). There are a lot of other gdb routines that do
246 something similar, but they are generally concerned with printing values
247 that come from the inferior in target byte order and target size. */
250 print_type_scalar (struct type *type, LONGEST val, struct ui_file *stream)
255 CHECK_TYPEDEF (type);
257 switch (TYPE_CODE (type))
261 len = TYPE_NFIELDS (type);
262 for (i = 0; i < len; i++)
264 if (TYPE_FIELD_BITPOS (type, i) == val)
271 fputs_filtered (TYPE_FIELD_NAME (type, i), stream);
275 print_longest (stream, 'd', 0, val);
280 print_longest (stream, TYPE_UNSIGNED (type) ? 'u' : 'd', 0, val);
284 LA_PRINT_CHAR ((unsigned char) val, stream);
288 fprintf_filtered (stream, val ? "TRUE" : "FALSE");
291 case TYPE_CODE_RANGE:
292 print_type_scalar (TYPE_TARGET_TYPE (type), val, stream);
295 case TYPE_CODE_UNDEF:
297 case TYPE_CODE_ARRAY:
298 case TYPE_CODE_STRUCT:
299 case TYPE_CODE_UNION:
304 case TYPE_CODE_STRING:
305 case TYPE_CODE_ERROR:
306 case TYPE_CODE_MEMBER:
307 case TYPE_CODE_METHOD:
309 error ("internal error: unhandled type in print_type_scalar");
313 error ("Invalid type code in symbol table.");
318 /* Dump details of a type specified either directly or indirectly.
319 Uses the same sort of type lookup mechanism as ptype_command()
320 and whatis_command(). */
323 maintenance_print_type (char *typename, int from_tty)
326 register struct type *type;
327 register struct cleanup *old_chain;
328 struct expression *expr;
330 if (typename != NULL)
332 expr = parse_expression (typename);
333 old_chain = make_cleanup (free_current_contents, &expr);
334 if (expr->elts[0].opcode == OP_TYPE)
336 /* The user expression names a type directly, just use that type. */
337 type = expr->elts[1].type;
341 /* The user expression may name a type indirectly by naming an
342 object of that type. Find that indirectly named type. */
343 val = evaluate_type (expr);
344 type = VALUE_TYPE (val);
348 recursive_dump_type (type, 0);
350 do_cleanups (old_chain);
356 _initialize_typeprint (void)
359 add_com ("ptype", class_vars, ptype_command,
360 "Print definition of type TYPE.\n\
361 Argument may be a type name defined by typedef, or \"struct STRUCT-TAG\"\n\
362 or \"class CLASS-NAME\" or \"union UNION-TAG\" or \"enum ENUM-TAG\".\n\
363 The selected stack frame's lexical context is used to look up the name.");
365 add_com ("whatis", class_vars, whatis_command,
366 "Print data type of expression EXP.");