1 /* Support for printing C values for GDB, the GNU debugger.
3 Copyright 1986, 1988, 1989, 1991, 1992, 1993, 1994, 1995, 1996,
4 1997, 1998, 1999, 2000, 2001, 2003 Free Software Foundation, Inc.
6 This file is part of GDB.
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 2 of the License, or
11 (at your option) any later version.
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.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
24 #include "gdb_string.h"
27 #include "expression.h"
36 /* Print function pointer with inferior address ADDRESS onto stdio
40 print_function_pointer_address (CORE_ADDR address, struct ui_file *stream)
42 CORE_ADDR func_addr = gdbarch_convert_from_func_ptr_addr (current_gdbarch,
46 /* If the function pointer is represented by a description, print the
47 address of the description. */
48 if (addressprint && func_addr != address)
50 fputs_filtered ("@", stream);
51 print_address_numeric (address, 1, stream);
52 fputs_filtered (": ", stream);
54 print_address_demangle (func_addr, stream, demangle);
58 /* Print data of type TYPE located at VALADDR (within GDB), which came from
59 the inferior at address ADDRESS, onto stdio stream STREAM according to
60 FORMAT (a letter or 0 for natural format). The data at VALADDR is in
63 If the data are a string pointer, returns the number of string characters
66 If DEREF_REF is nonzero, then dereference references, otherwise just print
69 The PRETTY parameter controls prettyprinting. */
72 c_val_print (struct type *type, char *valaddr, int embedded_offset,
73 CORE_ADDR address, struct ui_file *stream, int format,
74 int deref_ref, int recurse, enum val_prettyprint pretty)
76 unsigned int i = 0; /* Number of characters printed */
84 switch (TYPE_CODE (type))
87 elttype = check_typedef (TYPE_TARGET_TYPE (type));
88 if (TYPE_LENGTH (type) > 0 && TYPE_LENGTH (TYPE_TARGET_TYPE (type)) > 0)
90 eltlen = TYPE_LENGTH (elttype);
91 len = TYPE_LENGTH (type) / eltlen;
92 if (prettyprint_arrays)
94 print_spaces_filtered (2 + 2 * recurse, stream);
96 /* For an array of chars, print with string syntax. */
98 ((TYPE_CODE (elttype) == TYPE_CODE_INT)
99 || ((current_language->la_language == language_m2)
100 && (TYPE_CODE (elttype) == TYPE_CODE_CHAR)))
101 && (format == 0 || format == 's'))
103 /* If requested, look for the first null char and only print
104 elements up to it. */
105 if (stop_print_at_null)
107 unsigned int temp_len;
109 /* Look for a NULL char. */
111 (valaddr + embedded_offset)[temp_len]
112 && temp_len < len && temp_len < print_max;
117 LA_PRINT_STRING (stream, valaddr + embedded_offset, len, eltlen, 0);
122 fprintf_filtered (stream, "{");
123 /* If this is a virtual function table, print the 0th
124 entry specially, and the rest of the members normally. */
125 if (cp_is_vtbl_ptr_type (elttype))
128 fprintf_filtered (stream, "%d vtable entries", len - 1);
134 val_print_array_elements (type, valaddr + embedded_offset, address, stream,
135 format, deref_ref, recurse, pretty, i);
136 fprintf_filtered (stream, "}");
140 /* Array of unspecified length: treat like pointer to first elt. */
142 goto print_unpacked_pointer;
145 if (format && format != 's')
147 print_scalar_formatted (valaddr + embedded_offset, type, format, 0, stream);
150 if (vtblprint && cp_is_vtbl_ptr_type (type))
152 /* Print the unmangled name if desired. */
153 /* Print vtable entry - we only get here if we ARE using
154 -fvtable_thunks. (Otherwise, look under TYPE_CODE_STRUCT.) */
156 = extract_typed_address (valaddr + embedded_offset, type);
157 print_function_pointer_address (addr, stream);
160 elttype = check_typedef (TYPE_TARGET_TYPE (type));
161 if (TYPE_CODE (elttype) == TYPE_CODE_METHOD)
163 cp_print_class_method (valaddr + embedded_offset, type, stream);
165 else if (TYPE_CODE (elttype) == TYPE_CODE_MEMBER)
167 cp_print_class_member (valaddr + embedded_offset,
168 TYPE_DOMAIN_TYPE (TYPE_TARGET_TYPE (type)),
173 addr = unpack_pointer (type, valaddr + embedded_offset);
174 print_unpacked_pointer:
176 if (TYPE_CODE (elttype) == TYPE_CODE_FUNC)
178 /* Try to print what function it points to. */
179 print_function_pointer_address (addr, stream);
180 /* Return value is irrelevant except for string pointers. */
184 if (addressprint && format != 's')
186 print_address_numeric (addr, 1, stream);
189 /* For a pointer to char or unsigned char, also print the string
190 pointed to, unless pointer is null. */
191 /* FIXME: need to handle wchar_t here... */
193 if (TYPE_LENGTH (elttype) == 1
194 && TYPE_CODE (elttype) == TYPE_CODE_INT
195 && (format == 0 || format == 's')
198 i = val_print_string (addr, -1, TYPE_LENGTH (elttype), stream);
200 else if (cp_is_vtbl_member (type))
202 /* print vtbl's nicely */
203 CORE_ADDR vt_address = unpack_pointer (type, valaddr + embedded_offset);
205 struct minimal_symbol *msymbol =
206 lookup_minimal_symbol_by_pc (vt_address);
207 if ((msymbol != NULL) &&
208 (vt_address == SYMBOL_VALUE_ADDRESS (msymbol)))
210 fputs_filtered (" <", stream);
211 fputs_filtered (SYMBOL_PRINT_NAME (msymbol), stream);
212 fputs_filtered (">", stream);
214 if (vt_address && vtblprint)
216 struct value *vt_val;
217 struct symbol *wsym = (struct symbol *) NULL;
219 struct block *block = (struct block *) NULL;
223 wsym = lookup_symbol (DEPRECATED_SYMBOL_NAME (msymbol), block,
224 VAR_DOMAIN, &is_this_fld, NULL);
228 wtype = SYMBOL_TYPE (wsym);
232 wtype = TYPE_TARGET_TYPE (type);
234 vt_val = value_at (wtype, vt_address);
235 val_print (value_type (vt_val), VALUE_CONTENTS (vt_val), 0,
236 VALUE_ADDRESS (vt_val), stream, format,
237 deref_ref, recurse + 1, pretty);
240 fprintf_filtered (stream, "\n");
241 print_spaces_filtered (2 + 2 * recurse, stream);
246 /* Return number of characters printed, including the terminating
247 '\0' if we reached the end. val_print_string takes care including
248 the terminating '\0' if necessary. */
253 case TYPE_CODE_MEMBER:
254 error ("not implemented: member type in c_val_print");
258 elttype = check_typedef (TYPE_TARGET_TYPE (type));
259 if (TYPE_CODE (elttype) == TYPE_CODE_MEMBER)
261 cp_print_class_member (valaddr + embedded_offset,
262 TYPE_DOMAIN_TYPE (elttype),
269 = extract_typed_address (valaddr + embedded_offset, type);
270 fprintf_filtered (stream, "@");
271 print_address_numeric (addr, 1, stream);
273 fputs_filtered (": ", stream);
275 /* De-reference the reference. */
278 if (TYPE_CODE (elttype) != TYPE_CODE_UNDEF)
280 struct value *deref_val =
282 (TYPE_TARGET_TYPE (type),
283 unpack_pointer (lookup_pointer_type (builtin_type_void),
284 valaddr + embedded_offset));
285 val_print (value_type (deref_val),
286 VALUE_CONTENTS (deref_val),
288 VALUE_ADDRESS (deref_val),
296 fputs_filtered ("???", stream);
300 case TYPE_CODE_UNION:
301 if (recurse && !unionprint)
303 fprintf_filtered (stream, "{...}");
307 case TYPE_CODE_STRUCT:
308 /*FIXME: Abstract this away */
309 if (vtblprint && cp_is_vtbl_ptr_type (type))
311 /* Print the unmangled name if desired. */
312 /* Print vtable entry - we only get here if NOT using
313 -fvtable_thunks. (Otherwise, look under TYPE_CODE_PTR.) */
314 int offset = (embedded_offset +
315 TYPE_FIELD_BITPOS (type, VTBL_FNADDR_OFFSET) / 8);
316 struct type *field_type = TYPE_FIELD_TYPE (type, VTBL_FNADDR_OFFSET);
318 = extract_typed_address (valaddr + offset, field_type);
320 print_function_pointer_address (addr, stream);
323 cp_print_value_fields (type, type, valaddr, embedded_offset, address, stream, format,
324 recurse, pretty, NULL, 0);
330 print_scalar_formatted (valaddr + embedded_offset, type, format, 0, stream);
333 len = TYPE_NFIELDS (type);
334 val = unpack_long (type, valaddr + embedded_offset);
335 for (i = 0; i < len; i++)
338 if (val == TYPE_FIELD_BITPOS (type, i))
345 fputs_filtered (TYPE_FIELD_NAME (type, i), stream);
349 print_longest (stream, 'd', 0, val);
356 print_scalar_formatted (valaddr + embedded_offset, type, format, 0, stream);
359 /* FIXME, we should consider, at least for ANSI C language, eliminating
360 the distinction made between FUNCs and POINTERs to FUNCs. */
361 fprintf_filtered (stream, "{");
362 type_print (type, "", stream, -1);
363 fprintf_filtered (stream, "} ");
364 /* Try to print what function it points to, and its address. */
365 print_address_demangle (address, stream, demangle);
369 format = format ? format : output_format;
371 print_scalar_formatted (valaddr + embedded_offset, type, format, 0, stream);
374 val = unpack_long (type, valaddr + embedded_offset);
376 fputs_filtered ("false", stream);
378 fputs_filtered ("true", stream);
380 print_longest (stream, 'd', 0, val);
384 case TYPE_CODE_RANGE:
385 /* FIXME: create_range_type does not set the unsigned bit in a
386 range type (I think it probably should copy it from the target
387 type), so we won't print values which are too large to
388 fit in a signed integer correctly. */
389 /* FIXME: Doesn't handle ranges of enums correctly. (Can't just
390 print with the target type, though, because the size of our type
391 and the target type might differ). */
395 format = format ? format : output_format;
398 print_scalar_formatted (valaddr + embedded_offset, type, format, 0, stream);
402 val_print_type_code_int (type, valaddr + embedded_offset, stream);
403 /* C and C++ has no single byte int type, char is used instead.
404 Since we don't know whether the value is really intended to
405 be used as an integer or a character, print the character
406 equivalent as well. */
407 if (TYPE_LENGTH (type) == 1)
409 fputs_filtered (" ", stream);
410 LA_PRINT_CHAR ((unsigned char) unpack_long (type, valaddr + embedded_offset),
417 format = format ? format : output_format;
420 print_scalar_formatted (valaddr + embedded_offset, type, format, 0, stream);
424 val = unpack_long (type, valaddr + embedded_offset);
425 if (TYPE_UNSIGNED (type))
426 fprintf_filtered (stream, "%u", (unsigned int) val);
428 fprintf_filtered (stream, "%d", (int) val);
429 fputs_filtered (" ", stream);
430 LA_PRINT_CHAR ((unsigned char) val, stream);
437 print_scalar_formatted (valaddr + embedded_offset, type, format, 0, stream);
441 print_floating (valaddr + embedded_offset, type, stream);
445 case TYPE_CODE_METHOD:
447 struct value *v = value_at (type, address);
448 cp_print_class_method (VALUE_CONTENTS (value_addr (v)),
449 lookup_pointer_type (type), stream);
454 fprintf_filtered (stream, "void");
457 case TYPE_CODE_ERROR:
458 fprintf_filtered (stream, "<error type>");
461 case TYPE_CODE_UNDEF:
462 /* This happens (without TYPE_FLAG_STUB set) on systems which don't use
463 dbx xrefs (NO_DBX_XREFS in gcc) if a file has a "struct foo *bar"
464 and no complete type for struct foo in that file. */
465 fprintf_filtered (stream, "<incomplete type>");
468 case TYPE_CODE_COMPLEX:
470 print_scalar_formatted (valaddr + embedded_offset,
471 TYPE_TARGET_TYPE (type),
474 print_floating (valaddr + embedded_offset, TYPE_TARGET_TYPE (type),
476 fprintf_filtered (stream, " + ");
478 print_scalar_formatted (valaddr + embedded_offset
479 + TYPE_LENGTH (TYPE_TARGET_TYPE (type)),
480 TYPE_TARGET_TYPE (type),
483 print_floating (valaddr + embedded_offset
484 + TYPE_LENGTH (TYPE_TARGET_TYPE (type)),
485 TYPE_TARGET_TYPE (type),
487 fprintf_filtered (stream, " * I");
491 error ("Invalid C/C++ type code %d in symbol table.", TYPE_CODE (type));
498 c_value_print (struct value *val, struct ui_file *stream, int format,
499 enum val_prettyprint pretty)
501 struct type *type = value_type (val);
502 struct type *real_type;
503 int full, top, using_enc;
505 /* If it is a pointer, indicate what it points to.
507 Print type also if it is a reference.
509 C++: if it is a member pointer, we will take care
510 of that when we print it. */
511 if (TYPE_CODE (type) == TYPE_CODE_PTR ||
512 TYPE_CODE (type) == TYPE_CODE_REF)
514 /* Hack: remove (char *) for char strings. Their
515 type is indicated by the quoted string anyway. */
516 if (TYPE_CODE (type) == TYPE_CODE_PTR &&
517 TYPE_NAME (type) == NULL &&
518 TYPE_NAME (TYPE_TARGET_TYPE (type)) != NULL &&
519 strcmp (TYPE_NAME (TYPE_TARGET_TYPE (type)), "char") == 0)
523 else if (objectprint && (TYPE_CODE (TYPE_TARGET_TYPE (type)) == TYPE_CODE_CLASS))
526 if (TYPE_CODE(type) == TYPE_CODE_REF)
528 /* Copy value, change to pointer, so we don't get an
529 * error about a non-pointer type in value_rtti_target_type
531 struct value *temparg;
532 temparg=value_copy(val);
533 temparg->type = lookup_pointer_type (TYPE_TARGET_TYPE(type));
536 /* Pointer to class, check real type of object */
537 fprintf_filtered (stream, "(");
538 real_type = value_rtti_target_type (val, &full, &top, &using_enc);
541 /* RTTI entry found */
542 if (TYPE_CODE (type) == TYPE_CODE_PTR)
544 /* create a pointer type pointing to the real type */
545 type = lookup_pointer_type (real_type);
549 /* create a reference type referencing the real type */
550 type = lookup_reference_type (real_type);
552 /* JYG: Need to adjust pointer value. */
553 val->aligner.contents[0] -= top;
555 /* Note: When we look up RTTI entries, we don't get any
556 information on const or volatile attributes */
558 type_print (type, "", stream, -1);
559 fprintf_filtered (stream, ") ");
564 fprintf_filtered (stream, "(");
565 type_print (type, "", stream, -1);
566 fprintf_filtered (stream, ") ");
569 if (objectprint && (TYPE_CODE (value_type (val)) == TYPE_CODE_CLASS))
571 /* Attempt to determine real type of object */
572 real_type = value_rtti_type (val, &full, &top, &using_enc);
575 /* We have RTTI information, so use it */
576 val = value_full_object (val, real_type, full, top, using_enc);
577 fprintf_filtered (stream, "(%s%s) ",
578 TYPE_NAME (real_type),
579 full ? "" : " [incomplete object]");
580 /* Print out object: enclosing type is same as real_type if full */
581 return val_print (VALUE_ENCLOSING_TYPE (val), VALUE_CONTENTS_ALL (val), 0,
582 VALUE_ADDRESS (val), stream, format, 1, 0, pretty);
583 /* Note: When we look up RTTI entries, we don't get any information on
584 const or volatile attributes */
586 else if (type != VALUE_ENCLOSING_TYPE (val))
588 /* No RTTI information, so let's do our best */
589 fprintf_filtered (stream, "(%s ?) ",
590 TYPE_NAME (VALUE_ENCLOSING_TYPE (val)));
591 return val_print (VALUE_ENCLOSING_TYPE (val), VALUE_CONTENTS_ALL (val), 0,
592 VALUE_ADDRESS (val), stream, format, 1, 0, pretty);
594 /* Otherwise, we end up at the return outside this "if" */
597 return val_print (type, VALUE_CONTENTS_ALL (val),
598 VALUE_EMBEDDED_OFFSET (val),
599 VALUE_ADDRESS (val) + value_offset (val),
600 stream, format, 1, 0, pretty);