gdb/c-typeprint.c

   1 /* Support for printing C and C++ types for GDB, the GNU debugger.
   2    Copyright (C) 1986, 1988, 1989, 1991, 1992, 1993, 1994, 1995, 1996, 1998,
   3    1999, 2000, 2001, 2002, 2003, 2006, 2007, 2008, 2009, 2010
   4    Free Software Foundation, Inc.
   5
   6    This file is part of GDB.
   7
   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.
  12
  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.
  17
  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/>.  */
  20
  21 #include "defs.h"
  22 #include "gdb_obstack.h"
  23 #include "bfd.h"                /* Binary File Description */
  24 #include "symtab.h"
  25 #include "gdbtypes.h"
  26 #include "expression.h"
  27 #include "value.h"
  28 #include "gdbcore.h"
  29 #include "target.h"
  30 #include "language.h"
  31 #include "demangle.h"
  32 #include "c-lang.h"
  33 #include "typeprint.h"
  34 #include "cp-abi.h"
  35 #include "jv-lang.h"
  36 #include "gdb_string.h"
  37 #include <errno.h>
  38
  39 static void c_type_print_varspec_prefix (struct type *, struct ui_file *, int,
  40                                          int, int);
  41
  42 /* Print "const", "volatile", or address space modifiers. */
  43 static void c_type_print_modifier (struct type *, struct ui_file *,
  44                                    int, int);
  45 \f
  46 /* LEVEL is the depth to indent lines by.  */
  47
  48 void
  49 c_print_type (struct type *type, const char *varstring, struct ui_file *stream,
  50               int show, int level)
  51 {
  52   enum type_code code;
  53   int demangled_args;
  54   int need_post_space;
  55
  56   if (show > 0)
  57     CHECK_TYPEDEF (type);
  58
  59   c_type_print_base (type, stream, show, level);
  60   code = TYPE_CODE (type);
  61   if ((varstring != NULL && *varstring != '\0')
  62   /* Need a space if going to print stars or brackets;
  63      but not if we will print just a type name.  */
  64       || ((show > 0 || TYPE_NAME (type) == 0)
  65           && (code == TYPE_CODE_PTR || code == TYPE_CODE_FUNC
  66               || code == TYPE_CODE_METHOD
  67               || code == TYPE_CODE_ARRAY
  68               || code == TYPE_CODE_MEMBERPTR
  69               || code == TYPE_CODE_METHODPTR
  70               || code == TYPE_CODE_REF)))
  71     fputs_filtered (" ", stream);
  72   need_post_space = (varstring != NULL && strcmp (varstring, "") != 0);
  73   c_type_print_varspec_prefix (type, stream, show, 0, need_post_space);
  74
  75   if (varstring != NULL)
  76     {
  77       fputs_filtered (varstring, stream);
  78
  79       /* For demangled function names, we have the arglist as part of the name,
  80          so don't print an additional pair of ()'s */
  81
  82       demangled_args = strchr (varstring, '(') != NULL;
  83       c_type_print_varspec_suffix (type, stream, show, 0, demangled_args);
  84     }
  85 }
  86
  87 /* Print a typedef using C syntax.  TYPE is the underlying type.
  88    NEW_SYMBOL is the symbol naming the type.  STREAM is the stream on
  89    which to print.  */
  90
  91 void
  92 c_print_typedef (struct type *type, struct symbol *new_symbol,
  93                  struct ui_file *stream)
  94 {
  95   CHECK_TYPEDEF (type);
  96   fprintf_filtered (stream, "typedef ");
  97   type_print (type, "", stream, 0);
  98   if (TYPE_NAME ((SYMBOL_TYPE (new_symbol))) == 0
  99       || strcmp (TYPE_NAME ((SYMBOL_TYPE (new_symbol))),
 100                  SYMBOL_LINKAGE_NAME (new_symbol)) != 0
 101       || TYPE_CODE (SYMBOL_TYPE (new_symbol)) == TYPE_CODE_TYPEDEF)
 102     fprintf_filtered (stream, " %s", SYMBOL_PRINT_NAME (new_symbol));
 103   fprintf_filtered (stream, ";\n");
 104 }
 105
 106 /* If TYPE is a derived type, then print out derivation information.
 107    Print only the actual base classes of this type, not the base classes
 108    of the base classes.  I.E.  for the derivation hierarchy:
 109
 110    class A { int a; };
 111    class B : public A {int b; };
 112    class C : public B {int c; };
 113
 114    Print the type of class C as:
 115
 116    class C : public B {
 117    int c;
 118    }
 119
 120    Not as the following (like gdb used to), which is not legal C++ syntax for
 121    derived types and may be confused with the multiple inheritance form:
 122
 123    class C : public B : public A {
 124    int c;
 125    }
 126
 127    In general, gdb should try to print the types as closely as possible to
 128    the form that they appear in the source code.
 129    Note that in case of protected derivation gcc will not say 'protected'
 130    but 'private'. The HP's aCC compiler emits specific information for
 131    derivation via protected inheritance, so gdb can print it out */
 132
 133 static void
 134 cp_type_print_derivation_info (struct ui_file *stream, struct type *type)
 135 {
 136   char *name;
 137   int i;
 138
 139   for (i = 0; i < TYPE_N_BASECLASSES (type); i++)
 140     {
 141       fputs_filtered (i == 0 ? ": " : ", ", stream);
 142       fprintf_filtered (stream, "%s%s ",
 143                         BASETYPE_VIA_PUBLIC (type, i) ? "public"
 144                : (TYPE_FIELD_PROTECTED (type, i) ? "protected" : "private"),
 145                         BASETYPE_VIA_VIRTUAL (type, i) ? " virtual" : "");
 146       name = type_name_no_tag (TYPE_BASECLASS (type, i));
 147       fprintf_filtered (stream, "%s", name ? name : "(null)");
 148     }
 149   if (i > 0)
 150     {
 151       fputs_filtered (" ", stream);
 152     }
 153 }
 154
 155 /* Print the C++ method arguments ARGS to the file STREAM.  */
 156
 157 static void
 158 cp_type_print_method_args (struct type *mtype, char *prefix, char *varstring,
 159                            int staticp, struct ui_file *stream)
 160 {
 161   struct field *args = TYPE_FIELDS (mtype);
 162   int nargs = TYPE_NFIELDS (mtype);
 163   int varargs = TYPE_VARARGS (mtype);
 164   int i;
 165
 166   fprintf_symbol_filtered (stream, prefix, language_cplus, DMGL_ANSI);
 167   fprintf_symbol_filtered (stream, varstring, language_cplus, DMGL_ANSI);
 168   fputs_filtered ("(", stream);
 169
 170   /* Skip the class variable.  */
 171   i = staticp ? 0 : 1;
 172   if (nargs > i)
 173     {
 174       while (i < nargs)
 175         {
 176           type_print (args[i++].type, "", stream, 0);
 177
 178           if (i == nargs && varargs)
 179             fprintf_filtered (stream, ", ...");
 180           else if (i < nargs)
 181             fprintf_filtered (stream, ", ");
 182         }
 183     }
 184   else if (varargs)
 185     fprintf_filtered (stream, "...");
 186   else if (current_language->la_language == language_cplus)
 187     fprintf_filtered (stream, "void");
 188
 189   fprintf_filtered (stream, ")");
 190
 191   /* For non-static methods, read qualifiers from the type of
 192      THIS.  */
 193   if (!staticp)
 194     {
 195       struct type *domain;
 196
 197       gdb_assert (nargs > 0);
 198       gdb_assert (TYPE_CODE (args[0].type) == TYPE_CODE_PTR);
 199       domain = TYPE_TARGET_TYPE (args[0].type);
 200
 201       if (TYPE_CONST (domain))
 202         fprintf_filtered (stream, " const");
 203
 204       if (TYPE_VOLATILE (domain))
 205         fprintf_filtered (stream, " volatile");
 206     }
 207 }
 208
 209
 210 /* Print any asterisks or open-parentheses needed before the
 211    variable name (to describe its type).
 212
 213    On outermost call, pass 0 for PASSED_A_PTR.
 214    On outermost call, SHOW > 0 means should ignore
 215    any typename for TYPE and show its details.
 216    SHOW is always zero on recursive calls.
 217
 218    NEED_POST_SPACE is non-zero when a space will be be needed
 219    between a trailing qualifier and a field, variable, or function
 220    name.  */
 221
 222 static void
 223 c_type_print_varspec_prefix (struct type *type, struct ui_file *stream,
 224                              int show, int passed_a_ptr, int need_post_space)
 225 {
 226   char *name;
 227
 228   if (type == 0)
 229     return;
 230
 231   if (TYPE_NAME (type) && show <= 0)
 232     return;
 233
 234   QUIT;
 235
 236   switch (TYPE_CODE (type))
 237     {
 238     case TYPE_CODE_PTR:
 239       c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, show, 1, 1);
 240       fprintf_filtered (stream, "*");
 241       c_type_print_modifier (type, stream, 1, need_post_space);
 242       break;
 243
 244     case TYPE_CODE_MEMBERPTR:
 245       c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, show, 0, 0);
 246       name = type_name_no_tag (TYPE_DOMAIN_TYPE (type));
 247       if (name)
 248         fputs_filtered (name, stream);
 249       else
 250         c_type_print_base (TYPE_DOMAIN_TYPE (type), stream, 0, passed_a_ptr);
 251       fprintf_filtered (stream, "::*");
 252       break;
 253
 254     case TYPE_CODE_METHODPTR:
 255       c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, show, 0, 0);
 256       fprintf_filtered (stream, "(");
 257       name = type_name_no_tag (TYPE_DOMAIN_TYPE (type));
 258       if (name)
 259         fputs_filtered (name, stream);
 260       else
 261         c_type_print_base (TYPE_DOMAIN_TYPE (type), stream, 0, passed_a_ptr);
 262       fprintf_filtered (stream, "::*");
 263       break;
 264
 265     case TYPE_CODE_REF:
 266       c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, show, 1, 0);
 267       fprintf_filtered (stream, "&");
 268       c_type_print_modifier (type, stream, 1, need_post_space);
 269       break;
 270
 271     case TYPE_CODE_METHOD:
 272     case TYPE_CODE_FUNC:
 273       c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, show, 0, 0);
 274       if (passed_a_ptr)
 275         fprintf_filtered (stream, "(");
 276       break;
 277
 278     case TYPE_CODE_ARRAY:
 279       c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, show, 0, 0);
 280       if (passed_a_ptr)
 281         fprintf_filtered (stream, "(");
 282       break;
 283
 284     case TYPE_CODE_TYPEDEF:
 285       c_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, show, 0, 0);
 286       break;
 287
 288     case TYPE_CODE_UNDEF:
 289     case TYPE_CODE_STRUCT:
 290     case TYPE_CODE_UNION:
 291     case TYPE_CODE_ENUM:
 292     case TYPE_CODE_INT:
 293     case TYPE_CODE_FLT:
 294     case TYPE_CODE_VOID:
 295     case TYPE_CODE_ERROR:
 296     case TYPE_CODE_CHAR:
 297     case TYPE_CODE_BOOL:
 298     case TYPE_CODE_SET:
 299     case TYPE_CODE_RANGE:
 300     case TYPE_CODE_STRING:
 301     case TYPE_CODE_BITSTRING:
 302     case TYPE_CODE_COMPLEX:
 303     case TYPE_CODE_NAMESPACE:
 304     case TYPE_CODE_DECFLOAT:
 305       /* These types need no prefix.  They are listed here so that
 306          gcc -Wall will reveal any types that haven't been handled.  */
 307       break;
 308     default:
 309       error (_("type not handled in c_type_print_varspec_prefix()"));
 310       break;
 311     }
 312 }
 313
 314 /* Print out "const" and "volatile" attributes,
 315    and address space id if present.
 316    TYPE is a pointer to the type being printed out.
 317    STREAM is the output destination.
 318    NEED_PRE_SPACE = 1 indicates an initial white space is needed.
 319    NEED_POST_SPACE = 1 indicates a final white space is needed.  */
 320
 321 static void
 322 c_type_print_modifier (struct type *type, struct ui_file *stream,
 323                        int need_pre_space, int need_post_space)
 324 {
 325   int did_print_modifier = 0;
 326   const char *address_space_id;
 327
 328   /* We don't print `const' qualifiers for references --- since all
 329      operators affect the thing referenced, not the reference itself,
 330      every reference is `const'.  */
 331   if (TYPE_CONST (type)
 332       && TYPE_CODE (type) != TYPE_CODE_REF)
 333     {
 334       if (need_pre_space)
 335         fprintf_filtered (stream, " ");
 336       fprintf_filtered (stream, "const");
 337       did_print_modifier = 1;
 338     }
 339
 340   if (TYPE_VOLATILE (type))
 341     {
 342       if (did_print_modifier || need_pre_space)
 343         fprintf_filtered (stream, " ");
 344       fprintf_filtered (stream, "volatile");
 345       did_print_modifier = 1;
 346     }
 347
 348   address_space_id = address_space_int_to_name (get_type_arch (type),
 349                                                 TYPE_INSTANCE_FLAGS (type));
 350   if (address_space_id)
 351     {
 352       if (did_print_modifier || need_pre_space)
 353         fprintf_filtered (stream, " ");
 354       fprintf_filtered (stream, "@%s", address_space_id);
 355       did_print_modifier = 1;
 356     }
 357
 358   if (did_print_modifier && need_post_space)
 359     fprintf_filtered (stream, " ");
 360 }
 361
 362
 363 /* Print out the arguments of TYPE, which should have TYPE_CODE_METHOD
 364    or TYPE_CODE_FUNC, to STREAM.  Artificial arguments, such as "this"
 365    in non-static methods, are displayed if SHOW_ARTIFICIAL is
 366    non-zero. LANGUAGE is the language in which TYPE was defined.  This is
 367    a necessary evil since this code is used by the C, C++, and Java
 368    backends. */
 369
 370 void
 371 c_type_print_args (struct type *type, struct ui_file *stream,
 372                    int show_artificial, enum language language)
 373 {
 374   int i, len;
 375   struct field *args;
 376   int printed_any = 0;
 377
 378   fprintf_filtered (stream, "(");
 379   args = TYPE_FIELDS (type);
 380   len = TYPE_NFIELDS (type);
 381
 382   for (i = 0; i < TYPE_NFIELDS (type); i++)
 383     {
 384       if (TYPE_FIELD_ARTIFICIAL (type, i) && !show_artificial)
 385         continue;
 386
 387       if (printed_any)
 388         {
 389           fprintf_filtered (stream, ", ");
 390           wrap_here ("    ");
 391         }
 392
 393       if (language == language_java)
 394         java_print_type (TYPE_FIELD_TYPE (type, i), "", stream, -1, 0);
 395       else
 396         c_print_type (TYPE_FIELD_TYPE (type, i), "", stream, -1, 0);
 397       printed_any = 1;
 398     }
 399
 400   if (printed_any && TYPE_VARARGS (type))
 401     {
 402       /* Print out a trailing ellipsis for varargs functions.  Ignore
 403          TYPE_VARARGS if the function has no named arguments; that
 404          represents unprototyped (K&R style) C functions.  */
 405       if (printed_any && TYPE_VARARGS (type))
 406         {
 407           fprintf_filtered (stream, ", ");
 408           wrap_here ("    ");
 409           fprintf_filtered (stream, "...");
 410         }
 411     }
 412   else if (!printed_any
 413            && ((TYPE_PROTOTYPED (type) && language != language_java)
 414                || language == language_cplus))
 415     fprintf_filtered (stream, "void");
 416
 417   fprintf_filtered (stream, ")");
 418 }
 419
 420 /* Return true iff the j'th overloading of the i'th method of TYPE
 421    is a type conversion operator, like `operator int () { ... }'.
 422    When listing a class's methods, we don't print the return type of
 423    such operators.  */
 424
 425 static int
 426 is_type_conversion_operator (struct type *type, int i, int j)
 427 {
 428   /* I think the whole idea of recognizing type conversion operators
 429      by their name is pretty terrible.  But I don't think our present
 430      data structure gives us any other way to tell.  If you know of
 431      some other way, feel free to rewrite this function.  */
 432   char *name = TYPE_FN_FIELDLIST_NAME (type, i);
 433
 434   if (strncmp (name, "operator", 8) != 0)
 435     return 0;
 436
 437   name += 8;
 438   if (! strchr (" \t\f\n\r", *name))
 439     return 0;
 440
 441   while (strchr (" \t\f\n\r", *name))
 442     name++;
 443
 444   if (!('a' <= *name && *name <= 'z')
 445       && !('A' <= *name && *name <= 'Z')
 446       && *name != '_')
 447     /* If this doesn't look like the start of an identifier, then it
 448        isn't a type conversion operator.  */
 449     return 0;
 450   else if (strncmp (name, "new", 3) == 0)
 451     name += 3;
 452   else if (strncmp (name, "delete", 6) == 0)
 453     name += 6;
 454   else
 455     /* If it doesn't look like new or delete, it's a type conversion
 456        operator.  */
 457     return 1;
 458
 459   /* Is that really the end of the name?  */
 460   if (('a' <= *name && *name <= 'z')
 461       || ('A' <= *name && *name <= 'Z')
 462       || ('0' <= *name && *name <= '9')
 463       || *name == '_')
 464     /* No, so the identifier following "operator" must be a type name,
 465        and this is a type conversion operator.  */
 466     return 1;
 467
 468   /* That was indeed the end of the name, so it was `operator new' or
 469      `operator delete', neither of which are type conversion operators.  */
 470   return 0;
 471 }
 472
 473 /* Given a C++ qualified identifier QID, strip off the qualifiers,
 474    yielding the unqualified name.  The return value is a pointer into
 475    the original string.
 476
 477    It's a pity we don't have this information in some more structured
 478    form.  Even the author of this function feels that writing little
 479    parsers like this everywhere is stupid.  */
 480
 481 static char *
 482 remove_qualifiers (char *qid)
 483 {
 484   int quoted = 0;               /* zero if we're not in quotes;
 485                                    '"' if we're in a double-quoted string;
 486                                    '\'' if we're in a single-quoted string.  */
 487   int depth = 0;                /* number of unclosed parens we've seen */
 488   char *parenstack = (char *) alloca (strlen (qid));
 489   char *scan;
 490   char *last = 0;               /* The character after the rightmost
 491                                    `::' token we've seen so far.  */
 492
 493   for (scan = qid; *scan; scan++)
 494     {
 495       if (quoted)
 496         {
 497           if (*scan == quoted)
 498             quoted = 0;
 499           else if (*scan == '\\' && *(scan + 1))
 500             scan++;
 501         }
 502       else if (scan[0] == ':' && scan[1] == ':')
 503         {
 504           /* If we're inside parenthesis (i.e., an argument list) or
 505              angle brackets (i.e., a list of template arguments), then
 506              we don't record the position of this :: token, since it's
 507              not relevant to the top-level structure we're trying
 508              to operate on.  */
 509           if (depth == 0)
 510             {
 511               last = scan + 2;
 512               scan++;
 513             }
 514         }
 515       else if (*scan == '"' || *scan == '\'')
 516         quoted = *scan;
 517       else if (*scan == '(')
 518         parenstack[depth++] = ')';
 519       else if (*scan == '[')
 520         parenstack[depth++] = ']';
 521       /* We're going to treat <> as a pair of matching characters,
 522          since we're more likely to see those in template id's than
 523          real less-than characters.  What a crock.  */
 524       else if (*scan == '<')
 525         parenstack[depth++] = '>';
 526       else if (*scan == ')' || *scan == ']' || *scan == '>')
 527         {
 528           if (depth > 0 && parenstack[depth - 1] == *scan)
 529             depth--;
 530           else
 531             {
 532               /* We're going to do a little error recovery here.  If we
 533                  don't find a match for *scan on the paren stack, but
 534                  there is something lower on the stack that does match, we
 535                  pop the stack to that point.  */
 536               int i;
 537
 538               for (i = depth - 1; i >= 0; i--)
 539                 if (parenstack[i] == *scan)
 540                   {
 541                     depth = i;
 542                     break;
 543                   }
 544             }
 545         }
 546     }
 547
 548   if (last)
 549     return last;
 550   else
 551     /* We didn't find any :: tokens at the top level, so declare the
 552        whole thing an unqualified identifier.  */
 553     return qid;
 554 }
 555
 556 /* Print any array sizes, function arguments or close parentheses
 557    needed after the variable name (to describe its type).
 558    Args work like c_type_print_varspec_prefix.  */
 559
 560 void
 561 c_type_print_varspec_suffix (struct type *type, struct ui_file *stream,
 562                              int show, int passed_a_ptr, int demangled_args)
 563 {
 564   if (type == 0)
 565     return;
 566
 567   if (TYPE_NAME (type) && show <= 0)
 568     return;
 569
 570   QUIT;
 571
 572   switch (TYPE_CODE (type))
 573     {
 574     case TYPE_CODE_ARRAY:
 575       if (passed_a_ptr)
 576         fprintf_filtered (stream, ")");
 577
 578       fprintf_filtered (stream, "[");
 579       if (TYPE_LENGTH (TYPE_TARGET_TYPE (type)) > 0
 580         && !TYPE_ARRAY_UPPER_BOUND_IS_UNDEFINED (type))
 581         fprintf_filtered (stream, "%d",
 582                           (TYPE_LENGTH (type)
 583                            / TYPE_LENGTH (TYPE_TARGET_TYPE (type))));
 584       fprintf_filtered (stream, "]");
 585
 586       c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, show,
 587                                    0, 0);
 588       break;
 589
 590     case TYPE_CODE_MEMBERPTR:
 591       c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, show,
 592                                    0, 0);
 593       break;
 594
 595     case TYPE_CODE_METHODPTR:
 596       fprintf_filtered (stream, ")");
 597       c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, show,
 598                                    0, 0);
 599       break;
 600
 601     case TYPE_CODE_PTR:
 602     case TYPE_CODE_REF:
 603       c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, show,
 604                                    1, 0);
 605       break;
 606
 607     case TYPE_CODE_METHOD:
 608     case TYPE_CODE_FUNC:
 609       if (passed_a_ptr)
 610         fprintf_filtered (stream, ")");
 611       if (!demangled_args)
 612         c_type_print_args (type, stream, 1, current_language->la_language);
 613       c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, show,
 614                                    passed_a_ptr, 0);
 615       break;
 616
 617     case TYPE_CODE_TYPEDEF:
 618       c_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, show,
 619                                    passed_a_ptr, 0);
 620       break;
 621
 622     case TYPE_CODE_UNDEF:
 623     case TYPE_CODE_STRUCT:
 624     case TYPE_CODE_UNION:
 625     case TYPE_CODE_ENUM:
 626     case TYPE_CODE_INT:
 627     case TYPE_CODE_FLT:
 628     case TYPE_CODE_VOID:
 629     case TYPE_CODE_ERROR:
 630     case TYPE_CODE_CHAR:
 631     case TYPE_CODE_BOOL:
 632     case TYPE_CODE_SET:
 633     case TYPE_CODE_RANGE:
 634     case TYPE_CODE_STRING:
 635     case TYPE_CODE_BITSTRING:
 636     case TYPE_CODE_COMPLEX:
 637     case TYPE_CODE_NAMESPACE:
 638     case TYPE_CODE_DECFLOAT:
 639       /* These types do not need a suffix.  They are listed so that
 640          gcc -Wall will report types that may not have been considered.  */
 641       break;
 642     default:
 643       error (_("type not handled in c_type_print_varspec_suffix()"));
 644       break;
 645     }
 646 }
 647
 648 /* Print the name of the type (or the ultimate pointer target,
 649    function value or array element), or the description of a
 650    structure or union.
 651
 652    SHOW positive means print details about the type (e.g. enum values),
 653    and print structure elements passing SHOW - 1 for show.
 654    SHOW negative means just print the type name or struct tag if there is one.
 655    If there is no name, print something sensible but concise like
 656    "struct {...}".
 657    SHOW zero means just print the type name or struct tag if there is one.
 658    If there is no name, print something sensible but not as concise like
 659    "struct {int x; int y;}".
 660
 661    LEVEL is the number of spaces to indent by.
 662    We increase it for some recursive calls.  */
 663
 664 void
 665 c_type_print_base (struct type *type, struct ui_file *stream, int show,
 666                    int level)
 667 {
 668   int i;
 669   int len, real_len;
 670   int lastval;
 671   char *mangled_name;
 672   char *demangled_name;
 673   char *demangled_no_static;
 674   enum
 675     {
 676       s_none, s_public, s_private, s_protected
 677     }
 678   section_type;
 679   int need_access_label = 0;
 680   int j, len2;
 681
 682   QUIT;
 683
 684   wrap_here ("    ");
 685   if (type == NULL)
 686     {
 687       fputs_filtered (_("<type unknown>"), stream);
 688       return;
 689     }
 690
 691   /* When SHOW is zero or less, and there is a valid type name, then always
 692      just print the type name directly from the type.  */
 693   /* If we have "typedef struct foo {. . .} bar;" do we want to print it
 694      as "struct foo" or as "bar"?  Pick the latter, because C++ folk tend
 695      to expect things like "class5 *foo" rather than "struct class5 *foo".  */
 696
 697   if (show <= 0
 698       && TYPE_NAME (type) != NULL)
 699     {
 700       c_type_print_modifier (type, stream, 0, 1);
 701       fputs_filtered (TYPE_NAME (type), stream);
 702       return;
 703     }
 704
 705   CHECK_TYPEDEF (type);
 706
 707   switch (TYPE_CODE (type))
 708     {
 709     case TYPE_CODE_TYPEDEF:
 710     case TYPE_CODE_ARRAY:
 711     case TYPE_CODE_PTR:
 712     case TYPE_CODE_MEMBERPTR:
 713     case TYPE_CODE_REF:
 714     case TYPE_CODE_FUNC:
 715     case TYPE_CODE_METHOD:
 716     case TYPE_CODE_METHODPTR:
 717       c_type_print_base (TYPE_TARGET_TYPE (type), stream, show, level);
 718       break;
 719
 720     case TYPE_CODE_STRUCT:
 721       c_type_print_modifier (type, stream, 0, 1);
 722       if (TYPE_DECLARED_CLASS (type))
 723         fprintf_filtered (stream, "class ");
 724       else
 725         fprintf_filtered (stream, "struct ");
 726       goto struct_union;
 727
 728     case TYPE_CODE_UNION:
 729       c_type_print_modifier (type, stream, 0, 1);
 730       fprintf_filtered (stream, "union ");
 731
 732     struct_union:
 733
 734       /* Print the tag if it exists.
 735        * The HP aCC compiler emits
 736        * a spurious "{unnamed struct}"/"{unnamed union}"/"{unnamed enum}"
 737        * tag  for unnamed struct/union/enum's, which we don't
 738        * want to print.
 739        */
 740       if (TYPE_TAG_NAME (type) != NULL
 741           && strncmp (TYPE_TAG_NAME (type), "{unnamed", 8))
 742         {
 743           fputs_filtered (TYPE_TAG_NAME (type), stream);
 744           if (show > 0)
 745             fputs_filtered (" ", stream);
 746         }
 747       wrap_here ("    ");
 748       if (show < 0)
 749         {
 750           /* If we just printed a tag name, no need to print anything else.  */
 751           if (TYPE_TAG_NAME (type) == NULL)
 752             fprintf_filtered (stream, "{...}");
 753         }
 754       else if (show > 0 || TYPE_TAG_NAME (type) == NULL)
 755         {
 756           struct type *basetype;
 757           int vptr_fieldno;
 758
 759           cp_type_print_derivation_info (stream, type);
 760
 761           fprintf_filtered (stream, "{\n");
 762           if (TYPE_NFIELDS (type) == 0 && TYPE_NFN_FIELDS (type) == 0
 763               && TYPE_TYPEDEF_FIELD_COUNT (type) == 0)
 764             {
 765               if (TYPE_STUB (type))
 766                 fprintfi_filtered (level + 4, stream, _("<incomplete type>\n"));
 767               else
 768                 fprintfi_filtered (level + 4, stream, _("<no data fields>\n"));
 769             }
 770
 771           /* Start off with no specific section type, so we can print
 772              one for the first field we find, and use that section type
 773              thereafter until we find another type. */
 774
 775           section_type = s_none;
 776
 777           /* For a class, if all members are private, there's no need
 778              for a "private:" label; similarly, for a struct or union
 779              masquerading as a class, if all members are public, there's
 780              no need for a "public:" label. */
 781
 782           if (TYPE_DECLARED_CLASS (type))
 783             {
 784               QUIT;
 785               len = TYPE_NFIELDS (type);
 786               for (i = TYPE_N_BASECLASSES (type); i < len; i++)
 787                 if (!TYPE_FIELD_PRIVATE (type, i))
 788                   {
 789                     need_access_label = 1;
 790                     break;
 791                   }
 792               QUIT;
 793               if (!need_access_label)
 794                 {
 795                   len2 = TYPE_NFN_FIELDS (type);
 796                   for (j = 0; j < len2; j++)
 797                     {
 798                       len = TYPE_FN_FIELDLIST_LENGTH (type, j);
 799                       for (i = 0; i < len; i++)
 800                         if (!TYPE_FN_FIELD_PRIVATE (TYPE_FN_FIELDLIST1 (type, j), i))
 801                           {
 802                             need_access_label = 1;
 803                             break;
 804                           }
 805                       if (need_access_label)
 806                         break;
 807                     }
 808                 }
 809             }
 810           else
 811             {
 812               QUIT;
 813               len = TYPE_NFIELDS (type);
 814               for (i = TYPE_N_BASECLASSES (type); i < len; i++)
 815                 if (TYPE_FIELD_PRIVATE (type, i) || TYPE_FIELD_PROTECTED (type, i))
 816                   {
 817                     need_access_label = 1;
 818                     break;
 819                   }
 820               QUIT;
 821               if (!need_access_label)
 822                 {
 823                   len2 = TYPE_NFN_FIELDS (type);
 824                   for (j = 0; j < len2; j++)
 825                     {
 826                       QUIT;
 827                       len = TYPE_FN_FIELDLIST_LENGTH (type, j);
 828                       for (i = 0; i < len; i++)
 829                         if (TYPE_FN_FIELD_PRIVATE (TYPE_FN_FIELDLIST1 (type, j), i)
 830                             || TYPE_FN_FIELD_PROTECTED (TYPE_FN_FIELDLIST1 (type, j), i))
 831                           {
 832                             need_access_label = 1;
 833                             break;
 834                           }
 835                       if (need_access_label)
 836                         break;
 837                     }
 838                 }
 839             }
 840
 841           /* If there is a base class for this type,
 842              do not print the field that it occupies.  */
 843
 844           len = TYPE_NFIELDS (type);
 845           vptr_fieldno = get_vptr_fieldno (type, &basetype);
 846           for (i = TYPE_N_BASECLASSES (type); i < len; i++)
 847             {
 848               QUIT;
 849
 850               /* If we have a virtual table pointer, omit it.  Even if
 851                  virtual table pointers are not specifically marked in
 852                  the debug info, they should be artificial.  */
 853               if ((i == vptr_fieldno && type == basetype)
 854                   || TYPE_FIELD_ARTIFICIAL (type, i))
 855                 continue;
 856
 857               if (need_access_label)
 858                 {
 859                   if (TYPE_FIELD_PROTECTED (type, i))
 860                     {
 861                       if (section_type != s_protected)
 862                         {
 863                           section_type = s_protected;
 864                           fprintfi_filtered (level + 2, stream,
 865                                              "protected:\n");
 866                         }
 867                     }
 868                   else if (TYPE_FIELD_PRIVATE (type, i))
 869                     {
 870                       if (section_type != s_private)
 871                         {
 872                           section_type = s_private;
 873                           fprintfi_filtered (level + 2, stream, "private:\n");
 874                         }
 875                     }
 876                   else
 877                     {
 878                       if (section_type != s_public)
 879                         {
 880                           section_type = s_public;
 881                           fprintfi_filtered (level + 2, stream, "public:\n");
 882                         }
 883                     }
 884                 }
 885
 886               print_spaces_filtered (level + 4, stream);
 887               if (field_is_static (&TYPE_FIELD (type, i)))
 888                 fprintf_filtered (stream, "static ");
 889               c_print_type (TYPE_FIELD_TYPE (type, i),
 890                             TYPE_FIELD_NAME (type, i),
 891                             stream, show - 1, level + 4);
 892               if (!field_is_static (&TYPE_FIELD (type, i))
 893                   && TYPE_FIELD_PACKED (type, i))
 894                 {
 895                   /* It is a bitfield.  This code does not attempt
 896                      to look at the bitpos and reconstruct filler,
 897                      unnamed fields.  This would lead to misleading
 898                      results if the compiler does not put out fields
 899                      for such things (I don't know what it does).  */
 900                   fprintf_filtered (stream, " : %d",
 901                                     TYPE_FIELD_BITSIZE (type, i));
 902                 }
 903               fprintf_filtered (stream, ";\n");
 904             }
 905
 906           /* If there are both fields and methods, put a blank line
 907               between them.  Make sure to count only method that we will
 908               display; artificial methods will be hidden.  */
 909           len = TYPE_NFN_FIELDS (type);
 910           real_len = 0;
 911           for (i = 0; i < len; i++)
 912             {
 913               struct fn_field *f = TYPE_FN_FIELDLIST1 (type, i);
 914               int len2 = TYPE_FN_FIELDLIST_LENGTH (type, i);
 915               int j;
 916
 917               for (j = 0; j < len2; j++)
 918                 if (!TYPE_FN_FIELD_ARTIFICIAL (f, j))
 919                   real_len++;
 920             }
 921           if (real_len > 0 && section_type != s_none)
 922             fprintf_filtered (stream, "\n");
 923
 924           /* C++: print out the methods */
 925           for (i = 0; i < len; i++)
 926             {
 927               struct fn_field *f = TYPE_FN_FIELDLIST1 (type, i);
 928               int j, len2 = TYPE_FN_FIELDLIST_LENGTH (type, i);
 929               char *method_name = TYPE_FN_FIELDLIST_NAME (type, i);
 930               char *name = type_name_no_tag (type);
 931               int is_constructor = name && strcmp (method_name, name) == 0;
 932
 933               for (j = 0; j < len2; j++)
 934                 {
 935                   char *physname = TYPE_FN_FIELD_PHYSNAME (f, j);
 936                   int is_full_physname_constructor =
 937                     is_constructor_name (physname)
 938                     || is_destructor_name (physname)
 939                     || method_name[0] == '~';
 940
 941                   /* Do not print out artificial methods.  */
 942                   if (TYPE_FN_FIELD_ARTIFICIAL (f, j))
 943                     continue;
 944
 945                   QUIT;
 946                   if (TYPE_FN_FIELD_PROTECTED (f, j))
 947                     {
 948                       if (section_type != s_protected)
 949                         {
 950                           section_type = s_protected;
 951                           fprintfi_filtered (level + 2, stream,
 952                                              "protected:\n");
 953                         }
 954                     }
 955                   else if (TYPE_FN_FIELD_PRIVATE (f, j))
 956                     {
 957                       if (section_type != s_private)
 958                         {
 959                           section_type = s_private;
 960                           fprintfi_filtered (level + 2, stream, "private:\n");
 961                         }
 962                     }
 963                   else
 964                     {
 965                       if (section_type != s_public)
 966                         {
 967                           section_type = s_public;
 968                           fprintfi_filtered (level + 2, stream, "public:\n");
 969                         }
 970                     }
 971
 972                   print_spaces_filtered (level + 4, stream);
 973                   if (TYPE_FN_FIELD_VIRTUAL_P (f, j))
 974                     fprintf_filtered (stream, "virtual ");
 975                   else if (TYPE_FN_FIELD_STATIC_P (f, j))
 976                     fprintf_filtered (stream, "static ");
 977                   if (TYPE_TARGET_TYPE (TYPE_FN_FIELD_TYPE (f, j)) == 0)
 978                     {
 979                       /* Keep GDB from crashing here.  */
 980                       fprintf_filtered (stream, _("<undefined type> %s;\n"),
 981                                         TYPE_FN_FIELD_PHYSNAME (f, j));
 982                       break;
 983                     }
 984                   else if (!is_constructor      /* constructors don't have declared types */
 985                            && !is_full_physname_constructor     /*    " "  */
 986                            && !is_type_conversion_operator (type, i, j))
 987                     {
 988                       type_print (TYPE_TARGET_TYPE (TYPE_FN_FIELD_TYPE (f, j)),
 989                                   "", stream, -1);
 990                       fputs_filtered (" ", stream);
 991                     }
 992                   if (TYPE_FN_FIELD_STUB (f, j))
 993                     /* Build something we can demangle.  */
 994                     mangled_name = gdb_mangle_name (type, i, j);
 995                   else
 996                     mangled_name = TYPE_FN_FIELD_PHYSNAME (f, j);
 997
 998                   demangled_name =
 999                     cplus_demangle (mangled_name,
1000                                     DMGL_ANSI | DMGL_PARAMS);
1001                   if (demangled_name == NULL)
1002                     {
1003                       /* in some cases (for instance with the HP demangling),
1004                          if a function has more than 10 arguments,
1005                          the demangling will fail.
1006                          Let's try to reconstruct the function signature from
1007                          the symbol information */
1008                       if (!TYPE_FN_FIELD_STUB (f, j))
1009                         {
1010                           int staticp = TYPE_FN_FIELD_STATIC_P (f, j);
1011                           struct type *mtype = TYPE_FN_FIELD_TYPE (f, j);
1012
1013                           cp_type_print_method_args (mtype,
1014                                                      "",
1015                                                      method_name,
1016                                                      staticp,
1017                                                      stream);
1018                         }
1019                       else
1020                         fprintf_filtered (stream, _("<badly mangled name '%s'>"),
1021                                           mangled_name);
1022                     }
1023                   else
1024                     {
1025                       char *p;
1026                       char *demangled_no_class
1027                         = remove_qualifiers (demangled_name);
1028
1029                       /* get rid of the `static' appended by the demangler */
1030                       p = strstr (demangled_no_class, " static");
1031                       if (p != NULL)
1032                         {
1033                           int length = p - demangled_no_class;
1034
1035                           demangled_no_static = (char *) xmalloc (length + 1);
1036                           strncpy (demangled_no_static, demangled_no_class, length);
1037                           *(demangled_no_static + length) = '\0';
1038                           fputs_filtered (demangled_no_static, stream);
1039                           xfree (demangled_no_static);
1040                         }
1041                       else
1042                         fputs_filtered (demangled_no_class, stream);
1043                       xfree (demangled_name);
1044                     }
1045
1046                   if (TYPE_FN_FIELD_STUB (f, j))
1047                     xfree (mangled_name);
1048
1049                   fprintf_filtered (stream, ";\n");
1050                 }
1051             }
1052
1053           /* Print typedefs defined in this class.  */
1054
1055           if (TYPE_TYPEDEF_FIELD_COUNT (type) != 0)
1056             {
1057               if (TYPE_NFIELDS (type) != 0 || TYPE_NFN_FIELDS (type) != 0)
1058                 fprintf_filtered (stream, "\n");
1059
1060               for (i = 0; i < TYPE_TYPEDEF_FIELD_COUNT (type); i++)
1061                 {
1062                   struct type *target = TYPE_TYPEDEF_FIELD_TYPE (type, i);
1063
1064                   /* Dereference the typedef declaration itself.  */
1065                   gdb_assert (TYPE_CODE (target) == TYPE_CODE_TYPEDEF);
1066                   target = TYPE_TARGET_TYPE (target);
1067
1068                   print_spaces_filtered (level + 4, stream);
1069                   fprintf_filtered (stream, "typedef ");
1070                   c_print_type (target, TYPE_TYPEDEF_FIELD_NAME (type, i),
1071                                 stream, show - 1, level + 4);
1072                   fprintf_filtered (stream, ";\n");
1073                 }
1074             }
1075
1076           fprintfi_filtered (level, stream, "}");
1077
1078           if (TYPE_LOCALTYPE_PTR (type) && show >= 0)
1079             fprintfi_filtered (level, stream, _(" (Local at %s:%d)\n"),
1080                                TYPE_LOCALTYPE_FILE (type),
1081                                TYPE_LOCALTYPE_LINE (type));
1082         }
1083       break;
1084
1085     case TYPE_CODE_ENUM:
1086       c_type_print_modifier (type, stream, 0, 1);
1087       fprintf_filtered (stream, "enum ");
1088       /* Print the tag name if it exists.
1089          The aCC compiler emits a spurious
1090          "{unnamed struct}"/"{unnamed union}"/"{unnamed enum}"
1091          tag for unnamed struct/union/enum's, which we don't
1092          want to print. */
1093       if (TYPE_TAG_NAME (type) != NULL
1094           && strncmp (TYPE_TAG_NAME (type), "{unnamed", 8))
1095         {
1096           fputs_filtered (TYPE_TAG_NAME (type), stream);
1097           if (show > 0)
1098             fputs_filtered (" ", stream);
1099         }
1100
1101       wrap_here ("    ");
1102       if (show < 0)
1103         {
1104           /* If we just printed a tag name, no need to print anything else.  */
1105           if (TYPE_TAG_NAME (type) == NULL)
1106             fprintf_filtered (stream, "{...}");
1107         }
1108       else if (show > 0 || TYPE_TAG_NAME (type) == NULL)
1109         {
1110           fprintf_filtered (stream, "{");
1111           len = TYPE_NFIELDS (type);
1112           lastval = 0;
1113           for (i = 0; i < len; i++)
1114             {
1115               QUIT;
1116               if (i)
1117                 fprintf_filtered (stream, ", ");
1118               wrap_here ("    ");
1119               fputs_filtered (TYPE_FIELD_NAME (type, i), stream);
1120               if (lastval != TYPE_FIELD_BITPOS (type, i))
1121                 {
1122                   fprintf_filtered (stream, " = %d", TYPE_FIELD_BITPOS (type, i));
1123                   lastval = TYPE_FIELD_BITPOS (type, i);
1124                 }
1125               lastval++;
1126             }
1127           fprintf_filtered (stream, "}");
1128         }
1129       break;
1130
1131     case TYPE_CODE_VOID:
1132       fprintf_filtered (stream, "void");
1133       break;
1134
1135     case TYPE_CODE_UNDEF:
1136       fprintf_filtered (stream, _("struct <unknown>"));
1137       break;
1138
1139     case TYPE_CODE_ERROR:
1140       fprintf_filtered (stream, "%s", TYPE_ERROR_NAME (type));
1141       break;
1142
1143     case TYPE_CODE_RANGE:
1144       /* This should not occur */
1145       fprintf_filtered (stream, _("<range type>"));
1146       break;
1147
1148     case TYPE_CODE_NAMESPACE:
1149       fputs_filtered ("namespace ", stream);
1150       fputs_filtered (TYPE_TAG_NAME (type), stream);
1151       break;
1152
1153     default:
1154       /* Handle types not explicitly handled by the other cases,
1155          such as fundamental types.  For these, just print whatever
1156          the type name is, as recorded in the type itself.  If there
1157          is no type name, then complain. */
1158       if (TYPE_NAME (type) != NULL)
1159         {
1160           c_type_print_modifier (type, stream, 0, 1);
1161           fputs_filtered (TYPE_NAME (type), stream);
1162         }
1163       else
1164         {
1165           /* At least for dump_symtab, it is important that this not be
1166              an error ().  */
1167           fprintf_filtered (stream, _("<invalid type code %d>"),
1168                             TYPE_CODE (type));
1169         }
1170       break;
1171     }
1172 }