1 /* Language independent support for printing types for GDB, the GNU debugger.
3 Copyright (C) 1986, 1988-1989, 1991-1995, 1998-2001, 2003, 2006-2012
4 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 #include "gdb_obstack.h"
23 #include "bfd.h" /* Binary File Description */
26 #include "expression.h"
34 #include "typeprint.h"
35 #include "gdb_string.h"
36 #include "exceptions.h"
40 extern void _initialize_typeprint (void);
42 static void ptype_command (char *, int);
44 static void whatis_command (char *, int);
46 static void whatis_exp (char *, int);
48 const struct type_print_options type_print_raw_options =
53 /* The default flags for 'ptype' and 'whatis'. */
55 static struct type_print_options default_ptype_flags =
60 /* Print a description of a type in the format of a
61 typedef for the current language.
62 NEW is the new name for a type TYPE. */
65 typedef_print (struct type *type, struct symbol *new, struct ui_file *stream)
67 LA_PRINT_TYPEDEF (type, new, stream);
70 /* The default way to print a typedef. */
73 default_print_typedef (struct type *type, struct symbol *new_symbol,
74 struct ui_file *stream)
76 error (_("Language not supported."));
79 /* Print a description of a type TYPE in the form of a declaration of a
80 variable named VARSTRING. (VARSTRING is demangled if necessary.)
81 Output goes to STREAM (via stdio).
82 If SHOW is positive, we show the contents of the outermost level
83 of structure even if there is a type name that could be used instead.
84 If SHOW is negative, we never show the details of elements' types. */
87 type_print (struct type *type, const char *varstring, struct ui_file *stream,
90 LA_PRINT_TYPE (type, varstring, stream, show, 0, &default_ptype_flags);
93 /* Print TYPE to a string, returning it. The caller is responsible for
94 freeing the string. */
97 type_to_string (struct type *type)
101 struct cleanup *old_chain;
102 volatile struct gdb_exception except;
104 stb = mem_fileopen ();
105 old_chain = make_cleanup_ui_file_delete (stb);
107 TRY_CATCH (except, RETURN_MASK_ALL)
109 type_print (type, "", stb, -1);
110 s = ui_file_xstrdup (stb, NULL);
112 if (except.reason < 0)
115 do_cleanups (old_chain);
120 /* Print type of EXP, or last thing in value history if EXP == NULL.
121 show is passed to type_print. */
124 whatis_exp (char *exp, int show)
126 struct expression *expr;
128 struct cleanup *old_chain = NULL;
129 struct type *real_type = NULL;
134 struct value_print_options opts;
138 expr = parse_expression (exp);
139 old_chain = make_cleanup (free_current_contents, &expr);
140 val = evaluate_type (expr);
143 val = access_value_history (0);
145 type = value_type (val);
147 get_user_print_options (&opts);
148 if (opts.objectprint)
150 if (((TYPE_CODE (type) == TYPE_CODE_PTR)
151 || (TYPE_CODE (type) == TYPE_CODE_REF))
152 && (TYPE_CODE (TYPE_TARGET_TYPE (type)) == TYPE_CODE_CLASS))
153 real_type = value_rtti_indirect_type (val, &full, &top, &using_enc);
154 else if (TYPE_CODE (type) == TYPE_CODE_CLASS)
155 real_type = value_rtti_type (val, &full, &top, &using_enc);
158 printf_filtered ("type = ");
162 printf_filtered ("/* real type = ");
163 type_print (real_type, "", gdb_stdout, -1);
165 printf_filtered (" (incomplete object)");
166 printf_filtered (" */\n");
169 type_print (type, "", gdb_stdout, show);
170 printf_filtered ("\n");
173 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 /* TYPENAME is either the name of a type, or an expression. */
188 ptype_command (char *typename, int from_tty)
190 whatis_exp (typename, 1);
193 /* Print integral scalar data VAL, of type TYPE, onto stdio stream STREAM.
194 Used to print data from type structures in a specified type. For example,
195 array bounds may be characters or booleans in some languages, and this
196 allows the ranges to be printed in their "natural" form rather than as
197 decimal integer values.
199 FIXME: This is here simply because only the type printing routines
200 currently use it, and it wasn't clear if it really belonged somewhere
201 else (like printcmd.c). There are a lot of other gdb routines that do
202 something similar, but they are generally concerned with printing values
203 that come from the inferior in target byte order and target size. */
206 print_type_scalar (struct type *type, LONGEST val, struct ui_file *stream)
211 CHECK_TYPEDEF (type);
213 switch (TYPE_CODE (type))
217 len = TYPE_NFIELDS (type);
218 for (i = 0; i < len; i++)
220 if (TYPE_FIELD_ENUMVAL (type, i) == val)
227 fputs_filtered (TYPE_FIELD_NAME (type, i), stream);
231 print_longest (stream, 'd', 0, val);
236 print_longest (stream, TYPE_UNSIGNED (type) ? 'u' : 'd', 0, val);
240 LA_PRINT_CHAR ((unsigned char) val, type, stream);
244 fprintf_filtered (stream, val ? "TRUE" : "FALSE");
247 case TYPE_CODE_RANGE:
248 print_type_scalar (TYPE_TARGET_TYPE (type), val, stream);
251 case TYPE_CODE_UNDEF:
253 case TYPE_CODE_ARRAY:
254 case TYPE_CODE_STRUCT:
255 case TYPE_CODE_UNION:
260 case TYPE_CODE_STRING:
261 case TYPE_CODE_ERROR:
262 case TYPE_CODE_MEMBERPTR:
263 case TYPE_CODE_METHODPTR:
264 case TYPE_CODE_METHOD:
266 case TYPE_CODE_NAMESPACE:
267 error (_("internal error: unhandled type in print_type_scalar"));
271 error (_("Invalid type code in symbol table."));
276 /* Dump details of a type specified either directly or indirectly.
277 Uses the same sort of type lookup mechanism as ptype_command()
278 and whatis_command(). */
281 maintenance_print_type (char *typename, int from_tty)
285 struct cleanup *old_chain;
286 struct expression *expr;
288 if (typename != NULL)
290 expr = parse_expression (typename);
291 old_chain = make_cleanup (free_current_contents, &expr);
292 if (expr->elts[0].opcode == OP_TYPE)
294 /* The user expression names a type directly, just use that type. */
295 type = expr->elts[1].type;
299 /* The user expression may name a type indirectly by naming an
300 object of that type. Find that indirectly named type. */
301 val = evaluate_type (expr);
302 type = value_type (val);
306 recursive_dump_type (type, 0);
308 do_cleanups (old_chain);
314 _initialize_typeprint (void)
316 add_com ("ptype", class_vars, ptype_command, _("\
317 Print definition of type TYPE.\n\
318 Argument may be a type name defined by typedef, or \"struct STRUCT-TAG\"\n\
319 or \"class CLASS-NAME\" or \"union UNION-TAG\" or \"enum ENUM-TAG\".\n\
320 The selected stack frame's lexical context is used to look up the name.\n\
321 Contrary to \"whatis\", \"ptype\" always unrolls any typedefs."));
323 add_com ("whatis", class_vars, whatis_command,
324 _("Print data type of expression EXP.\n\
325 Only one level of typedefs is unrolled. See also \"ptype\"."));