gdb/f-typeprint.c

   1 /* Support for printing Fortran types for GDB, the GNU debugger.
   2
   3    Copyright (C) 1986-2017 Free Software Foundation, Inc.
   4
   5    Contributed by Motorola.  Adapted from the C version by Farooq Butt
   6    (fmbutt@engage.sps.mot.com).
   7
   8    This file is part of GDB.
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 3 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  22
  23 #include "defs.h"
  24 #include "gdb_obstack.h"
  25 #include "bfd.h"
  26 #include "symtab.h"
  27 #include "gdbtypes.h"
  28 #include "expression.h"
  29 #include "value.h"
  30 #include "gdbcore.h"
  31 #include "target.h"
  32 #include "f-lang.h"
  33 #include "typeprint.h"
  34
  35 #if 0                           /* Currently unused.  */
  36 static void f_type_print_args (struct type *, struct ui_file *);
  37 #endif
  38
  39 static void f_type_print_varspec_suffix (struct type *, struct ui_file *, int,
  40                                          int, int, int);
  41
  42 void f_type_print_varspec_prefix (struct type *, struct ui_file *,
  43                                   int, int);
  44
  45 void f_type_print_base (struct type *, struct ui_file *, int, int);
  46 \f
  47
  48 /* LEVEL is the depth to indent lines by.  */
  49
  50 void
  51 f_print_type (struct type *type, const char *varstring, struct ui_file *stream,
  52               int show, int level, const struct type_print_options *flags)
  53 {
  54   enum type_code code;
  55
  56   if (type_not_associated (type))
  57     {
  58       val_print_not_associated (stream);
  59       return;
  60     }
  61
  62   if (type_not_allocated (type))
  63     {
  64       val_print_not_allocated (stream);
  65       return;
  66     }
  67
  68   f_type_print_base (type, stream, show, level);
  69   code = TYPE_CODE (type);
  70   if ((varstring != NULL && *varstring != '\0')
  71   /* Need a space if going to print stars or brackets;
  72      but not if we will print just a type name.  */
  73       || ((show > 0 || TYPE_NAME (type) == 0)
  74           && (code == TYPE_CODE_PTR || code == TYPE_CODE_FUNC
  75               || code == TYPE_CODE_METHOD
  76               || code == TYPE_CODE_ARRAY
  77               || code == TYPE_CODE_REF)))
  78     fputs_filtered (" ", stream);
  79   f_type_print_varspec_prefix (type, stream, show, 0);
  80
  81   if (varstring != NULL)
  82     {
  83       int demangled_args;
  84
  85       fputs_filtered (varstring, stream);
  86
  87       /* For demangled function names, we have the arglist as part of the name,
  88          so don't print an additional pair of ()'s.  */
  89
  90       demangled_args = (*varstring != '\0'
  91                         && varstring[strlen (varstring) - 1] == ')');
  92       f_type_print_varspec_suffix (type, stream, show, 0, demangled_args, 0);
  93    }
  94 }
  95
  96 /* Print any asterisks or open-parentheses needed before the
  97    variable name (to describe its type).
  98
  99    On outermost call, pass 0 for PASSED_A_PTR.
 100    On outermost call, SHOW > 0 means should ignore
 101    any typename for TYPE and show its details.
 102    SHOW is always zero on recursive calls.  */
 103
 104 void
 105 f_type_print_varspec_prefix (struct type *type, struct ui_file *stream,
 106                              int show, int passed_a_ptr)
 107 {
 108   if (type == 0)
 109     return;
 110
 111   if (TYPE_NAME (type) && show <= 0)
 112     return;
 113
 114   QUIT;
 115
 116   switch (TYPE_CODE (type))
 117     {
 118     case TYPE_CODE_PTR:
 119       f_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 1);
 120       break;
 121
 122     case TYPE_CODE_FUNC:
 123       f_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 0);
 124       if (passed_a_ptr)
 125         fprintf_filtered (stream, "(");
 126       break;
 127
 128     case TYPE_CODE_ARRAY:
 129       f_type_print_varspec_prefix (TYPE_TARGET_TYPE (type), stream, 0, 0);
 130       break;
 131
 132     case TYPE_CODE_UNDEF:
 133     case TYPE_CODE_STRUCT:
 134     case TYPE_CODE_UNION:
 135     case TYPE_CODE_ENUM:
 136     case TYPE_CODE_INT:
 137     case TYPE_CODE_FLT:
 138     case TYPE_CODE_VOID:
 139     case TYPE_CODE_ERROR:
 140     case TYPE_CODE_CHAR:
 141     case TYPE_CODE_BOOL:
 142     case TYPE_CODE_SET:
 143     case TYPE_CODE_RANGE:
 144     case TYPE_CODE_STRING:
 145     case TYPE_CODE_METHOD:
 146     case TYPE_CODE_REF:
 147     case TYPE_CODE_COMPLEX:
 148     case TYPE_CODE_TYPEDEF:
 149       /* These types need no prefix.  They are listed here so that
 150          gcc -Wall will reveal any types that haven't been handled.  */
 151       break;
 152     }
 153 }
 154
 155 /* Print any array sizes, function arguments or close parentheses
 156    needed after the variable name (to describe its type).
 157    Args work like c_type_print_varspec_prefix.  */
 158
 159 static void
 160 f_type_print_varspec_suffix (struct type *type, struct ui_file *stream,
 161                              int show, int passed_a_ptr, int demangled_args,
 162                              int arrayprint_recurse_level)
 163 {
 164   int upper_bound, lower_bound;
 165
 166   /* No static variables are permitted as an error call may occur during
 167      execution of this function.  */
 168
 169   if (type == 0)
 170     return;
 171
 172   if (TYPE_NAME (type) && show <= 0)
 173     return;
 174
 175   QUIT;
 176
 177   switch (TYPE_CODE (type))
 178     {
 179     case TYPE_CODE_ARRAY:
 180       arrayprint_recurse_level++;
 181
 182       if (arrayprint_recurse_level == 1)
 183         fprintf_filtered (stream, "(");
 184
 185       if (type_not_associated (type))
 186         val_print_not_associated (stream);
 187       else if (type_not_allocated (type))
 188         val_print_not_allocated (stream);
 189       else
 190         {
 191           if (TYPE_CODE (TYPE_TARGET_TYPE (type)) == TYPE_CODE_ARRAY)
 192             f_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0,
 193                                         0, 0, arrayprint_recurse_level);
 194
 195           lower_bound = f77_get_lowerbound (type);
 196           if (lower_bound != 1) /* Not the default.  */
 197             fprintf_filtered (stream, "%d:", lower_bound);
 198
 199           /* Make sure that, if we have an assumed size array, we
 200              print out a warning and print the upperbound as '*'.  */
 201
 202           if (TYPE_ARRAY_UPPER_BOUND_IS_UNDEFINED (type))
 203             fprintf_filtered (stream, "*");
 204           else
 205             {
 206               upper_bound = f77_get_upperbound (type);
 207               fprintf_filtered (stream, "%d", upper_bound);
 208             }
 209
 210           if (TYPE_CODE (TYPE_TARGET_TYPE (type)) != TYPE_CODE_ARRAY)
 211             f_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0,
 212                                         0, 0, arrayprint_recurse_level);
 213         }
 214       if (arrayprint_recurse_level == 1)
 215         fprintf_filtered (stream, ")");
 216       else
 217         fprintf_filtered (stream, ",");
 218       arrayprint_recurse_level--;
 219       break;
 220
 221     case TYPE_CODE_PTR:
 222     case TYPE_CODE_REF:
 223       f_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0, 1, 0,
 224                                    arrayprint_recurse_level);
 225       fprintf_filtered (stream, ")");
 226       break;
 227
 228     case TYPE_CODE_FUNC:
 229       f_type_print_varspec_suffix (TYPE_TARGET_TYPE (type), stream, 0,
 230                                    passed_a_ptr, 0, arrayprint_recurse_level);
 231       if (passed_a_ptr)
 232         fprintf_filtered (stream, ")");
 233
 234       fprintf_filtered (stream, "()");
 235       break;
 236
 237     case TYPE_CODE_UNDEF:
 238     case TYPE_CODE_STRUCT:
 239     case TYPE_CODE_UNION:
 240     case TYPE_CODE_ENUM:
 241     case TYPE_CODE_INT:
 242     case TYPE_CODE_FLT:
 243     case TYPE_CODE_VOID:
 244     case TYPE_CODE_ERROR:
 245     case TYPE_CODE_CHAR:
 246     case TYPE_CODE_BOOL:
 247     case TYPE_CODE_SET:
 248     case TYPE_CODE_RANGE:
 249     case TYPE_CODE_STRING:
 250     case TYPE_CODE_METHOD:
 251     case TYPE_CODE_COMPLEX:
 252     case TYPE_CODE_TYPEDEF:
 253       /* These types do not need a suffix.  They are listed so that
 254          gcc -Wall will report types that may not have been considered.  */
 255       break;
 256     }
 257 }
 258
 259 /* Print the name of the type (or the ultimate pointer target,
 260    function value or array element), or the description of a
 261    structure or union.
 262
 263    SHOW nonzero means don't print this type as just its name;
 264    show its real definition even if it has a name.
 265    SHOW zero means print just typename or struct tag if there is one
 266    SHOW negative means abbreviate structure elements.
 267    SHOW is decremented for printing of structure elements.
 268
 269    LEVEL is the depth to indent by.
 270    We increase it for some recursive calls.  */
 271
 272 void
 273 f_type_print_base (struct type *type, struct ui_file *stream, int show,
 274                    int level)
 275 {
 276   int upper_bound;
 277   int index;
 278
 279   QUIT;
 280
 281   wrap_here ("    ");
 282   if (type == NULL)
 283     {
 284       fputs_filtered ("<type unknown>", stream);
 285       return;
 286     }
 287
 288   /* When SHOW is zero or less, and there is a valid type name, then always
 289      just print the type name directly from the type.  */
 290
 291   if ((show <= 0) && (TYPE_NAME (type) != NULL))
 292     {
 293       fprintfi_filtered (level, stream, "%s", TYPE_NAME (type));
 294       return;
 295     }
 296
 297   if (TYPE_CODE (type) != TYPE_CODE_TYPEDEF)
 298     type = check_typedef (type);
 299
 300   switch (TYPE_CODE (type))
 301     {
 302     case TYPE_CODE_TYPEDEF:
 303       f_type_print_base (TYPE_TARGET_TYPE (type), stream, 0, level);
 304       break;
 305
 306     case TYPE_CODE_ARRAY:
 307       f_type_print_base (TYPE_TARGET_TYPE (type), stream, show, level);
 308       break;
 309     case TYPE_CODE_FUNC:
 310       if (TYPE_TARGET_TYPE (type) == NULL)
 311         type_print_unknown_return_type (stream);
 312       else
 313         f_type_print_base (TYPE_TARGET_TYPE (type), stream, show, level);
 314       break;
 315
 316     case TYPE_CODE_PTR:
 317       fprintfi_filtered (level, stream, "PTR TO -> ( ");
 318       f_type_print_base (TYPE_TARGET_TYPE (type), stream, show, 0);
 319       break;
 320
 321     case TYPE_CODE_REF:
 322       fprintfi_filtered (level, stream, "REF TO -> ( ");
 323       f_type_print_base (TYPE_TARGET_TYPE (type), stream, show, 0);
 324       break;
 325
 326     case TYPE_CODE_VOID:
 327       fprintfi_filtered (level, stream, "VOID");
 328       break;
 329
 330     case TYPE_CODE_UNDEF:
 331       fprintfi_filtered (level, stream, "struct <unknown>");
 332       break;
 333
 334     case TYPE_CODE_ERROR:
 335       fprintfi_filtered (level, stream, "%s", TYPE_ERROR_NAME (type));
 336       break;
 337
 338     case TYPE_CODE_RANGE:
 339       /* This should not occur.  */
 340       fprintfi_filtered (level, stream, "<range type>");
 341       break;
 342
 343     case TYPE_CODE_CHAR:
 344     case TYPE_CODE_INT:
 345       /* There may be some character types that attempt to come
 346          through as TYPE_CODE_INT since dbxstclass.h is so
 347          C-oriented, we must change these to "character" from "char".  */
 348
 349       if (strcmp (TYPE_NAME (type), "char") == 0)
 350         fprintfi_filtered (level, stream, "character");
 351       else
 352         goto default_case;
 353       break;
 354
 355     case TYPE_CODE_STRING:
 356       /* Strings may have dynamic upperbounds (lengths) like arrays.  */
 357
 358       if (TYPE_ARRAY_UPPER_BOUND_IS_UNDEFINED (type))
 359         fprintfi_filtered (level, stream, "character*(*)");
 360       else
 361         {
 362           upper_bound = f77_get_upperbound (type);
 363           fprintf_filtered (stream, "character*%d", upper_bound);
 364         }
 365       break;
 366
 367     case TYPE_CODE_STRUCT:
 368     case TYPE_CODE_UNION:
 369       if (TYPE_CODE (type) == TYPE_CODE_UNION)
 370         fprintfi_filtered (level, stream, "Type, C_Union :: ");
 371       else
 372         fprintfi_filtered (level, stream, "Type ");
 373       fputs_filtered (TYPE_TAG_NAME (type), stream);
 374       /* According to the definition,
 375          we only print structure elements in case show > 0.  */
 376       if (show > 0)
 377         {
 378           fputs_filtered ("\n", stream);
 379           for (index = 0; index < TYPE_NFIELDS (type); index++)
 380             {
 381               f_type_print_base (TYPE_FIELD_TYPE (type, index), stream,
 382                                  show - 1, level + 4);
 383               fputs_filtered (" :: ", stream);
 384               fputs_filtered (TYPE_FIELD_NAME (type, index), stream);
 385               f_type_print_varspec_suffix (TYPE_FIELD_TYPE (type, index),
 386                                            stream, show - 1, 0, 0, 0);
 387               fputs_filtered ("\n", stream);
 388             }
 389           fprintfi_filtered (level, stream, "End Type ");
 390           fputs_filtered (TYPE_TAG_NAME (type), stream);
 391         }
 392       break;
 393
 394     case TYPE_CODE_MODULE:
 395       fprintfi_filtered (level, stream, "module %s", TYPE_TAG_NAME (type));
 396       break;
 397
 398     default_case:
 399     default:
 400       /* Handle types not explicitly handled by the other cases,
 401          such as fundamental types.  For these, just print whatever
 402          the type name is, as recorded in the type itself.  If there
 403          is no type name, then complain.  */
 404       if (TYPE_NAME (type) != NULL)
 405         fprintfi_filtered (level, stream, "%s", TYPE_NAME (type));
 406       else
 407         error (_("Invalid type code (%d) in symbol table."), TYPE_CODE (type));
 408       break;
 409     }
 410 }