/* Support for printing C and C++ types for GDB, the GNU debugger. Copyright 1986, 1988, 1989, 1991 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 (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 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., 675 Mass Ave, Cambridge, MA 02139, USA. */ #include "defs.h" #include "obstack.h" #include "bfd.h" /* Binary File Description */ #include "symtab.h" #include "gdbtypes.h" #include "expression.h" #include "value.h" #include "gdbcore.h" #include "target.h" #include "command.h" #include "gdbcmd.h" #include "language.h" #include "demangle.h" #include "c-lang.h" #include "typeprint.h" #include <string.h> #include <errno.h> extern int demangle; /* whether to print C++ syms raw or source-form */ static void c_type_print_args PARAMS ((struct type *, FILE *)); static void c_type_print_varspec_suffix PARAMS ((struct type *, FILE *, int, int, int)); static void cp_type_print_derivation_info PARAMS ((FILE *, struct type *)); void c_type_print_varspec_prefix PARAMS ((struct type *, FILE *, int, int)); void c_type_print_base PARAMS ((struct type *, FILE *, int, int)); /* Print a description of a type in the format of a typedef for the current language. NEW is the new name for a type TYPE. */ void c_typedef_print (type, new, stream) struct type *type; struct symbol *new; FILE *stream; { switch (current_language->la_language) { #ifdef _LANG_c case language_c: case language_cplus: fprintf_filtered(stream, "typedef "); type_print(type,"",stream,0); if(TYPE_NAME ((SYMBOL_TYPE (new))) == 0 || !STREQ (TYPE_NAME ((SYMBOL_TYPE (new))), SYMBOL_NAME (new))) fprintf_filtered(stream, " %s", SYMBOL_SOURCE_NAME(new)); break; #endif #ifdef _LANG_m2 case language_m2: fprintf_filtered(stream, "TYPE "); if(!TYPE_NAME(SYMBOL_TYPE(new)) || !STREQ (TYPE_NAME(SYMBOL_TYPE(new)), SYMBOL_NAME(new))) fprintf_filtered(stream, "%s = ", SYMBOL_SOURCE_NAME(new)); else fprintf_filtered(stream, "<builtin> = "); type_print(type,"",stream,0); break; #endif #ifdef _LANG_chill case language_chill: error ("Missing Chill support in function c_typedef_print."); /*FIXME*/ #endif default: error("Language not supported."); } fprintf_filtered(stream, ";\n"); } /* LEVEL is the depth to indent lines by. */ void c_print_type (type, varstring, stream, show, level) struct type *type; char *varstring; FILE *stream; int show; int level; { register enum type_code code; int demangled_args; c_type_print_base (type, stream, show, level); code = TYPE_CODE (type); if ((varstring != NULL && *varstring != '\0') || /* Need a space if going to print stars or brackets; but not if we will print just a type name. */ ((show > 0 || TYPE_NAME (type) == 0) && (code == TYPE_CODE_PTR || code == TYPE_CODE_FUNC || code == TYPE_CODE_METHOD || code == TYPE_CODE_ARRAY || code == TYPE_CODE_MEMBER || code == TYPE_CODE_REF))) fputs_filtered (" ", stream); c_type_print_varspec_prefix (type, stream, show, 0); fputs_filtered (varstring, stream); /* For demangled function names, we have the arglist as part of the name, so don't print an additional pair of ()'s */ demangled_args = varstring[strlen(varstring) - 1] == ')'; c_type_print_varspec_suffix (type, stream, show, 0, demangled_args); } /* Print the C++ method arguments ARGS to the file STREAM. */ void cp_type_print_method_args (args, prefix, varstring, staticp, stream) struct type **args; char *prefix; char *varstring; int staticp; FILE *stream; { int i; fprintf_symbol_filtered (stream, prefix, language_cplus, DMGL_ANSI); fprintf_symbol_filtered (stream, varstring, language_cplus, DMGL_ANSI); fputs_filtered (" (", stream); if (args && args[!staticp] && args[!staticp]->code != TYPE_CODE_VOID) { i = !staticp; /* skip the class variable */ while (1) { type_print (args[i++], "", stream, 0); if (!args[i]) { fprintf_filtered (stream, " ..."); break; } else if (args[i]->code != TYPE_CODE_VOID) { fprintf_filtered (stream, ", "); } else break; } } fprintf_filtered (stream, ")"); } /* If TYPE is a derived type, then print out derivation information. Print only the actual base classes of this type, not the base classes of the base classes. I.E. for the derivation hierarchy: class A { int a; }; class B : public A {int b; }; class C : public B {int c; }; Print the type of class C as: class C : public B { int c; } Not as the following (like gdb used to), which is not legal C++ syntax for derived types and may be confused with the multiple inheritance form: class C : public B : public A { int c; } In general, gdb should try to print the types as closely as possible to the form that they appear in the source code. */ static void cp_type_print_derivation_info (stream, type) FILE *stream; struct type *type; { char *name; int i; for (i = 0; i < TYPE_N_BASECLASSES (type); i++) { fputs_filtered (i == 0 ? ": " : ", ", stream); fprintf_filtered (stream, "%s%s ", BASETYPE_VIA_PUBLIC (type, i) ? "public" : "private", BASETYPE_VIA_VIRTUAL(type, i) ? " virtual" : ""); name = type_name_no_tag (TYPE_BASECLASS (type, i)); fprintf_filtered (stream, "%s", name ? name : "(null)"); } if (i > 0) { fputs_filtered (" ", stream); } } /* Print any asterisks or open-parentheses needed before the variable name (to describe its type). On outermost call, pass 0 for PASSED_A_PTR. On outermost call, SHOW > 0 means should ignore any typename for TYPE and show its details. SHOW is always zero on recursive calls. */ void c_type_print_varspec_prefix (type, stream, show, passed_a_ptr) struct type *type; FILE *stream; int show; int passed_a_ptr; { char *name; if (type == 0) return; if (TYPE_NAME (type) && show <= 0) return; QUIT; switch (TYPE_CODE (type)) { case TYPE_CODE_PTR: c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 1); fprintf_filtered (stream, "*"); break; case TYPE_CODE_MEMBER: if (passed_a_ptr) fprintf_filtered (stream, "("); c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 0); fprintf_filtered (stream, " "); name = type_name_no_tag (TYPE_DOMAIN_TYPE (type)); if (name) fputs_filtered (name, stream); else c_type_print_base (TYPE_DOMAIN_TYPE (type), stream, 0, passed_a_ptr); fprintf_filtered (stream, "::"); break; case TYPE_CODE_METHOD: if (passed_a_ptr) fprintf (stream, "("); c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 0); if (passed_a_ptr) { fprintf_filtered (stream, " "); c_type_print_base (TYPE_DOMAIN_TYPE (type), stream, 0, passed_a_ptr); fprintf_filtered (stream, "::"); } break; case TYPE_CODE_REF: c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 1); fprintf_filtered (stream, "&"); break; case TYPE_CODE_FUNC: c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 0); if (passed_a_ptr) fprintf_filtered (stream, "("); break; case TYPE_CODE_ARRAY: c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 0); if (passed_a_ptr) fprintf_filtered (stream, "("); break; case TYPE_CODE_UNDEF: case TYPE_CODE_STRUCT: case TYPE_CODE_UNION: case TYPE_CODE_ENUM: case TYPE_CODE_INT: case TYPE_CODE_FLT: case TYPE_CODE_VOID: case TYPE_CODE_ERROR: case TYPE_CODE_CHAR: case TYPE_CODE_BOOL: case TYPE_CODE_SET: case TYPE_CODE_RANGE: case TYPE_CODE_STRING: /* These types need no prefix. They are listed here so that gcc -Wall will reveal any types that haven't been handled. */ break; } } static void c_type_print_args (type, stream) struct type *type; FILE *stream; { int i; struct type **args; fprintf_filtered (stream, "("); args = TYPE_ARG_TYPES (type); if (args != NULL) { if (args[1] == NULL) { fprintf_filtered (stream, "..."); } else { for (i = 1; args[i] != NULL && args[i]->code != TYPE_CODE_VOID; i++) { c_print_type (args[i], "", stream, -1, 0); if (args[i+1] == NULL) { fprintf_filtered (stream, "..."); } else if (args[i+1]->code != TYPE_CODE_VOID) { fprintf_filtered (stream, ","); wrap_here (" "); } } } } fprintf_filtered (stream, ")"); } /* Print any array sizes, function arguments or close parentheses needed after the variable name (to describe its type). Args work like c_type_print_varspec_prefix. */ static void c_type_print_varspec_suffix (type, stream, show, passed_a_ptr, demangled_args) struct type *type; FILE *stream; int show; int passed_a_ptr; int demangled_args; { if (type == 0) return; if (TYPE_NAME (type) && show <= 0) return; QUIT; switch (TYPE_CODE (type)) { case TYPE_CODE_ARRAY: if (passed_a_ptr) fprintf_filtered (stream, ")"); fprintf_filtered (stream, "["); if (TYPE_LENGTH (type) > 0 && TYPE_LENGTH (TYPE_TARGET_TYPE (type)) > 0) fprintf_filtered (stream, "%d", (TYPE_LENGTH (type) / TYPE_LENGTH (TYPE_TARGET_TYPE (type)))); fprintf_filtered (stream, "]"); c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0, 0, 0); break; case TYPE_CODE_MEMBER: if (passed_a_ptr) fprintf_filtered (stream, ")"); c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0, 0, 0); break; case TYPE_CODE_METHOD: if (passed_a_ptr) fprintf_filtered (stream, ")"); c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0, 0, 0); if (passed_a_ptr) { c_type_print_args (type, stream); } break; case TYPE_CODE_PTR: case TYPE_CODE_REF: c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0, 1, 0); break; case TYPE_CODE_FUNC: c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0, passed_a_ptr, 0); if (passed_a_ptr) fprintf_filtered (stream, ")"); if (!demangled_args) fprintf_filtered (stream, "()"); break; case TYPE_CODE_UNDEF: case TYPE_CODE_STRUCT: case TYPE_CODE_UNION: case TYPE_CODE_ENUM: case TYPE_CODE_INT: case TYPE_CODE_FLT: case TYPE_CODE_VOID: case TYPE_CODE_ERROR: case TYPE_CODE_CHAR: case TYPE_CODE_BOOL: case TYPE_CODE_SET: case TYPE_CODE_RANGE: case TYPE_CODE_STRING: /* These types do not need a suffix. They are listed so that gcc -Wall will report types that may not have been considered. */ break; } } /* Print the name of the type (or the ultimate pointer target, function value or array element), or the description of a structure or union. SHOW nonzero means don't print this type as just its name; show its real definition even if it has a name. SHOW zero means print just typename or struct tag if there is one SHOW negative means abbreviate structure elements. SHOW is decremented for printing of structure elements. LEVEL is the depth to indent by. We increase it for some recursive calls. */ void c_type_print_base (type, stream, show, level) struct type *type; FILE *stream; int show; int level; { char *name; register int i; register int len; register int lastval; char *mangled_name; char *demangled_name; enum {s_none, s_public, s_private, s_protected} section_type; QUIT; wrap_here (" "); if (type == NULL) { fputs_filtered ("<type unknown>", stream); return; } /* When SHOW is zero or less, and there is a valid type name, then always just print the type name directly from the type. */ if ((show <= 0) && (TYPE_NAME (type) != NULL)) { fputs_filtered (TYPE_NAME (type), stream); return; } switch (TYPE_CODE (type)) { case TYPE_CODE_ARRAY: case TYPE_CODE_PTR: case TYPE_CODE_MEMBER: case TYPE_CODE_REF: case TYPE_CODE_FUNC: case TYPE_CODE_METHOD: c_type_print_base (TYPE_TARGET_TYPE (type), stream, show, level); break; case TYPE_CODE_STRUCT: fprintf_filtered (stream, HAVE_CPLUS_STRUCT (type) ? "class " : "struct "); goto struct_union; case TYPE_CODE_UNION: fprintf_filtered (stream, "union "); struct_union: if ((name = type_name_no_tag (type)) != NULL) { fputs_filtered (name, stream); fputs_filtered (" ", stream); wrap_here (" "); } if (show < 0) fprintf_filtered (stream, "{...}"); else { check_stub_type (type); cp_type_print_derivation_info (stream, type); fprintf_filtered (stream, "{\n"); if ((TYPE_NFIELDS (type) == 0) && (TYPE_NFN_FIELDS (type) == 0)) { if (TYPE_FLAGS (type) & TYPE_FLAG_STUB) fprintfi_filtered (level + 4, stream, "<incomplete type>\n"); else fprintfi_filtered (level + 4, stream, "<no data fields>\n"); } /* Start off with no specific section type, so we can print one for the first field we find, and use that section type thereafter until we find another type. */ section_type = s_none; /* If there is a base class for this type, do not print the field that it occupies. */ len = TYPE_NFIELDS (type); for (i = TYPE_N_BASECLASSES (type); i < len; i++) { QUIT; /* Don't print out virtual function table. */ if ((TYPE_FIELD_NAME (type, i))[5] == CPLUS_MARKER && !strncmp (TYPE_FIELD_NAME (type, i), "_vptr", 5)) continue; /* If this is a C++ class we can print the various C++ section labels. */ if (HAVE_CPLUS_STRUCT (type)) { if (TYPE_FIELD_PROTECTED (type, i)) { if (section_type != s_protected) { section_type = s_protected; fprintfi_filtered (level + 2, stream, "protected:\n"); } } else if (TYPE_FIELD_PRIVATE (type, i)) { if (section_type != s_private) { section_type = s_private; fprintfi_filtered (level + 2, stream, "private:\n"); } } else { if (section_type != s_public) { section_type = s_public; fprintfi_filtered (level + 2, stream, "public:\n"); } } } print_spaces_filtered (level + 4, stream); if (TYPE_FIELD_STATIC (type, i)) { fprintf_filtered (stream, "static "); } c_print_type (TYPE_FIELD_TYPE (type, i), TYPE_FIELD_NAME (type, i), stream, show - 1, level + 4); if (!TYPE_FIELD_STATIC (type, i) && TYPE_FIELD_PACKED (type, i)) { /* It is a bitfield. This code does not attempt to look at the bitpos and reconstruct filler, unnamed fields. This would lead to misleading results if the compiler does not put out fields for such things (I don't know what it does). */ fprintf_filtered (stream, " : %d", TYPE_FIELD_BITSIZE (type, i)); } fprintf_filtered (stream, ";\n"); } /* If there are both fields and methods, put a space between. */ len = TYPE_NFN_FIELDS (type); if (len && section_type != s_none) fprintf_filtered (stream, "\n"); /* C++: print out the methods */ for (i = 0; i < len; i++) { struct fn_field *f = TYPE_FN_FIELDLIST1 (type, i); int j, len2 = TYPE_FN_FIELDLIST_LENGTH (type, i); char *method_name = TYPE_FN_FIELDLIST_NAME (type, i); int is_constructor = name && STREQ(method_name, name); for (j = 0; j < len2; j++) { QUIT; if (TYPE_FN_FIELD_PROTECTED (f, j)) { if (section_type != s_protected) { section_type = s_protected; fprintfi_filtered (level + 2, stream, "protected:\n"); } } else if (TYPE_FN_FIELD_PRIVATE (f, j)) { if (section_type != s_private) { section_type = s_private; fprintfi_filtered (level + 2, stream, "private:\n"); } } else { if (section_type != s_public) { section_type = s_public; fprintfi_filtered (level + 2, stream, "public:\n"); } } print_spaces_filtered (level + 4, stream); if (TYPE_FN_FIELD_VIRTUAL_P (f, j)) fprintf_filtered (stream, "virtual "); else if (TYPE_FN_FIELD_STATIC_P (f, j)) fprintf_filtered (stream, "static "); if (TYPE_TARGET_TYPE (TYPE_FN_FIELD_TYPE (f, j)) == 0) { /* Keep GDB from crashing here. */ fprintf (stream, "<undefined type> %s;\n", TYPE_FN_FIELD_PHYSNAME (f, j)); break; } else if (!is_constructor) { type_print (TYPE_TARGET_TYPE (TYPE_FN_FIELD_TYPE (f, j)), "", stream, 0); fputs_filtered (" ", stream); } if (TYPE_FN_FIELD_STUB (f, j)) { /* Build something we can demangle. */ mangled_name = gdb_mangle_name (type, i, j); demangled_name = cplus_demangle (mangled_name, DMGL_ANSI | DMGL_PARAMS); if (demangled_name == NULL) fprintf_filtered (stream, "<badly mangled name %s>", mangled_name); else { fprintf_filtered (stream, "%s", strchr (demangled_name, ':') + 2); free (demangled_name); } free (mangled_name); } else if (TYPE_FN_FIELD_PHYSNAME (f, j)[0] == '_' && TYPE_FN_FIELD_PHYSNAME (f, j)[1] == CPLUS_MARKER) cp_type_print_method_args (TYPE_FN_FIELD_ARGS (f, j) + 1, "~", method_name, 0, stream); else cp_type_print_method_args (TYPE_FN_FIELD_ARGS (f, j), "", method_name, TYPE_FN_FIELD_STATIC_P (f, j), stream); fprintf_filtered (stream, ";\n"); } } fprintfi_filtered (level, stream, "}"); } break; case TYPE_CODE_ENUM: fprintf_filtered (stream, "enum "); if ((name = type_name_no_tag (type)) != NULL) { fputs_filtered (name, stream); fputs_filtered (" ", stream); } wrap_here (" "); if (show < 0) fprintf_filtered (stream, "{...}"); else { fprintf_filtered (stream, "{"); len = TYPE_NFIELDS (type); lastval = 0; for (i = 0; i < len; i++) { QUIT; if (i) fprintf_filtered (stream, ", "); wrap_here (" "); fputs_filtered (TYPE_FIELD_NAME (type, i), stream); if (lastval != TYPE_FIELD_BITPOS (type, i)) { fprintf_filtered (stream, " = %d", TYPE_FIELD_BITPOS (type, i)); lastval = TYPE_FIELD_BITPOS (type, i); } lastval++; } fprintf_filtered (stream, "}"); } break; case TYPE_CODE_VOID: fprintf_filtered (stream, "void"); break; case TYPE_CODE_UNDEF: fprintf_filtered (stream, "struct <unknown>"); break; case TYPE_CODE_ERROR: fprintf_filtered (stream, "<unknown type>"); break; case TYPE_CODE_RANGE: /* This should not occur */ fprintf_filtered (stream, "<range type>"); break; default: /* Handle types not explicitly handled by the other cases, such as fundamental types. For these, just print whatever the type name is, as recorded in the type itself. If there is no type name, then complain. */ if (TYPE_NAME (type) != NULL) { fputs_filtered (TYPE_NAME (type), stream); } else { error ("Invalid type code (%d) in symbol table.", TYPE_CODE (type)); } break; } }