1 /* Support for printing C values for GDB, the GNU debugger.
3 Copyright (C) 1986, 1988, 1989, 1991, 1992, 1993, 1994, 1995, 1996, 1997,
4 1998, 1999, 2000, 2001, 2003, 2005, 2006, 2007, 2008, 2009, 2010
5 Free Software Foundation, Inc.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
23 #include "gdb_string.h"
26 #include "expression.h"
35 /* Print function pointer with inferior address ADDRESS onto stdio
39 print_function_pointer_address (struct gdbarch
*gdbarch
, CORE_ADDR address
,
40 struct ui_file
*stream
, int addressprint
)
42 CORE_ADDR func_addr
= gdbarch_convert_from_func_ptr_addr (gdbarch
, address
,
45 /* If the function pointer is represented by a description, print the
46 address of the description. */
47 if (addressprint
&& func_addr
!= address
)
49 fputs_filtered ("@", stream
);
50 fputs_filtered (paddress (gdbarch
, address
), stream
);
51 fputs_filtered (": ", stream
);
53 print_address_demangle (gdbarch
, func_addr
, stream
, demangle
);
57 /* A helper for c_textual_element_type. This checks the name of the
58 typedef. This is bogus but it isn't apparent that the compiler
59 provides us the help we may need. */
62 textual_name (const char *name
)
64 return (!strcmp (name
, "wchar_t")
65 || !strcmp (name
, "char16_t")
66 || !strcmp (name
, "char32_t"));
69 /* Apply a heuristic to decide whether an array of TYPE or a pointer
70 to TYPE should be printed as a textual string. Return non-zero if
71 it should, or zero if it should be treated as an array of integers
72 or pointer to integers. FORMAT is the current format letter,
75 We guess that "char" is a character. Explicitly signed and
76 unsigned character types are also characters. Integer data from
77 vector types is not. The user can override this by using the /s
81 c_textual_element_type (struct type
*type
, char format
)
83 struct type
*true_type
, *iter_type
;
85 if (format
!= 0 && format
!= 's')
88 /* We also rely on this for its side effect of setting up all the
90 true_type
= check_typedef (type
);
92 /* TYPE_CODE_CHAR is always textual. */
93 if (TYPE_CODE (true_type
) == TYPE_CODE_CHAR
)
96 /* Any other character-like types must be integral. */
97 if (TYPE_CODE (true_type
) != TYPE_CODE_INT
)
100 /* We peel typedefs one by one, looking for a match. */
104 /* Check the name of the type. */
105 if (TYPE_NAME (iter_type
) && textual_name (TYPE_NAME (iter_type
)))
108 if (TYPE_CODE (iter_type
) != TYPE_CODE_TYPEDEF
)
111 /* Peel a single typedef. If the typedef doesn't have a target
112 type, we use check_typedef and hope the result is ok -- it
113 might be for C++, where wchar_t is a built-in type. */
114 if (TYPE_TARGET_TYPE (iter_type
))
115 iter_type
= TYPE_TARGET_TYPE (iter_type
);
117 iter_type
= check_typedef (iter_type
);
122 /* Print this as a string if we can manage it. For now, no
123 wide character support. */
124 if (TYPE_CODE (true_type
) == TYPE_CODE_INT
125 && TYPE_LENGTH (true_type
) == 1)
130 /* If a one-byte TYPE_CODE_INT is missing the not-a-character
131 flag, then we treat it as text; otherwise, we assume it's
132 being used as data. */
133 if (TYPE_CODE (true_type
) == TYPE_CODE_INT
134 && TYPE_LENGTH (true_type
) == 1
135 && !TYPE_NOTTEXT (true_type
))
143 /* Print data of type TYPE located at VALADDR (within GDB), which came from
144 the inferior at address ADDRESS, onto stdio stream STREAM according to
145 OPTIONS. The data at VALADDR is in target byte order.
147 If the data are a string pointer, returns the number of string characters
151 c_val_print (struct type
*type
, const gdb_byte
*valaddr
, int embedded_offset
,
152 CORE_ADDR address
, struct ui_file
*stream
, int recurse
,
153 const struct value
*original_value
,
154 const struct value_print_options
*options
)
156 struct gdbarch
*gdbarch
= get_type_arch (type
);
157 enum bfd_endian byte_order
= gdbarch_byte_order (gdbarch
);
158 unsigned int i
= 0; /* Number of characters printed */
160 struct type
*elttype
, *unresolved_elttype
;
161 struct type
*unresolved_type
= type
;
166 CHECK_TYPEDEF (type
);
167 switch (TYPE_CODE (type
))
169 case TYPE_CODE_ARRAY
:
170 unresolved_elttype
= TYPE_TARGET_TYPE (type
);
171 elttype
= check_typedef (unresolved_elttype
);
172 if (TYPE_LENGTH (type
) > 0 && TYPE_LENGTH (unresolved_elttype
) > 0)
174 eltlen
= TYPE_LENGTH (elttype
);
175 len
= TYPE_LENGTH (type
) / eltlen
;
176 if (options
->prettyprint_arrays
)
178 print_spaces_filtered (2 + 2 * recurse
, stream
);
181 /* Print arrays of textual chars with a string syntax, as
182 long as the entire array is valid. */
183 if (!TYPE_VECTOR (type
)
184 && c_textual_element_type (unresolved_elttype
, options
->format
)
185 && value_bits_valid (original_value
,
186 TARGET_CHAR_BIT
* embedded_offset
,
187 TARGET_CHAR_BIT
* TYPE_LENGTH (type
)))
189 /* If requested, look for the first null char and only print
190 elements up to it. */
191 if (options
->stop_print_at_null
)
193 unsigned int temp_len
;
197 && temp_len
< options
->print_max
198 && extract_unsigned_integer (valaddr
+ embedded_offset
200 eltlen
, byte_order
) != 0);
206 LA_PRINT_STRING (stream
, unresolved_elttype
,
207 valaddr
+ embedded_offset
, len
,
213 fprintf_filtered (stream
, "{");
214 /* If this is a virtual function table, print the 0th
215 entry specially, and the rest of the members normally. */
216 if (cp_is_vtbl_ptr_type (elttype
))
219 fprintf_filtered (stream
, _("%d vtable entries"), len
- 1);
225 val_print_array_elements (type
, valaddr
+ embedded_offset
,
226 address
+ embedded_offset
, stream
,
227 recurse
, original_value
, options
, i
);
228 fprintf_filtered (stream
, "}");
232 /* Array of unspecified length: treat like pointer to first elt. */
234 goto print_unpacked_pointer
;
236 case TYPE_CODE_MEMBERPTR
:
239 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
243 cp_print_class_member (valaddr
+ embedded_offset
, type
, stream
, "&");
246 case TYPE_CODE_METHODPTR
:
247 cplus_print_method_ptr (valaddr
+ embedded_offset
, type
, stream
);
251 if (options
->format
&& options
->format
!= 's')
253 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
257 if (options
->vtblprint
&& cp_is_vtbl_ptr_type (type
))
259 /* Print the unmangled name if desired. */
260 /* Print vtable entry - we only get here if we ARE using
261 -fvtable_thunks. (Otherwise, look under TYPE_CODE_STRUCT.) */
263 = extract_typed_address (valaddr
+ embedded_offset
, type
);
265 print_function_pointer_address (gdbarch
, addr
, stream
,
266 options
->addressprint
);
269 unresolved_elttype
= TYPE_TARGET_TYPE (type
);
270 elttype
= check_typedef (unresolved_elttype
);
272 addr
= unpack_pointer (type
, valaddr
+ embedded_offset
);
273 print_unpacked_pointer
:
275 if (TYPE_CODE (elttype
) == TYPE_CODE_FUNC
)
277 /* Try to print what function it points to. */
278 print_function_pointer_address (gdbarch
, addr
, stream
,
279 options
->addressprint
);
280 /* Return value is irrelevant except for string pointers. */
284 if (options
->addressprint
)
285 fputs_filtered (paddress (gdbarch
, addr
), stream
);
287 /* For a pointer to a textual type, also print the string
288 pointed to, unless pointer is null. */
290 if (c_textual_element_type (unresolved_elttype
, options
->format
)
293 i
= val_print_string (unresolved_elttype
, addr
, -1, stream
,
296 else if (cp_is_vtbl_member (type
))
298 /* print vtbl's nicely */
299 CORE_ADDR vt_address
= unpack_pointer (type
, valaddr
+ embedded_offset
);
301 struct minimal_symbol
*msymbol
=
302 lookup_minimal_symbol_by_pc (vt_address
);
303 if ((msymbol
!= NULL
)
304 && (vt_address
== SYMBOL_VALUE_ADDRESS (msymbol
)))
306 fputs_filtered (" <", stream
);
307 fputs_filtered (SYMBOL_PRINT_NAME (msymbol
), stream
);
308 fputs_filtered (">", stream
);
310 if (vt_address
&& options
->vtblprint
)
312 struct value
*vt_val
;
313 struct symbol
*wsym
= (struct symbol
*) NULL
;
315 struct block
*block
= (struct block
*) NULL
;
319 wsym
= lookup_symbol (SYMBOL_LINKAGE_NAME (msymbol
), block
,
320 VAR_DOMAIN
, &is_this_fld
);
324 wtype
= SYMBOL_TYPE (wsym
);
328 wtype
= unresolved_elttype
;
330 vt_val
= value_at (wtype
, vt_address
);
331 common_val_print (vt_val
, stream
, recurse
+ 1, options
,
335 fprintf_filtered (stream
, "\n");
336 print_spaces_filtered (2 + 2 * recurse
, stream
);
341 /* Return number of characters printed, including the terminating
342 '\0' if we reached the end. val_print_string takes care including
343 the terminating '\0' if necessary. */
349 elttype
= check_typedef (TYPE_TARGET_TYPE (type
));
350 if (options
->addressprint
)
353 = extract_typed_address (valaddr
+ embedded_offset
, type
);
355 fprintf_filtered (stream
, "@");
356 fputs_filtered (paddress (gdbarch
, addr
), stream
);
357 if (options
->deref_ref
)
358 fputs_filtered (": ", stream
);
360 /* De-reference the reference. */
361 if (options
->deref_ref
)
363 if (TYPE_CODE (elttype
) != TYPE_CODE_UNDEF
)
365 struct value
*deref_val
=
367 (TYPE_TARGET_TYPE (type
),
368 unpack_pointer (type
, valaddr
+ embedded_offset
));
370 common_val_print (deref_val
, stream
, recurse
, options
,
374 fputs_filtered ("???", stream
);
378 case TYPE_CODE_UNION
:
379 if (recurse
&& !options
->unionprint
)
381 fprintf_filtered (stream
, "{...}");
385 case TYPE_CODE_STRUCT
:
386 /*FIXME: Abstract this away */
387 if (options
->vtblprint
&& cp_is_vtbl_ptr_type (type
))
389 /* Print the unmangled name if desired. */
390 /* Print vtable entry - we only get here if NOT using
391 -fvtable_thunks. (Otherwise, look under TYPE_CODE_PTR.) */
392 int offset
= (embedded_offset
+
393 TYPE_FIELD_BITPOS (type
, VTBL_FNADDR_OFFSET
) / 8);
394 struct type
*field_type
= TYPE_FIELD_TYPE (type
, VTBL_FNADDR_OFFSET
);
396 = extract_typed_address (valaddr
+ offset
, field_type
);
398 print_function_pointer_address (gdbarch
, addr
, stream
,
399 options
->addressprint
);
402 cp_print_value_fields_rtti (type
, valaddr
,
403 embedded_offset
, address
, stream
,
404 recurse
, original_value
, options
, NULL
, 0);
410 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
414 len
= TYPE_NFIELDS (type
);
415 val
= unpack_long (type
, valaddr
+ embedded_offset
);
416 for (i
= 0; i
< len
; i
++)
419 if (val
== TYPE_FIELD_BITPOS (type
, i
))
426 fputs_filtered (TYPE_FIELD_NAME (type
, i
), stream
);
430 print_longest (stream
, 'd', 0, val
);
434 case TYPE_CODE_FLAGS
:
436 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
439 val_print_type_code_flags (type
, valaddr
+ embedded_offset
, stream
);
443 case TYPE_CODE_METHOD
:
446 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
450 /* FIXME, we should consider, at least for ANSI C language, eliminating
451 the distinction made between FUNCs and POINTERs to FUNCs. */
452 fprintf_filtered (stream
, "{");
453 type_print (type
, "", stream
, -1);
454 fprintf_filtered (stream
, "} ");
455 /* Try to print what function it points to, and its address. */
456 print_address_demangle (gdbarch
, address
, stream
, demangle
);
460 if (options
->format
|| options
->output_format
)
462 struct value_print_options opts
= *options
;
463 opts
.format
= (options
->format
? options
->format
464 : options
->output_format
);
465 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
470 val
= unpack_long (type
, valaddr
+ embedded_offset
);
472 fputs_filtered ("false", stream
);
474 fputs_filtered ("true", stream
);
476 print_longest (stream
, 'd', 0, val
);
480 case TYPE_CODE_RANGE
:
481 /* FIXME: create_range_type does not set the unsigned bit in a
482 range type (I think it probably should copy it from the target
483 type), so we won't print values which are too large to
484 fit in a signed integer correctly. */
485 /* FIXME: Doesn't handle ranges of enums correctly. (Can't just
486 print with the target type, though, because the size of our type
487 and the target type might differ). */
491 if (options
->format
|| options
->output_format
)
493 struct value_print_options opts
= *options
;
495 opts
.format
= (options
->format
? options
->format
496 : options
->output_format
);
497 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
502 val_print_type_code_int (type
, valaddr
+ embedded_offset
, stream
);
503 /* C and C++ has no single byte int type, char is used instead.
504 Since we don't know whether the value is really intended to
505 be used as an integer or a character, print the character
506 equivalent as well. */
507 if (c_textual_element_type (unresolved_type
, options
->format
))
509 fputs_filtered (" ", stream
);
510 LA_PRINT_CHAR ((unsigned char) unpack_long (type
, valaddr
+ embedded_offset
),
511 unresolved_type
, stream
);
517 if (options
->format
|| options
->output_format
)
519 struct value_print_options opts
= *options
;
520 opts
.format
= (options
->format
? options
->format
521 : options
->output_format
);
522 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
527 val
= unpack_long (type
, valaddr
+ embedded_offset
);
528 if (TYPE_UNSIGNED (type
))
529 fprintf_filtered (stream
, "%u", (unsigned int) val
);
531 fprintf_filtered (stream
, "%d", (int) val
);
532 fputs_filtered (" ", stream
);
533 LA_PRINT_CHAR ((unsigned char) val
, unresolved_type
, stream
);
540 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
545 print_floating (valaddr
+ embedded_offset
, type
, stream
);
549 case TYPE_CODE_DECFLOAT
:
551 print_scalar_formatted (valaddr
+ embedded_offset
, type
,
554 print_decimal_floating (valaddr
+ embedded_offset
, type
, stream
);
558 fprintf_filtered (stream
, "void");
561 case TYPE_CODE_ERROR
:
562 fprintf_filtered (stream
, "%s", TYPE_ERROR_NAME (type
));
565 case TYPE_CODE_UNDEF
:
566 /* This happens (without TYPE_FLAG_STUB set) on systems which don't use
567 dbx xrefs (NO_DBX_XREFS in gcc) if a file has a "struct foo *bar"
568 and no complete type for struct foo in that file. */
569 fprintf_filtered (stream
, _("<incomplete type>"));
572 case TYPE_CODE_COMPLEX
:
574 print_scalar_formatted (valaddr
+ embedded_offset
,
575 TYPE_TARGET_TYPE (type
),
578 print_floating (valaddr
+ embedded_offset
, TYPE_TARGET_TYPE (type
),
580 fprintf_filtered (stream
, " + ");
582 print_scalar_formatted (valaddr
+ embedded_offset
583 + TYPE_LENGTH (TYPE_TARGET_TYPE (type
)),
584 TYPE_TARGET_TYPE (type
),
587 print_floating (valaddr
+ embedded_offset
588 + TYPE_LENGTH (TYPE_TARGET_TYPE (type
)),
589 TYPE_TARGET_TYPE (type
),
591 fprintf_filtered (stream
, " * I");
595 error (_("Invalid C/C++ type code %d in symbol table."), TYPE_CODE (type
));
602 c_value_print (struct value
*val
, struct ui_file
*stream
,
603 const struct value_print_options
*options
)
605 struct type
*type
, *real_type
, *val_type
;
606 int full
, top
, using_enc
;
607 struct value_print_options opts
= *options
;
611 /* If it is a pointer, indicate what it points to.
613 Print type also if it is a reference.
615 C++: if it is a member pointer, we will take care
616 of that when we print it. */
618 /* Preserve the original type before stripping typedefs. We prefer
619 to pass down the original type when possible, but for local
620 checks it is better to look past the typedefs. */
621 val_type
= value_type (val
);
622 type
= check_typedef (val_type
);
624 if (TYPE_CODE (type
) == TYPE_CODE_PTR
625 || TYPE_CODE (type
) == TYPE_CODE_REF
)
627 /* Hack: remove (char *) for char strings. Their
628 type is indicated by the quoted string anyway.
629 (Don't use c_textual_element_type here; quoted strings
630 are always exactly (char *), (wchar_t *), or the like. */
631 if (TYPE_CODE (val_type
) == TYPE_CODE_PTR
632 && TYPE_NAME (val_type
) == NULL
633 && TYPE_NAME (TYPE_TARGET_TYPE (val_type
)) != NULL
634 && (strcmp (TYPE_NAME (TYPE_TARGET_TYPE (val_type
)), "char") == 0
635 || textual_name (TYPE_NAME (TYPE_TARGET_TYPE (val_type
)))))
639 else if (options
->objectprint
640 && (TYPE_CODE (TYPE_TARGET_TYPE (type
)) == TYPE_CODE_CLASS
))
643 if (TYPE_CODE(type
) == TYPE_CODE_REF
)
645 /* Copy value, change to pointer, so we don't get an
646 * error about a non-pointer type in value_rtti_target_type
648 struct value
*temparg
;
649 temparg
=value_copy(val
);
650 deprecated_set_value_type (temparg
, lookup_pointer_type (TYPE_TARGET_TYPE(type
)));
653 /* Pointer to class, check real type of object */
654 fprintf_filtered (stream
, "(");
655 real_type
= value_rtti_target_type (val
, &full
, &top
, &using_enc
);
658 /* RTTI entry found */
659 if (TYPE_CODE (type
) == TYPE_CODE_PTR
)
661 /* create a pointer type pointing to the real type */
662 type
= lookup_pointer_type (real_type
);
666 /* create a reference type referencing the real type */
667 type
= lookup_reference_type (real_type
);
669 /* JYG: Need to adjust pointer value. */
670 /* NOTE: cagney/2005-01-02: THIS IS BOGUS. */
671 value_contents_writeable (val
)[0] -= top
;
673 /* Note: When we look up RTTI entries, we don't get any
674 information on const or volatile attributes */
676 type_print (type
, "", stream
, -1);
677 fprintf_filtered (stream
, ") ");
683 fprintf_filtered (stream
, "(");
684 type_print (value_type (val
), "", stream
, -1);
685 fprintf_filtered (stream
, ") ");
689 if (!value_initialized (val
))
690 fprintf_filtered (stream
, " [uninitialized] ");
692 if (options
->objectprint
&& (TYPE_CODE (type
) == TYPE_CODE_CLASS
))
694 /* Attempt to determine real type of object */
695 real_type
= value_rtti_type (val
, &full
, &top
, &using_enc
);
698 /* We have RTTI information, so use it */
699 val
= value_full_object (val
, real_type
, full
, top
, using_enc
);
700 fprintf_filtered (stream
, "(%s%s) ",
701 TYPE_NAME (real_type
),
702 full
? "" : _(" [incomplete object]"));
703 /* Print out object: enclosing type is same as real_type if full */
704 return val_print (value_enclosing_type (val
),
705 value_contents_for_printing (val
), 0,
706 value_address (val
), stream
, 0,
707 val
, &opts
, current_language
);
708 /* Note: When we look up RTTI entries, we don't get any information on
709 const or volatile attributes */
711 else if (type
!= check_typedef (value_enclosing_type (val
)))
713 /* No RTTI information, so let's do our best */
714 fprintf_filtered (stream
, "(%s ?) ",
715 TYPE_NAME (value_enclosing_type (val
)));
716 return val_print (value_enclosing_type (val
),
717 value_contents_for_printing (val
), 0,
718 value_address (val
), stream
, 0,
719 val
, &opts
, current_language
);
721 /* Otherwise, we end up at the return outside this "if" */
724 return val_print (val_type
, value_contents_for_printing (val
),
725 value_embedded_offset (val
),
728 val
, &opts
, current_language
);
This page took 0.044974 seconds and 4 git commands to generate.