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
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 (CORE_ADDR address
, struct ui_file
*stream
)
41 CORE_ADDR func_addr
= gdbarch_convert_from_func_ptr_addr (current_gdbarch
,
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 (address
), stream
);
51 fputs_filtered (": ", stream
);
53 print_address_demangle (func_addr
, stream
, demangle
);
57 /* Apply a heuristic to decide whether an array of TYPE or a pointer
58 to TYPE should be printed as a textual string. Return non-zero if
59 it should, or zero if it should be treated as an array of integers
60 or pointer to integers. FORMAT is the current format letter,
63 We guess that "char" is a character. Explicitly signed and
64 unsigned character types are also characters. Integer data from
65 vector types is not. The user can override this by using the /s
69 textual_element_type (struct type
*type
, char format
)
71 struct type
*true_type
= check_typedef (type
);
73 if (format
!= 0 && format
!= 's')
76 /* TYPE_CODE_CHAR is always textual. */
77 if (TYPE_CODE (true_type
) == TYPE_CODE_CHAR
)
82 /* Print this as a string if we can manage it. For now, no
83 wide character support. */
84 if (TYPE_CODE (true_type
) == TYPE_CODE_INT
85 && TYPE_LENGTH (true_type
) == 1)
90 /* If a one-byte TYPE_CODE_INT is missing the not-a-character
91 flag, then we treat it as text; otherwise, we assume it's
92 being used as data. */
93 if (TYPE_CODE (true_type
) == TYPE_CODE_INT
94 && TYPE_LENGTH (true_type
) == 1
95 && !TYPE_NOTTEXT (true_type
))
103 /* Print data of type TYPE located at VALADDR (within GDB), which came from
104 the inferior at address ADDRESS, onto stdio stream STREAM according to
105 FORMAT (a letter or 0 for natural format). The data at VALADDR is in
108 If the data are a string pointer, returns the number of string characters
111 If DEREF_REF is nonzero, then dereference references, otherwise just print
114 The PRETTY parameter controls prettyprinting. */
117 c_val_print (struct type
*type
, const gdb_byte
*valaddr
, int embedded_offset
,
118 CORE_ADDR address
, struct ui_file
*stream
, int format
,
119 int deref_ref
, int recurse
, enum val_prettyprint pretty
)
121 unsigned int i
= 0; /* Number of characters printed */
123 struct type
*elttype
;
128 CHECK_TYPEDEF (type
);
129 switch (TYPE_CODE (type
))
131 case TYPE_CODE_ARRAY
:
132 elttype
= check_typedef (TYPE_TARGET_TYPE (type
));
133 if (TYPE_LENGTH (type
) > 0 && TYPE_LENGTH (TYPE_TARGET_TYPE (type
)) > 0)
135 eltlen
= TYPE_LENGTH (elttype
);
136 len
= TYPE_LENGTH (type
) / eltlen
;
137 if (prettyprint_arrays
)
139 print_spaces_filtered (2 + 2 * recurse
, stream
);
142 /* Print arrays of textual chars with a string syntax. */
143 if (textual_element_type (elttype
, format
))
145 /* If requested, look for the first null char and only print
146 elements up to it. */
147 if (stop_print_at_null
)
149 unsigned int temp_len
;
151 /* Look for a NULL char. */
153 (valaddr
+ embedded_offset
)[temp_len
]
154 && temp_len
< len
&& temp_len
< print_max
;
159 LA_PRINT_STRING (stream
, valaddr
+ embedded_offset
, len
, eltlen
, 0);
164 fprintf_filtered (stream
, "{");
165 /* If this is a virtual function table, print the 0th
166 entry specially, and the rest of the members normally. */
167 if (cp_is_vtbl_ptr_type (elttype
))
170 fprintf_filtered (stream
, _("%d vtable entries"), len
- 1);
176 val_print_array_elements (type
, valaddr
+ embedded_offset
, address
, stream
,
177 format
, deref_ref
, recurse
, pretty
, i
);
178 fprintf_filtered (stream
, "}");
182 /* Array of unspecified length: treat like pointer to first elt. */
184 goto print_unpacked_pointer
;
186 case TYPE_CODE_MEMBERPTR
:
189 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
192 cp_print_class_member (valaddr
+ embedded_offset
, type
, stream
, "&");
195 case TYPE_CODE_METHODPTR
:
196 cplus_print_method_ptr (valaddr
+ embedded_offset
, type
, stream
);
200 if (format
&& format
!= 's')
202 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
205 if (vtblprint
&& cp_is_vtbl_ptr_type (type
))
207 /* Print the unmangled name if desired. */
208 /* Print vtable entry - we only get here if we ARE using
209 -fvtable_thunks. (Otherwise, look under TYPE_CODE_STRUCT.) */
211 = extract_typed_address (valaddr
+ embedded_offset
, type
);
212 print_function_pointer_address (addr
, stream
);
215 elttype
= check_typedef (TYPE_TARGET_TYPE (type
));
217 addr
= unpack_pointer (type
, valaddr
+ embedded_offset
);
218 print_unpacked_pointer
:
220 if (TYPE_CODE (elttype
) == TYPE_CODE_FUNC
)
222 /* Try to print what function it points to. */
223 print_function_pointer_address (addr
, stream
);
224 /* Return value is irrelevant except for string pointers. */
229 fputs_filtered (paddress (addr
), stream
);
231 /* For a pointer to a textual type, also print the string
232 pointed to, unless pointer is null. */
233 /* FIXME: need to handle wchar_t here... */
235 if (textual_element_type (elttype
, format
) && addr
!= 0)
237 i
= val_print_string (addr
, -1, TYPE_LENGTH (elttype
), stream
);
239 else if (cp_is_vtbl_member (type
))
241 /* print vtbl's nicely */
242 CORE_ADDR vt_address
= unpack_pointer (type
, valaddr
+ embedded_offset
);
244 struct minimal_symbol
*msymbol
=
245 lookup_minimal_symbol_by_pc (vt_address
);
246 if ((msymbol
!= NULL
) &&
247 (vt_address
== SYMBOL_VALUE_ADDRESS (msymbol
)))
249 fputs_filtered (" <", stream
);
250 fputs_filtered (SYMBOL_PRINT_NAME (msymbol
), stream
);
251 fputs_filtered (">", stream
);
253 if (vt_address
&& vtblprint
)
255 struct value
*vt_val
;
256 struct symbol
*wsym
= (struct symbol
*) NULL
;
258 struct block
*block
= (struct block
*) NULL
;
262 wsym
= lookup_symbol (SYMBOL_LINKAGE_NAME (msymbol
), block
,
263 VAR_DOMAIN
, &is_this_fld
);
267 wtype
= SYMBOL_TYPE (wsym
);
271 wtype
= TYPE_TARGET_TYPE (type
);
273 vt_val
= value_at (wtype
, vt_address
);
274 common_val_print (vt_val
, stream
, format
,
275 deref_ref
, recurse
+ 1, pretty
,
279 fprintf_filtered (stream
, "\n");
280 print_spaces_filtered (2 + 2 * recurse
, stream
);
285 /* Return number of characters printed, including the terminating
286 '\0' if we reached the end. val_print_string takes care including
287 the terminating '\0' if necessary. */
293 elttype
= check_typedef (TYPE_TARGET_TYPE (type
));
297 = extract_typed_address (valaddr
+ embedded_offset
, type
);
298 fprintf_filtered (stream
, "@");
299 fputs_filtered (paddress (addr
), stream
);
301 fputs_filtered (": ", stream
);
303 /* De-reference the reference. */
306 if (TYPE_CODE (elttype
) != TYPE_CODE_UNDEF
)
308 struct value
*deref_val
=
310 (TYPE_TARGET_TYPE (type
),
311 unpack_pointer (type
, valaddr
+ embedded_offset
));
312 common_val_print (deref_val
, stream
, format
, deref_ref
,
313 recurse
, pretty
, current_language
);
316 fputs_filtered ("???", stream
);
320 case TYPE_CODE_UNION
:
321 if (recurse
&& !unionprint
)
323 fprintf_filtered (stream
, "{...}");
327 case TYPE_CODE_STRUCT
:
328 /*FIXME: Abstract this away */
329 if (vtblprint
&& cp_is_vtbl_ptr_type (type
))
331 /* Print the unmangled name if desired. */
332 /* Print vtable entry - we only get here if NOT using
333 -fvtable_thunks. (Otherwise, look under TYPE_CODE_PTR.) */
334 int offset
= (embedded_offset
+
335 TYPE_FIELD_BITPOS (type
, VTBL_FNADDR_OFFSET
) / 8);
336 struct type
*field_type
= TYPE_FIELD_TYPE (type
, VTBL_FNADDR_OFFSET
);
338 = extract_typed_address (valaddr
+ offset
, field_type
);
340 print_function_pointer_address (addr
, stream
);
343 cp_print_value_fields (type
, type
, valaddr
, embedded_offset
, address
, stream
, format
,
344 recurse
, pretty
, NULL
, 0);
350 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
353 len
= TYPE_NFIELDS (type
);
354 val
= unpack_long (type
, valaddr
+ embedded_offset
);
355 for (i
= 0; i
< len
; i
++)
358 if (val
== TYPE_FIELD_BITPOS (type
, i
))
365 fputs_filtered (TYPE_FIELD_NAME (type
, i
), stream
);
369 print_longest (stream
, 'd', 0, val
);
373 case TYPE_CODE_FLAGS
:
375 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
377 val_print_type_code_flags (type
, valaddr
+ embedded_offset
, stream
);
381 case TYPE_CODE_METHOD
:
384 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
387 /* FIXME, we should consider, at least for ANSI C language, eliminating
388 the distinction made between FUNCs and POINTERs to FUNCs. */
389 fprintf_filtered (stream
, "{");
390 type_print (type
, "", stream
, -1);
391 fprintf_filtered (stream
, "} ");
392 /* Try to print what function it points to, and its address. */
393 print_address_demangle (address
, stream
, demangle
);
397 format
= format
? format
: output_format
;
399 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
402 val
= unpack_long (type
, valaddr
+ embedded_offset
);
404 fputs_filtered ("false", stream
);
406 fputs_filtered ("true", stream
);
408 print_longest (stream
, 'd', 0, val
);
412 case TYPE_CODE_RANGE
:
413 /* FIXME: create_range_type does not set the unsigned bit in a
414 range type (I think it probably should copy it from the target
415 type), so we won't print values which are too large to
416 fit in a signed integer correctly. */
417 /* FIXME: Doesn't handle ranges of enums correctly. (Can't just
418 print with the target type, though, because the size of our type
419 and the target type might differ). */
423 format
= format
? format
: output_format
;
426 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
430 val_print_type_code_int (type
, valaddr
+ embedded_offset
, stream
);
431 /* C and C++ has no single byte int type, char is used instead.
432 Since we don't know whether the value is really intended to
433 be used as an integer or a character, print the character
434 equivalent as well. */
435 if (textual_element_type (type
, format
))
437 fputs_filtered (" ", stream
);
438 LA_PRINT_CHAR ((unsigned char) unpack_long (type
, valaddr
+ embedded_offset
),
445 format
= format
? format
: output_format
;
448 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
452 val
= unpack_long (type
, valaddr
+ embedded_offset
);
453 if (TYPE_UNSIGNED (type
))
454 fprintf_filtered (stream
, "%u", (unsigned int) val
);
456 fprintf_filtered (stream
, "%d", (int) val
);
457 fputs_filtered (" ", stream
);
458 LA_PRINT_CHAR ((unsigned char) val
, stream
);
465 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
469 print_floating (valaddr
+ embedded_offset
, type
, stream
);
473 case TYPE_CODE_DECFLOAT
:
475 print_scalar_formatted (valaddr
+ embedded_offset
, type
, format
, 0, stream
);
477 print_decimal_floating (valaddr
+ embedded_offset
, type
, stream
);
481 fprintf_filtered (stream
, "void");
484 case TYPE_CODE_ERROR
:
485 fprintf_filtered (stream
, _("<error type>"));
488 case TYPE_CODE_UNDEF
:
489 /* This happens (without TYPE_FLAG_STUB set) on systems which don't use
490 dbx xrefs (NO_DBX_XREFS in gcc) if a file has a "struct foo *bar"
491 and no complete type for struct foo in that file. */
492 fprintf_filtered (stream
, _("<incomplete type>"));
495 case TYPE_CODE_COMPLEX
:
497 print_scalar_formatted (valaddr
+ embedded_offset
,
498 TYPE_TARGET_TYPE (type
),
501 print_floating (valaddr
+ embedded_offset
, TYPE_TARGET_TYPE (type
),
503 fprintf_filtered (stream
, " + ");
505 print_scalar_formatted (valaddr
+ embedded_offset
506 + TYPE_LENGTH (TYPE_TARGET_TYPE (type
)),
507 TYPE_TARGET_TYPE (type
),
510 print_floating (valaddr
+ embedded_offset
511 + TYPE_LENGTH (TYPE_TARGET_TYPE (type
)),
512 TYPE_TARGET_TYPE (type
),
514 fprintf_filtered (stream
, " * I");
518 error (_("Invalid C/C++ type code %d in symbol table."), TYPE_CODE (type
));
525 c_value_print (struct value
*val
, struct ui_file
*stream
, int format
,
526 enum val_prettyprint pretty
)
528 struct type
*type
, *real_type
;
529 int full
, top
, using_enc
;
531 /* If it is a pointer, indicate what it points to.
533 Print type also if it is a reference.
535 C++: if it is a member pointer, we will take care
536 of that when we print it. */
538 type
= check_typedef (value_type (val
));
540 if (TYPE_CODE (type
) == TYPE_CODE_PTR
541 || TYPE_CODE (type
) == TYPE_CODE_REF
)
543 /* Hack: remove (char *) for char strings. Their
544 type is indicated by the quoted string anyway.
545 (Don't use textual_element_type here; quoted strings
546 are always exactly (char *). */
547 if (TYPE_CODE (type
) == TYPE_CODE_PTR
548 && TYPE_NAME (type
) == NULL
549 && TYPE_NAME (TYPE_TARGET_TYPE (type
)) != NULL
550 && strcmp (TYPE_NAME (TYPE_TARGET_TYPE (type
)), "char") == 0)
554 else if (objectprint
&& (TYPE_CODE (TYPE_TARGET_TYPE (type
)) == TYPE_CODE_CLASS
))
557 if (TYPE_CODE(type
) == TYPE_CODE_REF
)
559 /* Copy value, change to pointer, so we don't get an
560 * error about a non-pointer type in value_rtti_target_type
562 struct value
*temparg
;
563 temparg
=value_copy(val
);
564 deprecated_set_value_type (temparg
, lookup_pointer_type (TYPE_TARGET_TYPE(type
)));
567 /* Pointer to class, check real type of object */
568 fprintf_filtered (stream
, "(");
569 real_type
= value_rtti_target_type (val
, &full
, &top
, &using_enc
);
572 /* RTTI entry found */
573 if (TYPE_CODE (type
) == TYPE_CODE_PTR
)
575 /* create a pointer type pointing to the real type */
576 type
= lookup_pointer_type (real_type
);
580 /* create a reference type referencing the real type */
581 type
= lookup_reference_type (real_type
);
583 /* JYG: Need to adjust pointer value. */
584 /* NOTE: cagney/2005-01-02: THIS IS BOGUS. */
585 value_contents_writeable (val
)[0] -= top
;
587 /* Note: When we look up RTTI entries, we don't get any
588 information on const or volatile attributes */
590 type_print (type
, "", stream
, -1);
591 fprintf_filtered (stream
, ") ");
596 fprintf_filtered (stream
, "(");
597 type_print (value_type (val
), "", stream
, -1);
598 fprintf_filtered (stream
, ") ");
602 if (!value_initialized (val
))
603 fprintf_filtered (stream
, " [uninitialized] ");
605 if (objectprint
&& (TYPE_CODE (type
) == TYPE_CODE_CLASS
))
607 /* Attempt to determine real type of object */
608 real_type
= value_rtti_type (val
, &full
, &top
, &using_enc
);
611 /* We have RTTI information, so use it */
612 val
= value_full_object (val
, real_type
, full
, top
, using_enc
);
613 fprintf_filtered (stream
, "(%s%s) ",
614 TYPE_NAME (real_type
),
615 full
? "" : _(" [incomplete object]"));
616 /* Print out object: enclosing type is same as real_type if full */
617 return val_print (value_enclosing_type (val
),
618 value_contents_all (val
), 0,
619 VALUE_ADDRESS (val
), stream
, format
, 1, 0,
620 pretty
, current_language
);
621 /* Note: When we look up RTTI entries, we don't get any information on
622 const or volatile attributes */
624 else if (type
!= check_typedef (value_enclosing_type (val
)))
626 /* No RTTI information, so let's do our best */
627 fprintf_filtered (stream
, "(%s ?) ",
628 TYPE_NAME (value_enclosing_type (val
)));
629 return val_print (value_enclosing_type (val
),
630 value_contents_all (val
), 0,
631 VALUE_ADDRESS (val
), stream
, format
, 1, 0,
632 pretty
, current_language
);
634 /* Otherwise, we end up at the return outside this "if" */
637 return val_print (type
, value_contents_all (val
),
638 value_embedded_offset (val
),
639 VALUE_ADDRESS (val
) + value_offset (val
),
640 stream
, format
, 1, 0, pretty
, current_language
);