1 /* Support for printing Pascal values for GDB, the GNU debugger.
3 Copyright (C) 2000-2019 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 3 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, see <http://www.gnu.org/licenses/>. */
20 /* This file is derived from c-valprint.c */
23 #include "gdb_obstack.h"
26 #include "expression.h"
33 #include "typeprint.h"
39 #include "cp-support.h"
41 #include "common/byte-vector.h"
44 /* Decorations for Pascal. */
46 static const struct generic_val_print_decorations p_decorations =
58 /* See val_print for a description of the various parameters of this
59 function; they are identical. */
62 pascal_val_print (struct type *type,
63 int embedded_offset, CORE_ADDR address,
64 struct ui_file *stream, int recurse,
65 struct value *original_value,
66 const struct value_print_options *options)
68 struct gdbarch *gdbarch = get_type_arch (type);
69 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
70 unsigned int i = 0; /* Number of characters printed */
74 int length_pos, length_size, string_pos;
75 struct type *char_type;
78 const gdb_byte *valaddr = value_contents_for_printing (original_value);
80 type = check_typedef (type);
81 switch (TYPE_CODE (type))
85 LONGEST low_bound, high_bound;
87 if (get_array_bounds (type, &low_bound, &high_bound))
89 len = high_bound - low_bound + 1;
90 elttype = check_typedef (TYPE_TARGET_TYPE (type));
91 eltlen = TYPE_LENGTH (elttype);
92 if (options->prettyformat_arrays)
94 print_spaces_filtered (2 + 2 * recurse, stream);
96 /* If 's' format is used, try to print out as string.
97 If no format is given, print as string if element type
98 is of TYPE_CODE_CHAR and element size is 1,2 or 4. */
99 if (options->format == 's'
100 || ((eltlen == 1 || eltlen == 2 || eltlen == 4)
101 && TYPE_CODE (elttype) == TYPE_CODE_CHAR
102 && options->format == 0))
104 /* If requested, look for the first null char and only print
105 elements up to it. */
106 if (options->stop_print_at_null)
108 unsigned int temp_len;
110 /* Look for a NULL char. */
112 extract_unsigned_integer (valaddr + embedded_offset +
113 temp_len * eltlen, eltlen,
115 && temp_len < len && temp_len < options->print_max;
120 LA_PRINT_STRING (stream, TYPE_TARGET_TYPE (type),
121 valaddr + embedded_offset, len, NULL, 0,
127 fprintf_filtered (stream, "{");
128 /* If this is a virtual function table, print the 0th
129 entry specially, and the rest of the members normally. */
130 if (pascal_object_is_vtbl_ptr_type (elttype))
133 fprintf_filtered (stream, "%d vtable entries", len - 1);
139 val_print_array_elements (type, embedded_offset,
140 address, stream, recurse,
141 original_value, options, i);
142 fprintf_filtered (stream, "}");
146 /* Array of unspecified length: treat like pointer to first elt. */
147 addr = address + embedded_offset;
149 goto print_unpacked_pointer;
152 if (options->format && options->format != 's')
154 val_print_scalar_formatted (type, embedded_offset,
155 original_value, options, 0, stream);
158 if (options->vtblprint && pascal_object_is_vtbl_ptr_type (type))
160 /* Print the unmangled name if desired. */
161 /* Print vtable entry - we only get here if we ARE using
162 -fvtable_thunks. (Otherwise, look under TYPE_CODE_STRUCT.) */
163 /* Extract the address, assume that it is unsigned. */
164 addr = extract_unsigned_integer (valaddr + embedded_offset,
165 TYPE_LENGTH (type), byte_order);
166 print_address_demangle (options, gdbarch, addr, stream, demangle);
169 check_typedef (TYPE_TARGET_TYPE (type));
171 addr = unpack_pointer (type, valaddr + embedded_offset);
172 print_unpacked_pointer:
173 elttype = check_typedef (TYPE_TARGET_TYPE (type));
175 if (TYPE_CODE (elttype) == TYPE_CODE_FUNC)
177 /* Try to print what function it points to. */
178 print_address_demangle (options, gdbarch, addr, stream, demangle);
182 if (options->addressprint && options->format != 's')
184 fputs_filtered (paddress (gdbarch, addr), stream);
188 /* For a pointer to char or unsigned char, also print the string
189 pointed to, unless pointer is null. */
190 if (((TYPE_LENGTH (elttype) == 1
191 && (TYPE_CODE (elttype) == TYPE_CODE_INT
192 || TYPE_CODE (elttype) == TYPE_CODE_CHAR))
193 || ((TYPE_LENGTH (elttype) == 2 || TYPE_LENGTH (elttype) == 4)
194 && TYPE_CODE (elttype) == TYPE_CODE_CHAR))
195 && (options->format == 0 || options->format == 's')
199 fputs_filtered (" ", stream);
200 /* No wide string yet. */
201 i = val_print_string (elttype, NULL, addr, -1, stream, options);
203 /* Also for pointers to pascal strings. */
204 /* Note: this is Free Pascal specific:
205 as GDB does not recognize stabs pascal strings
206 Pascal strings are mapped to records
207 with lowercase names PM. */
208 if (is_pascal_string_type (elttype, &length_pos, &length_size,
209 &string_pos, &char_type, NULL)
212 ULONGEST string_length;
216 fputs_filtered (" ", stream);
217 buffer = (gdb_byte *) xmalloc (length_size);
218 read_memory (addr + length_pos, buffer, length_size);
219 string_length = extract_unsigned_integer (buffer, length_size,
222 i = val_print_string (char_type, NULL,
223 addr + string_pos, string_length,
226 else if (pascal_object_is_vtbl_member (type))
228 /* Print vtbl's nicely. */
229 CORE_ADDR vt_address = unpack_pointer (type,
230 valaddr + embedded_offset);
231 struct bound_minimal_symbol msymbol =
232 lookup_minimal_symbol_by_pc (vt_address);
234 /* If 'symbol_print' is set, we did the work above. */
235 if (!options->symbol_print
236 && (msymbol.minsym != NULL)
237 && (vt_address == BMSYMBOL_VALUE_ADDRESS (msymbol)))
240 fputs_filtered (" ", stream);
241 fputs_filtered ("<", stream);
242 fputs_filtered (MSYMBOL_PRINT_NAME (msymbol.minsym), stream);
243 fputs_filtered (">", stream);
246 if (vt_address && options->vtblprint)
248 struct value *vt_val;
249 struct symbol *wsym = NULL;
251 struct block *block = NULL;
254 fputs_filtered (" ", stream);
256 if (msymbol.minsym != NULL)
258 const char *search_name
259 = MSYMBOL_SEARCH_NAME (msymbol.minsym);
260 wsym = lookup_symbol_search_name (search_name, block,
266 wtype = SYMBOL_TYPE (wsym);
270 wtype = TYPE_TARGET_TYPE (type);
272 vt_val = value_at (wtype, vt_address);
273 common_val_print (vt_val, stream, recurse + 1, options,
275 if (options->prettyformat)
277 fprintf_filtered (stream, "\n");
278 print_spaces_filtered (2 + 2 * recurse, stream);
287 case TYPE_CODE_FLAGS:
289 case TYPE_CODE_RANGE:
293 case TYPE_CODE_ERROR:
294 case TYPE_CODE_UNDEF:
297 generic_val_print (type, embedded_offset, address,
298 stream, recurse, original_value, options,
302 case TYPE_CODE_UNION:
303 if (recurse && !options->unionprint)
305 fprintf_filtered (stream, "{...}");
309 case TYPE_CODE_STRUCT:
310 if (options->vtblprint && pascal_object_is_vtbl_ptr_type (type))
312 /* Print the unmangled name if desired. */
313 /* Print vtable entry - we only get here if NOT using
314 -fvtable_thunks. (Otherwise, look under TYPE_CODE_PTR.) */
315 /* Extract the address, assume that it is unsigned. */
316 print_address_demangle
318 extract_unsigned_integer (valaddr + embedded_offset
319 + TYPE_FIELD_BITPOS (type,
320 VTBL_FNADDR_OFFSET) / 8,
321 TYPE_LENGTH (TYPE_FIELD_TYPE (type,
322 VTBL_FNADDR_OFFSET)),
328 if (is_pascal_string_type (type, &length_pos, &length_size,
329 &string_pos, &char_type, NULL))
331 len = extract_unsigned_integer (valaddr + embedded_offset
332 + length_pos, length_size,
334 LA_PRINT_STRING (stream, char_type,
335 valaddr + embedded_offset + string_pos,
336 len, NULL, 0, options);
339 pascal_object_print_value_fields (type, valaddr, embedded_offset,
340 address, stream, recurse,
341 original_value, options,
347 elttype = TYPE_INDEX_TYPE (type);
348 elttype = check_typedef (elttype);
349 if (TYPE_STUB (elttype))
351 fprintf_filtered (stream, "<incomplete type>");
356 struct type *range = elttype;
357 LONGEST low_bound, high_bound;
360 fputs_filtered ("[", stream);
362 int bound_info = get_discrete_bounds (range, &low_bound, &high_bound);
363 if (low_bound == 0 && high_bound == -1 && TYPE_LENGTH (type) > 0)
365 /* If we know the size of the set type, we can figure out the
368 high_bound = TYPE_LENGTH (type) * TARGET_CHAR_BIT - 1;
369 TYPE_HIGH_BOUND (range) = high_bound;
374 fputs_filtered ("<error value>", stream);
378 for (i = low_bound; i <= high_bound; i++)
380 int element = value_bit_index (type,
381 valaddr + embedded_offset, i);
386 goto maybe_bad_bstring;
391 fputs_filtered (", ", stream);
392 print_type_scalar (range, i, stream);
395 if (i + 1 <= high_bound
396 && value_bit_index (type,
397 valaddr + embedded_offset, ++i))
401 fputs_filtered ("..", stream);
402 while (i + 1 <= high_bound
403 && value_bit_index (type,
404 valaddr + embedded_offset,
407 print_type_scalar (range, j, stream);
412 fputs_filtered ("]", stream);
417 error (_("Invalid pascal type code %d in symbol table."),
423 pascal_value_print (struct value *val, struct ui_file *stream,
424 const struct value_print_options *options)
426 struct type *type = value_type (val);
427 struct value_print_options opts = *options;
431 /* If it is a pointer, indicate what it points to.
433 Print type also if it is a reference.
435 Object pascal: if it is a member pointer, we will take care
436 of that when we print it. */
437 if (TYPE_CODE (type) == TYPE_CODE_PTR
438 || TYPE_CODE (type) == TYPE_CODE_REF)
440 /* Hack: remove (char *) for char strings. Their
441 type is indicated by the quoted string anyway. */
442 if (TYPE_CODE (type) == TYPE_CODE_PTR
443 && TYPE_NAME (type) == NULL
444 && TYPE_NAME (TYPE_TARGET_TYPE (type)) != NULL
445 && strcmp (TYPE_NAME (TYPE_TARGET_TYPE (type)), "char") == 0)
451 fprintf_filtered (stream, "(");
452 type_print (type, "", stream, -1);
453 fprintf_filtered (stream, ") ");
456 common_val_print (val, stream, 0, &opts, current_language);
461 show_pascal_static_field_print (struct ui_file *file, int from_tty,
462 struct cmd_list_element *c, const char *value)
464 fprintf_filtered (file, _("Printing of pascal static members is %s.\n"),
468 static struct obstack dont_print_vb_obstack;
469 static struct obstack dont_print_statmem_obstack;
471 static void pascal_object_print_static_field (struct value *,
472 struct ui_file *, int,
473 const struct value_print_options *);
475 static void pascal_object_print_value (struct type *, const gdb_byte *,
477 CORE_ADDR, struct ui_file *, int,
479 const struct value_print_options *,
482 /* It was changed to this after 2.4.5. */
483 const char pascal_vtbl_ptr_name[] =
484 {'_', '_', 'v', 't', 'b', 'l', '_', 'p', 't', 'r', '_', 't', 'y', 'p', 'e', 0};
486 /* Return truth value for assertion that TYPE is of the type
487 "pointer to virtual function". */
490 pascal_object_is_vtbl_ptr_type (struct type *type)
492 const char *type_name = TYPE_NAME (type);
494 return (type_name != NULL
495 && strcmp (type_name, pascal_vtbl_ptr_name) == 0);
498 /* Return truth value for the assertion that TYPE is of the type
499 "pointer to virtual function table". */
502 pascal_object_is_vtbl_member (struct type *type)
504 if (TYPE_CODE (type) == TYPE_CODE_PTR)
506 type = TYPE_TARGET_TYPE (type);
507 if (TYPE_CODE (type) == TYPE_CODE_ARRAY)
509 type = TYPE_TARGET_TYPE (type);
510 if (TYPE_CODE (type) == TYPE_CODE_STRUCT /* If not using
512 || TYPE_CODE (type) == TYPE_CODE_PTR) /* If using thunks. */
514 /* Virtual functions tables are full of pointers
515 to virtual functions. */
516 return pascal_object_is_vtbl_ptr_type (type);
523 /* Mutually recursive subroutines of pascal_object_print_value and
524 c_val_print to print out a structure's fields:
525 pascal_object_print_value_fields and pascal_object_print_value.
527 TYPE, VALADDR, ADDRESS, STREAM, RECURSE, and OPTIONS have the
528 same meanings as in pascal_object_print_value and c_val_print.
530 DONT_PRINT is an array of baseclass types that we
531 should not print, or zero if called from top level. */
534 pascal_object_print_value_fields (struct type *type, const gdb_byte *valaddr,
536 CORE_ADDR address, struct ui_file *stream,
539 const struct value_print_options *options,
540 struct type **dont_print_vb,
541 int dont_print_statmem)
543 int i, len, n_baseclasses;
544 char *last_dont_print
545 = (char *) obstack_next_free (&dont_print_statmem_obstack);
547 type = check_typedef (type);
549 fprintf_filtered (stream, "{");
550 len = TYPE_NFIELDS (type);
551 n_baseclasses = TYPE_N_BASECLASSES (type);
553 /* Print out baseclasses such that we don't print
554 duplicates of virtual baseclasses. */
555 if (n_baseclasses > 0)
556 pascal_object_print_value (type, valaddr, offset, address,
557 stream, recurse + 1, val,
558 options, dont_print_vb);
560 if (!len && n_baseclasses == 1)
561 fprintf_filtered (stream, "<No data fields>");
564 struct obstack tmp_obstack = dont_print_statmem_obstack;
567 if (dont_print_statmem == 0)
569 /* If we're at top level, carve out a completely fresh
570 chunk of the obstack and use that until this particular
571 invocation returns. */
572 obstack_finish (&dont_print_statmem_obstack);
575 for (i = n_baseclasses; i < len; i++)
577 /* If requested, skip printing of static fields. */
578 if (!options->pascal_static_field_print
579 && field_is_static (&TYPE_FIELD (type, i)))
582 fprintf_filtered (stream, ", ");
583 else if (n_baseclasses > 0)
585 if (options->prettyformat)
587 fprintf_filtered (stream, "\n");
588 print_spaces_filtered (2 + 2 * recurse, stream);
589 fputs_filtered ("members of ", stream);
590 fputs_filtered (TYPE_NAME (type), stream);
591 fputs_filtered (": ", stream);
596 if (options->prettyformat)
598 fprintf_filtered (stream, "\n");
599 print_spaces_filtered (2 + 2 * recurse, stream);
603 wrap_here (n_spaces (2 + 2 * recurse));
606 annotate_field_begin (TYPE_FIELD_TYPE (type, i));
608 if (field_is_static (&TYPE_FIELD (type, i)))
609 fputs_filtered ("static ", stream);
610 fprintf_symbol_filtered (stream, TYPE_FIELD_NAME (type, i),
612 DMGL_PARAMS | DMGL_ANSI);
613 annotate_field_name_end ();
614 fputs_filtered (" = ", stream);
615 annotate_field_value ();
617 if (!field_is_static (&TYPE_FIELD (type, i))
618 && TYPE_FIELD_PACKED (type, i))
622 /* Bitfields require special handling, especially due to byte
624 if (TYPE_FIELD_IGNORE (type, i))
626 fputs_filtered ("<optimized out or zero length>", stream);
628 else if (value_bits_synthetic_pointer (val,
629 TYPE_FIELD_BITPOS (type,
631 TYPE_FIELD_BITSIZE (type,
634 fputs_filtered (_("<synthetic pointer>"), stream);
638 struct value_print_options opts = *options;
640 v = value_field_bitfield (type, i, valaddr, offset, val);
643 common_val_print (v, stream, recurse + 1, &opts,
649 if (TYPE_FIELD_IGNORE (type, i))
651 fputs_filtered ("<optimized out or zero length>", stream);
653 else if (field_is_static (&TYPE_FIELD (type, i)))
655 /* struct value *v = value_static_field (type, i);
659 v = value_field_bitfield (type, i, valaddr, offset, val);
662 val_print_optimized_out (NULL, stream);
664 pascal_object_print_static_field (v, stream, recurse + 1,
669 struct value_print_options opts = *options;
672 /* val_print (TYPE_FIELD_TYPE (type, i),
673 valaddr + TYPE_FIELD_BITPOS (type, i) / 8,
674 address + TYPE_FIELD_BITPOS (type, i) / 8, 0,
675 stream, format, 0, recurse + 1, pretty); */
676 val_print (TYPE_FIELD_TYPE (type, i),
677 offset + TYPE_FIELD_BITPOS (type, i) / 8,
678 address, stream, recurse + 1, val, &opts,
682 annotate_field_end ();
685 if (dont_print_statmem == 0)
687 /* Free the space used to deal with the printing
688 of the members from top level. */
689 obstack_free (&dont_print_statmem_obstack, last_dont_print);
690 dont_print_statmem_obstack = tmp_obstack;
693 if (options->prettyformat)
695 fprintf_filtered (stream, "\n");
696 print_spaces_filtered (2 * recurse, stream);
699 fprintf_filtered (stream, "}");
702 /* Special val_print routine to avoid printing multiple copies of virtual
706 pascal_object_print_value (struct type *type, const gdb_byte *valaddr,
708 CORE_ADDR address, struct ui_file *stream,
711 const struct value_print_options *options,
712 struct type **dont_print_vb)
714 struct type **last_dont_print
715 = (struct type **) obstack_next_free (&dont_print_vb_obstack);
716 struct obstack tmp_obstack = dont_print_vb_obstack;
717 int i, n_baseclasses = TYPE_N_BASECLASSES (type);
719 if (dont_print_vb == 0)
721 /* If we're at top level, carve out a completely fresh
722 chunk of the obstack and use that until this particular
723 invocation returns. */
724 /* Bump up the high-water mark. Now alpha is omega. */
725 obstack_finish (&dont_print_vb_obstack);
728 for (i = 0; i < n_baseclasses; i++)
731 struct type *baseclass = check_typedef (TYPE_BASECLASS (type, i));
732 const char *basename = TYPE_NAME (baseclass);
733 const gdb_byte *base_valaddr = NULL;
736 gdb::byte_vector buf;
738 if (BASETYPE_VIA_VIRTUAL (type, i))
740 struct type **first_dont_print
741 = (struct type **) obstack_base (&dont_print_vb_obstack);
743 int j = (struct type **) obstack_next_free (&dont_print_vb_obstack)
747 if (baseclass == first_dont_print[j])
750 obstack_ptr_grow (&dont_print_vb_obstack, baseclass);
757 boffset = baseclass_offset (type, i, valaddr, offset, address, val);
759 CATCH (ex, RETURN_MASK_ERROR)
761 if (ex.error == NOT_AVAILABLE_ERROR)
770 /* The virtual base class pointer might have been clobbered by the
771 user program. Make sure that it still points to a valid memory
774 if (boffset < 0 || boffset >= TYPE_LENGTH (type))
776 buf.resize (TYPE_LENGTH (baseclass));
778 base_valaddr = buf.data ();
779 if (target_read_memory (address + boffset, buf.data (),
780 TYPE_LENGTH (baseclass)) != 0)
782 address = address + boffset;
787 base_valaddr = valaddr;
790 if (options->prettyformat)
792 fprintf_filtered (stream, "\n");
793 print_spaces_filtered (2 * recurse, stream);
795 fputs_filtered ("<", stream);
796 /* Not sure what the best notation is in the case where there is no
799 fputs_filtered (basename ? basename : "", stream);
800 fputs_filtered ("> = ", stream);
803 val_print_unavailable (stream);
805 val_print_invalid_address (stream);
807 pascal_object_print_value_fields (baseclass, base_valaddr,
808 thisoffset + boffset, address,
809 stream, recurse, val, options,
810 (struct type **) obstack_base (&dont_print_vb_obstack),
812 fputs_filtered (", ", stream);
818 if (dont_print_vb == 0)
820 /* Free the space used to deal with the printing
821 of this type from top level. */
822 obstack_free (&dont_print_vb_obstack, last_dont_print);
823 /* Reset watermark so that we can continue protecting
824 ourselves from whatever we were protecting ourselves. */
825 dont_print_vb_obstack = tmp_obstack;
829 /* Print value of a static member.
830 To avoid infinite recursion when printing a class that contains
831 a static instance of the class, we keep the addresses of all printed
832 static member classes in an obstack and refuse to print them more
835 VAL contains the value to print, STREAM, RECURSE, and OPTIONS
836 have the same meanings as in c_val_print. */
839 pascal_object_print_static_field (struct value *val,
840 struct ui_file *stream,
842 const struct value_print_options *options)
844 struct type *type = value_type (val);
845 struct value_print_options opts;
847 if (value_entirely_optimized_out (val))
849 val_print_optimized_out (val, stream);
853 if (TYPE_CODE (type) == TYPE_CODE_STRUCT)
855 CORE_ADDR *first_dont_print, addr;
859 = (CORE_ADDR *) obstack_base (&dont_print_statmem_obstack);
860 i = (CORE_ADDR *) obstack_next_free (&dont_print_statmem_obstack)
865 if (value_address (val) == first_dont_print[i])
868 <same as static member of an already seen type>",
874 addr = value_address (val);
875 obstack_grow (&dont_print_statmem_obstack, (char *) &addr,
878 type = check_typedef (type);
879 pascal_object_print_value_fields (type,
880 value_contents_for_printing (val),
881 value_embedded_offset (val),
884 val, options, NULL, 1);
890 common_val_print (val, stream, recurse, &opts, current_language);
894 _initialize_pascal_valprint (void)
896 add_setshow_boolean_cmd ("pascal_static-members", class_support,
897 &user_print_options.pascal_static_field_print, _("\
898 Set printing of pascal static members."), _("\
899 Show printing of pascal static members."), NULL,
901 show_pascal_static_field_print,
902 &setprintlist, &showprintlist);