* config/m68k/nm-hp300bsd.h: Correctly identify 4.3BSD vs 4.4BSD.
[deliverable/binutils-gdb.git] / gdb / valprint.c
CommitLineData
7d9884b9
JG
1/* Print values for GDB, the GNU debugger.
2 Copyright 1986, 1988, 1989, 1991 Free Software Foundation, Inc.
bd5635a1
RP
3
4This file is part of GDB.
5
36b9d39c 6This program is free software; you can redistribute it and/or modify
bd5635a1 7it under the terms of the GNU General Public License as published by
36b9d39c
JG
8the Free Software Foundation; either version 2 of the License, or
9(at your option) any later version.
bd5635a1 10
36b9d39c 11This program is distributed in the hope that it will be useful,
bd5635a1
RP
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
36b9d39c
JG
17along with this program; if not, write to the Free Software
18Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
bd5635a1 19
bd5635a1 20#include "defs.h"
2cd99985 21#include <string.h>
bd5635a1 22#include "symtab.h"
2cd99985 23#include "gdbtypes.h"
bd5635a1
RP
24#include "value.h"
25#include "gdbcore.h"
26#include "gdbcmd.h"
27#include "target.h"
28#include "obstack.h"
be3bc7ad 29#include "language.h"
8f793aa5 30#include "demangle.h"
bd5635a1
RP
31
32#include <errno.h>
2cd99985
PB
33
34/* Prototypes for local functions */
35
a8a69e63 36static void
199b2450 37print_hex_chars PARAMS ((GDB_FILE *, unsigned char *, unsigned int));
a8a69e63 38
2cd99985
PB
39static void
40show_print PARAMS ((char *, int));
41
42static void
43set_print PARAMS ((char *, int));
44
45static void
ce13daa7
FF
46set_radix PARAMS ((char *, int));
47
48static void
49show_radix PARAMS ((char *, int));
50
51static void
52set_input_radix PARAMS ((char *, int, struct cmd_list_element *));
53
54static void
55set_input_radix_1 PARAMS ((int, unsigned));
2cd99985
PB
56
57static void
58set_output_radix PARAMS ((char *, int, struct cmd_list_element *));
59
ce13daa7
FF
60static void
61set_output_radix_1 PARAMS ((int, unsigned));
62
2cd99985 63static void
199b2450 64value_print_array_elements PARAMS ((value, GDB_FILE *, int, enum val_prettyprint));
bd5635a1 65
ce13daa7
FF
66/* Maximum number of chars to print for a string pointer value or vector
67 contents, or UINT_MAX for no limit. Note that "set print elements 0"
68 stores UINT_MAX in print_max, which displays in a show command as
69 "unlimited". */
bd5635a1 70
85f0a848 71unsigned int print_max;
ce13daa7 72#define PRINT_MAX_DEFAULT 200 /* Start print_max off at this value. */
bd5635a1 73
bd5635a1
RP
74/* Default input and output radixes, and output format letter. */
75
76unsigned input_radix = 10;
77unsigned output_radix = 10;
78int output_format = 0;
79
85f0a848
FF
80/* Print repeat counts if there are more than this many repetitions of an
81 element in an array. Referenced by the low level language dependent
82 print routines. */
83
84unsigned int repeat_count_threshold = 10;
0dce3774 85
a8a69e63
FF
86int prettyprint_structs; /* Controls pretty printing of structures */
87int prettyprint_arrays; /* Controls pretty printing of arrays. */
0dce3774 88
a8a69e63
FF
89/* If nonzero, causes unions inside structures or other unions to be
90 printed. */
bd5635a1 91
a8a69e63 92int unionprint; /* Controls printing of nested unions. */
bd5635a1 93
a8a69e63 94/* If nonzero, causes machine addresses to be printed in certain contexts. */
bd5635a1 95
a8a69e63 96int addressprint; /* Controls printing of machine addresses */
bd5635a1 97
a8a69e63 98\f
c7da3ed3
FF
99/* Print data of type TYPE located at VALADDR (within GDB), which came from
100 the inferior at address ADDRESS, onto stdio stream STREAM according to
101 FORMAT (a letter, or 0 for natural format using TYPE).
bd5635a1 102
c7da3ed3
FF
103 If DEREF_REF is nonzero, then dereference references, otherwise just print
104 them like pointers.
bd5635a1 105
c7da3ed3
FF
106 The PRETTY parameter controls prettyprinting.
107
108 If the data are a string pointer, returns the number of string characters
109 printed.
110
111 FIXME: The data at VALADDR is in target byte order. If gdb is ever
112 enhanced to be able to debug more than the single target it was compiled
113 for (specific CPU type and thus specific target byte ordering), then
114 either the print routines are going to have to take this into account,
115 or the data is going to have to be passed into here already converted
116 to the host byte ordering, whichever is more convenient. */
bd5635a1 117
bd5635a1 118
a8a69e63 119int
c7da3ed3 120val_print (type, valaddr, address, stream, format, deref_ref, recurse, pretty)
a8a69e63
FF
121 struct type *type;
122 char *valaddr;
123 CORE_ADDR address;
199b2450 124 GDB_FILE *stream;
a8a69e63
FF
125 int format;
126 int deref_ref;
127 int recurse;
128 enum val_prettyprint pretty;
bd5635a1 129{
a8a69e63
FF
130 if (pretty == Val_pretty_default)
131 {
132 pretty = prettyprint_structs ? Val_prettyprint : Val_no_prettyprint;
133 }
bd5635a1 134
a8a69e63
FF
135 QUIT;
136
137 /* Ensure that the type is complete and not just a stub. If the type is
138 only a stub and we can't find and substitute its complete type, then
139 print appropriate string and return. Typical types that my be stubs
140 are structs, unions, and C++ methods. */
141
142 check_stub_type (type);
143 if (TYPE_FLAGS (type) & TYPE_FLAG_STUB)
bd5635a1 144 {
a8a69e63 145 fprintf_filtered (stream, "<incomplete type>");
199b2450 146 gdb_flush (stream);
a8a69e63 147 return (0);
bd5635a1 148 }
a8a69e63
FF
149
150 return (LA_VAL_PRINT (type, valaddr, address, stream, format, deref_ref,
151 recurse, pretty));
bd5635a1 152}
a8a69e63 153
bd5635a1
RP
154/* Print the value VAL in C-ish syntax on stream STREAM.
155 FORMAT is a format-letter, or 0 for print in natural format of data type.
156 If the object printed is a string pointer, returns
157 the number of string bytes printed. */
158
159int
160value_print (val, stream, format, pretty)
161 value val;
199b2450 162 GDB_FILE *stream;
2cd99985 163 int format;
bd5635a1
RP
164 enum val_prettyprint pretty;
165{
a8a69e63 166 register unsigned int n, typelen;
bd5635a1
RP
167
168 if (val == 0)
169 {
170 printf_filtered ("<address of value unknown>");
171 return 0;
172 }
173 if (VALUE_OPTIMIZED_OUT (val))
174 {
175 printf_filtered ("<value optimized out>");
176 return 0;
177 }
aec4cb91 178
bd5635a1
RP
179 /* A "repeated" value really contains several values in a row.
180 They are made by the @ operator.
181 Print such values as if they were arrays. */
182
a8a69e63 183 if (VALUE_REPEATED (val))
bd5635a1
RP
184 {
185 n = VALUE_REPETITIONS (val);
186 typelen = TYPE_LENGTH (VALUE_TYPE (val));
187 fprintf_filtered (stream, "{");
188 /* Print arrays of characters using string syntax. */
189 if (typelen == 1 && TYPE_CODE (VALUE_TYPE (val)) == TYPE_CODE_INT
190 && format == 0)
a8a69e63 191 LA_PRINT_STRING (stream, VALUE_CONTENTS (val), n, 0);
bd5635a1
RP
192 else
193 {
a8a69e63 194 value_print_array_elements (val, stream, format, pretty);
bd5635a1
RP
195 }
196 fprintf_filtered (stream, "}");
a8a69e63 197 return (n * typelen);
bd5635a1
RP
198 }
199 else
200 {
0dce3774
JK
201 struct type *type = VALUE_TYPE (val);
202
bd5635a1
RP
203 /* If it is a pointer, indicate what it points to.
204
205 Print type also if it is a reference.
206
207 C++: if it is a member pointer, we will take care
208 of that when we print it. */
a8a69e63
FF
209 if (TYPE_CODE (type) == TYPE_CODE_PTR ||
210 TYPE_CODE (type) == TYPE_CODE_REF)
bd5635a1
RP
211 {
212 /* Hack: remove (char *) for char strings. Their
213 type is indicated by the quoted string anyway. */
a8a69e63
FF
214 if (TYPE_CODE (type) == TYPE_CODE_PTR &&
215 TYPE_LENGTH (TYPE_TARGET_TYPE (type)) == sizeof(char) &&
216 TYPE_CODE (TYPE_TARGET_TYPE (type)) == TYPE_CODE_INT &&
217 !TYPE_UNSIGNED (TYPE_TARGET_TYPE (type)))
bd5635a1
RP
218 {
219 /* Print nothing */
220 }
a8a69e63
FF
221 else
222 {
223 fprintf_filtered (stream, "(");
224 type_print (type, "", stream, -1);
225 fprintf_filtered (stream, ") ");
226 }
227 }
228 return (val_print (type, VALUE_CONTENTS (val),
229 VALUE_ADDRESS (val), stream, format, 1, 0, pretty));
bd5635a1
RP
230 }
231}
232
a8a69e63
FF
233/* Called by various <lang>_val_print routines to print TYPE_CODE_INT's */
234
235void
236val_print_type_code_int (type, valaddr, stream)
9e4667f6 237 struct type *type;
a8a69e63 238 char *valaddr;
199b2450 239 GDB_FILE *stream;
9e4667f6 240{
a8a69e63
FF
241 char *p;
242 /* Pointer to first (i.e. lowest address) nonzero character. */
243 char *first_addr;
244 unsigned int len;
9e4667f6 245
a8a69e63 246 if (TYPE_LENGTH (type) > sizeof (LONGEST))
9e4667f6 247 {
a8a69e63 248 if (TYPE_UNSIGNED (type))
9e4667f6 249 {
a8a69e63
FF
250 /* First figure out whether the number in fact has zeros
251 in all its bytes more significant than least significant
252 sizeof (LONGEST) ones. */
253 len = TYPE_LENGTH (type);
254
255#if TARGET_BYTE_ORDER == BIG_ENDIAN
256 for (p = valaddr;
257 len > sizeof (LONGEST) && p < valaddr + TYPE_LENGTH (type);
258 p++)
259#else /* Little endian. */
260 first_addr = valaddr;
199b2450 261 for (p = valaddr + TYPE_LENGTH (type) - 1;
a8a69e63
FF
262 len > sizeof (LONGEST) && p >= valaddr;
263 p--)
264#endif /* Little endian. */
9e4667f6 265 {
a8a69e63 266 if (*p == 0)
9e4667f6 267 {
a8a69e63 268 len--;
9e4667f6 269 }
a8a69e63 270 else
9e4667f6 271 {
a8a69e63 272 break;
9e4667f6
FF
273 }
274 }
a8a69e63
FF
275#if TARGET_BYTE_ORDER == BIG_ENDIAN
276 first_addr = p;
277#endif
278 if (len <= sizeof (LONGEST))
279 {
280 /* We can print it in decimal. */
7efb57c3
FF
281 print_longest (stream, 'u', 0,
282 unpack_long (BUILTIN_TYPE_LONGEST, first_addr));
a8a69e63
FF
283 }
284 else
285 {
286 /* It is big, so print it in hex. */
287 print_hex_chars (stream, (unsigned char *) first_addr, len);
288 }
289 }
290 else
291 {
292 /* Signed. One could assume two's complement (a reasonable
293 assumption, I think) and do better than this. */
294 print_hex_chars (stream, (unsigned char *) valaddr,
295 TYPE_LENGTH (type));
9e4667f6
FF
296 }
297 }
a8a69e63
FF
298 else
299 {
300#ifdef PRINT_TYPELESS_INTEGER
301 PRINT_TYPELESS_INTEGER (stream, type, unpack_long (type, valaddr));
302#else
7efb57c3
FF
303 print_longest (stream, TYPE_UNSIGNED (type) ? 'u' : 'd', 0,
304 unpack_long (type, valaddr));
a8a69e63
FF
305#endif
306 }
b0f61d04 307}
9e4667f6 308
7efb57c3
FF
309/* Print a number according to FORMAT which is one of d,u,x,o,b,h,w,g.
310 The raison d'etre of this function is to consolidate printing of LONG_LONG's
311 into this one function. Some platforms have long longs but don't have a
312 printf() that supports "ll" in the format string. We handle these by seeing
313 if the number is actually a long, and if not we just bail out and print the
314 number in hex. The format chars b,h,w,g are from
315 print_scalar_formatted(). USE_LOCAL says whether or not to call the
316 local formatting routine to get the format. */
317
318void
319print_longest (stream, format, use_local, val_long)
199b2450 320 GDB_FILE *stream;
ce13daa7 321 int format;
7efb57c3
FF
322 int use_local;
323 LONGEST val_long;
324{
325#if defined (CC_HAS_LONG_LONG) && !defined (PRINTF_HAS_LONG_LONG)
326 long vtop, vbot;
327
328 vtop = val_long >> (sizeof (long) * HOST_CHAR_BIT);
329 vbot = (long) val_long;
330
331 if ((format == 'd' && (val_long < INT_MIN || val_long > INT_MAX))
332 || ((format == 'u' || format == 'x') && val_long > UINT_MAX))
333 {
199b2450 334 fprintf_filtered (stream, "0x%lx%08lx", vtop, vbot);
7efb57c3
FF
335 return;
336 }
337#endif
338
339#ifdef PRINTF_HAS_LONG_LONG
340 switch (format)
341 {
342 case 'd':
343 fprintf_filtered (stream,
344 use_local ? local_decimal_format_custom ("ll")
345 : "%lld",
346 val_long);
347 break;
348 case 'u':
349 fprintf_filtered (stream, "%llu", val_long);
350 break;
351 case 'x':
352 fprintf_filtered (stream,
353 use_local ? local_hex_format_custom ("ll")
354 : "%llx",
355 val_long);
356 break;
357 case 'o':
358 fprintf_filtered (stream,
359 use_local ? local_octal_format_custom ("ll")
360 : "%llo",
361 break;
362 case 'b':
363 fprintf_filtered (stream, local_hex_format_custom ("02ll"), val_long);
364 break;
365 case 'h':
366 fprintf_filtered (stream, local_hex_format_custom ("04ll"), val_long);
367 break;
368 case 'w':
369 fprintf_filtered (stream, local_hex_format_custom ("08ll"), val_long);
370 break;
371 case 'g':
372 fprintf_filtered (stream, local_hex_format_custom ("016ll"), val_long);
373 break;
374 default:
375 abort ();
376 }
377#else /* !PRINTF_HAS_LONG_LONG */
378 /* In the following it is important to coerce (val_long) to a long. It does
379 nothing if !LONG_LONG, but it will chop off the top half (which we know
380 we can ignore) if the host supports long longs. */
381
382 switch (format)
383 {
384 case 'd':
385 fprintf_filtered (stream,
386 use_local ? local_decimal_format_custom ("l")
387 : "%ld",
388 (long) val_long);
389 break;
390 case 'u':
391 fprintf_filtered (stream, "%lu", (unsigned long) val_long);
392 break;
393 case 'x':
394 fprintf_filtered (stream,
395 use_local ? local_hex_format_custom ("l")
396 : "%lx",
397 (long) val_long);
398 break;
399 case 'o':
400 fprintf_filtered (stream,
401 use_local ? local_octal_format_custom ("l")
402 : "%lo",
403 (long) val_long);
404 break;
405 case 'b':
406 fprintf_filtered (stream, local_hex_format_custom ("02l"),
407 (long) val_long);
408 break;
409 case 'h':
410 fprintf_filtered (stream, local_hex_format_custom ("04l"),
411 (long) val_long);
412 break;
413 case 'w':
414 fprintf_filtered (stream, local_hex_format_custom ("08l"),
415 (long) val_long);
416 break;
417 case 'g':
418 fprintf_filtered (stream, local_hex_format_custom ("016l"),
419 (long) val_long);
420 break;
421 default:
422 abort ();
423 }
424#endif /* !PRINTF_HAS_LONG_LONG */
425}
426
a8a69e63
FF
427/* Print a floating point value of type TYPE, pointed to in GDB by VALADDR,
428 on STREAM. */
bd5635a1 429
a8a69e63
FF
430void
431print_floating (valaddr, type, stream)
432 char *valaddr;
bd5635a1 433 struct type *type;
199b2450 434 GDB_FILE *stream;
bd5635a1 435{
a8a69e63
FF
436 double doub;
437 int inv;
438 unsigned len = TYPE_LENGTH (type);
439
440#if defined (IEEE_FLOAT)
bd5635a1 441
a8a69e63
FF
442 /* Check for NaN's. Note that this code does not depend on us being
443 on an IEEE conforming system. It only depends on the target
444 machine using IEEE representation. This means (a)
445 cross-debugging works right, and (2) IEEE_FLOAT can (and should)
446 be defined for systems like the 68881, which uses IEEE
447 representation, but is not IEEE conforming. */
bd5635a1 448
a8a69e63 449 {
199b2450 450 unsigned long low, high;
a8a69e63
FF
451 /* Is the sign bit 0? */
452 int nonnegative;
453 /* Is it is a NaN (i.e. the exponent is all ones and
454 the fraction is nonzero)? */
455 int is_nan;
bd5635a1 456
199b2450 457 if (len == 4)
a8a69e63 458 {
199b2450
TL
459 /* It's single precision. */
460 /* Assume that floating point byte order is the same as
461 integer byte order. */
462 low = extract_unsigned_integer (valaddr, 4);
a8a69e63
FF
463 nonnegative = low >= 0;
464 is_nan = ((((low >> 23) & 0xFF) == 0xFF)
465 && 0 != (low & 0x7FFFFF));
466 low &= 0x7fffff;
467 high = 0;
468 }
199b2450 469 else if (len == 8)
a8a69e63
FF
470 {
471 /* It's double precision. Get the high and low words. */
bd5635a1 472
199b2450
TL
473 /* Assume that floating point byte order is the same as
474 integer byte order. */
a8a69e63 475#if TARGET_BYTE_ORDER == BIG_ENDIAN
199b2450
TL
476 low = extract_unsigned_integer (valaddr + 4, 4);
477 high = extract_unsigned_integer (valaddr, 4);
a8a69e63 478#else
199b2450
TL
479 low = extract_unsigned_integer (valaddr, 4);
480 high = extract_unsigned_integer (valaddr + 4, 4);
a8a69e63 481#endif
a8a69e63
FF
482 nonnegative = high >= 0;
483 is_nan = (((high >> 20) & 0x7ff) == 0x7ff
484 && ! ((((high & 0xfffff) == 0)) && (low == 0)));
485 high &= 0xfffff;
486 }
199b2450
TL
487 else
488 /* Extended. We can't detect NaNs for extendeds yet. Also note
489 that currently extendeds get nuked to double in
490 REGISTER_CONVERTIBLE. */
491 is_nan = 0;
bd5635a1 492
a8a69e63
FF
493 if (is_nan)
494 {
495 /* The meaning of the sign and fraction is not defined by IEEE.
496 But the user might know what they mean. For example, they
497 (in an implementation-defined manner) distinguish between
498 signaling and quiet NaN's. */
499 if (high)
500 fprintf_filtered (stream, "-NaN(0x%lx%.8lx)" + nonnegative,
501 high, low);
502 else
503 fprintf_filtered (stream, "-NaN(0x%lx)" + nonnegative, low);
504 return;
505 }
506 }
507#endif /* IEEE_FLOAT. */
bd5635a1 508
a8a69e63
FF
509 doub = unpack_double (type, valaddr, &inv);
510 if (inv)
511 fprintf_filtered (stream, "<invalid float value>");
512 else
513 fprintf_filtered (stream, len <= sizeof(float) ? "%.9g" : "%.17g", doub);
bd5635a1
RP
514}
515
a8a69e63 516/* VALADDR points to an integer of LEN bytes. Print it in hex on stream. */
bd5635a1
RP
517
518static void
a8a69e63 519print_hex_chars (stream, valaddr, len)
199b2450 520 GDB_FILE *stream;
a8a69e63
FF
521 unsigned char *valaddr;
522 unsigned len;
bd5635a1 523{
a8a69e63 524 unsigned char *p;
b0f61d04
JK
525
526 /* FIXME: We should be not printing leading zeroes in most cases. */
527
528 fprintf_filtered (stream, local_hex_format_prefix ());
a8a69e63
FF
529#if TARGET_BYTE_ORDER == BIG_ENDIAN
530 for (p = valaddr;
531 p < valaddr + len;
532 p++)
533#else /* Little endian. */
534 for (p = valaddr + len - 1;
535 p >= valaddr;
536 p--)
537#endif
bd5635a1 538 {
a8a69e63 539 fprintf_filtered (stream, "%02x", *p);
bd5635a1 540 }
b0f61d04 541 fprintf_filtered (stream, local_hex_format_suffix ());
a8a69e63 542}
bd5635a1 543
a8a69e63
FF
544/* Called by various <lang>_val_print routines to print elements of an
545 array in the form "<elem1>, <elem2>, <elem3>, ...".
4a11eef2 546
a8a69e63
FF
547 (FIXME?) Assumes array element separator is a comma, which is correct
548 for all languages currently handled.
549 (FIXME?) Some languages have a notation for repeated array elements,
550 perhaps we should try to use that notation when appropriate.
551 */
bd5635a1 552
a8a69e63
FF
553void
554val_print_array_elements (type, valaddr, address, stream, format, deref_ref,
555 recurse, pretty, i)
556 struct type *type;
557 char *valaddr;
558 CORE_ADDR address;
199b2450 559 GDB_FILE *stream;
a8a69e63
FF
560 int format;
561 int deref_ref;
562 int recurse;
563 enum val_prettyprint pretty;
564 unsigned int i;
565{
566 unsigned int things_printed = 0;
567 unsigned len;
568 struct type *elttype;
569 unsigned eltlen;
570 /* Position of the array element we are examining to see
571 whether it is repeated. */
572 unsigned int rep1;
573 /* Number of repetitions we have detected so far. */
574 unsigned int reps;
575
576 elttype = TYPE_TARGET_TYPE (type);
577 eltlen = TYPE_LENGTH (elttype);
578 len = TYPE_LENGTH (type) / eltlen;
579
580 for (; i < len && things_printed < print_max; i++)
bd5635a1 581 {
a8a69e63 582 if (i != 0)
bd5635a1 583 {
a8a69e63 584 if (prettyprint_arrays)
bd5635a1 585 {
a8a69e63
FF
586 fprintf_filtered (stream, ",\n");
587 print_spaces_filtered (2 + 2 * recurse, stream);
bd5635a1 588 }
a8a69e63 589 else
bd5635a1 590 {
a8a69e63 591 fprintf_filtered (stream, ", ");
bd5635a1 592 }
bd5635a1 593 }
a8a69e63
FF
594 wrap_here (n_spaces (2 + 2 * recurse));
595
596 rep1 = i + 1;
597 reps = 1;
598 while ((rep1 < len) &&
599 !memcmp (valaddr + i * eltlen, valaddr + rep1 * eltlen, eltlen))
600 {
601 ++reps;
602 ++rep1;
603 }
604
605 if (reps > repeat_count_threshold)
bd5635a1 606 {
a8a69e63
FF
607 val_print (elttype, valaddr + i * eltlen, 0, stream, format,
608 deref_ref, recurse + 1, pretty);
609 fprintf_filtered (stream, " <repeats %u times>", reps);
610 i = rep1 - 1;
611 things_printed += repeat_count_threshold;
bd5635a1 612 }
bd5635a1
RP
613 else
614 {
a8a69e63
FF
615 val_print (elttype, valaddr + i * eltlen, 0, stream, format,
616 deref_ref, recurse + 1, pretty);
617 things_printed++;
bd5635a1 618 }
a8a69e63
FF
619 }
620 if (i < len)
621 {
622 fprintf_filtered (stream, "...");
623 }
624}
e2aab031 625
a8a69e63
FF
626static void
627value_print_array_elements (val, stream, format, pretty)
628 value val;
199b2450 629 GDB_FILE *stream;
a8a69e63
FF
630 int format;
631 enum val_prettyprint pretty;
632{
633 unsigned int things_printed = 0;
634 register unsigned int i, n, typelen;
635 /* Position of the array elem we are examining to see if it is repeated. */
636 unsigned int rep1;
637 /* Number of repetitions we have detected so far. */
638 unsigned int reps;
639
640 n = VALUE_REPETITIONS (val);
641 typelen = TYPE_LENGTH (VALUE_TYPE (val));
642 for (i = 0; i < n && things_printed < print_max; i++)
643 {
644 if (i != 0)
645 {
646 fprintf_filtered (stream, ", ");
647 }
648 wrap_here ("");
649
650 rep1 = i + 1;
651 reps = 1;
652 while (rep1 < n && !memcmp (VALUE_CONTENTS (val) + typelen * i,
653 VALUE_CONTENTS (val) + typelen * rep1,
654 typelen))
655 {
656 ++reps;
657 ++rep1;
658 }
659
660 if (reps > repeat_count_threshold)
4ace50a5 661 {
a8a69e63
FF
662 val_print (VALUE_TYPE (val), VALUE_CONTENTS (val) + typelen * i,
663 VALUE_ADDRESS (val) + typelen * i, stream, format, 1,
664 0, pretty);
199b2450 665 fprintf_unfiltered (stream, " <repeats %u times>", reps);
a8a69e63
FF
666 i = rep1 - 1;
667 things_printed += repeat_count_threshold;
4ace50a5
FF
668 }
669 else
670 {
a8a69e63
FF
671 val_print (VALUE_TYPE (val), VALUE_CONTENTS (val) + typelen * i,
672 VALUE_ADDRESS (val) + typelen * i, stream, format, 1,
673 0, pretty);
674 things_printed++;
4ace50a5 675 }
a8a69e63
FF
676 }
677 if (i < n)
678 {
679 fprintf_filtered (stream, "...");
bd5635a1
RP
680 }
681}
a8a69e63 682
7efb57c3
FF
683/* Print a string from the inferior, starting at ADDR and printing up to LEN
684 characters, to STREAM. If LEN is zero, printing stops at the first null
685 byte, otherwise printing proceeds (including null bytes) until either
ce13daa7 686 print_max or LEN characters have been printed, whichever is smaller. */
7efb57c3 687
c7da3ed3 688int
7efb57c3 689val_print_string (addr, len, stream)
c7da3ed3 690 CORE_ADDR addr;
7efb57c3 691 unsigned int len;
199b2450 692 GDB_FILE *stream;
c7da3ed3 693{
ce13daa7
FF
694 int force_ellipsis = 0; /* Force ellipsis to be printed if nonzero. */
695 int errcode; /* Errno returned from bad reads. */
696 unsigned int fetchlimit; /* Maximum number of bytes to fetch. */
697 unsigned int nfetch; /* Bytes to fetch / bytes fetched. */
698 unsigned int chunksize; /* Size of each fetch, in bytes. */
699 int bufsize; /* Size of current fetch buffer. */
700 char *buffer = NULL; /* Dynamically growable fetch buffer. */
701 char *bufptr; /* Pointer to next available byte in buffer. */
702 char *limit; /* First location past end of fetch buffer. */
199b2450 703 struct cleanup *old_chain = NULL; /* Top of the old cleanup chain. */
ce13daa7
FF
704 char peekchar; /* Place into which we can read one char. */
705
706 /* First we need to figure out the limit on the number of characters we are
707 going to attempt to fetch and print. This is actually pretty simple. If
708 LEN is nonzero, then the limit is the minimum of LEN and print_max. If
709 LEN is zero, then the limit is print_max. This is true regardless of
710 whether print_max is zero, UINT_MAX (unlimited), or something in between,
711 because finding the null byte (or available memory) is what actually
712 limits the fetch. */
713
714 fetchlimit = (len == 0 ? print_max : min (len, print_max));
715
716 /* Now decide how large of chunks to try to read in one operation. This
717 is also pretty simple. If LEN is nonzero, then we want fetchlimit bytes,
718 so we might as well read them all in one operation. If LEN is zero, we
719 are looking for a null terminator to end the fetching, so we might as
720 well read in blocks that are large enough to be efficient, but not so
721 large as to be slow if fetchlimit happens to be large. So we choose the
722 minimum of DEFAULT_PRINT_MAX and fetchlimit. */
723
724 chunksize = (len == 0 ? min (PRINT_MAX_DEFAULT, fetchlimit) : fetchlimit);
725
726 /* Loop until we either have all the characters to print, or we encounter
727 some error, such as bumping into the end of the address space. */
728
729 bufsize = 0;
730 do {
731 QUIT;
732 /* Figure out how much to fetch this time, and grow the buffer to fit. */
733 nfetch = min (chunksize, fetchlimit - bufsize);
734 bufsize += nfetch;
735 if (buffer == NULL)
736 {
737 buffer = (char *) xmalloc (bufsize);
738 bufptr = buffer;
739 }
740 else
741 {
742 discard_cleanups (old_chain);
743 buffer = (char *) xrealloc (buffer, bufsize);
744 bufptr = buffer + bufsize - nfetch;
745 }
746 old_chain = make_cleanup (free, buffer);
747
748 /* Read as much as we can. */
749 nfetch = target_read_memory_partial (addr, bufptr, nfetch, &errcode);
750 if (len != 0)
751 {
752 addr += nfetch;
753 bufptr += nfetch;
754 }
755 else
756 {
757 /* Scan this chunk for the null byte that terminates the string
758 to print. If found, we don't need to fetch any more. Note
759 that bufptr is explicitly left pointing at the next character
760 after the null byte, or at the next character after the end of
761 the buffer. */
762 limit = bufptr + nfetch;
763 do {
764 addr++;
765 bufptr++;
766 } while (bufptr < limit && *(bufptr - 1) != '\0');
767 }
768 } while (errcode == 0 /* no error */
769 && bufptr < buffer + fetchlimit /* no overrun */
770 && !(len == 0 && *(bufptr - 1) == '\0')); /* no null term */
771
772 /* We now have either successfully filled the buffer to fetchlimit, or
773 terminated early due to an error or finding a null byte when LEN is
774 zero. */
775
776 if (len == 0 && *(bufptr - 1) != '\0')
c7da3ed3 777 {
ce13daa7
FF
778 /* We didn't find a null terminator we were looking for. Attempt
779 to peek at the next character. If not successful, or it is not
780 a null byte, then force ellipsis to be printed. */
781 if (target_read_memory (addr, &peekchar, 1) != 0 || peekchar != '\0')
7efb57c3 782 {
7efb57c3
FF
783 force_ellipsis = 1;
784 }
c7da3ed3 785 }
ce13daa7
FF
786 else if ((len != 0 && errcode != 0) || (len > bufptr - buffer))
787 {
788 /* Getting an error when we have a requested length, or fetching less
789 than the number of characters actually requested, always make us
790 print ellipsis. */
791 force_ellipsis = 1;
792 }
793
794 QUIT;
c7da3ed3 795
ce13daa7
FF
796 if (addressprint)
797 {
798 fputs_filtered (" ", stream);
799 }
800 LA_PRINT_STRING (stream, buffer, bufptr - buffer, force_ellipsis);
801
802 if (errcode != 0 && force_ellipsis)
c7da3ed3
FF
803 {
804 if (errcode == EIO)
805 {
199b2450
TL
806 fprintf_filtered (stream,
807 " <Address 0x%lx out of bounds>",
808 (unsigned long) addr);
c7da3ed3
FF
809 }
810 else
811 {
199b2450
TL
812 error ("Error reading memory address 0x%lx: %s.",
813 (unsigned long) addr,
c7da3ed3
FF
814 safe_strerror (errcode));
815 }
816 }
199b2450 817 gdb_flush (stream);
ce13daa7
FF
818 do_cleanups (old_chain);
819 return (bufptr - buffer);
c7da3ed3 820}
ce13daa7 821
bd5635a1
RP
822\f
823/* Validate an input or output radix setting, and make sure the user
824 knows what they really did here. Radix setting is confusing, e.g.
825 setting the input radix to "10" never changes it! */
826
e1ce8aa5 827/* ARGSUSED */
bd5635a1
RP
828static void
829set_input_radix (args, from_tty, c)
830 char *args;
831 int from_tty;
832 struct cmd_list_element *c;
833{
ce13daa7
FF
834 set_input_radix_1 (from_tty, *(unsigned *)c->var);
835}
bd5635a1 836
ce13daa7
FF
837/* ARGSUSED */
838static void
839set_input_radix_1 (from_tty, radix)
840 int from_tty;
841 unsigned radix;
842{
843 /* We don't currently disallow any input radix except 0 or 1, which don't
844 make any mathematical sense. In theory, we can deal with any input
845 radix greater than 1, even if we don't have unique digits for every
846 value from 0 to radix-1, but in practice we lose on large radix values.
847 We should either fix the lossage or restrict the radix range more.
848 (FIXME). */
849
850 if (radix < 2)
851 {
852 error ("Nonsense input radix ``decimal %u''; input radix unchanged.",
853 radix);
854 }
855 input_radix = radix;
bd5635a1 856 if (from_tty)
ce13daa7
FF
857 {
858 printf_filtered ("Input radix now set to decimal %u, hex %x, octal %o.\n",
859 radix, radix, radix);
860 }
bd5635a1
RP
861}
862
e1ce8aa5 863/* ARGSUSED */
bd5635a1
RP
864static void
865set_output_radix (args, from_tty, c)
866 char *args;
867 int from_tty;
868 struct cmd_list_element *c;
869{
ce13daa7
FF
870 set_output_radix_1 (from_tty, *(unsigned *)c->var);
871}
bd5635a1 872
ce13daa7
FF
873static void
874set_output_radix_1 (from_tty, radix)
875 int from_tty;
876 unsigned radix;
877{
878 /* Validate the radix and disallow ones that we aren't prepared to
879 handle correctly, leaving the radix unchanged. */
bd5635a1
RP
880 switch (radix)
881 {
882 case 16:
ce13daa7 883 output_format = 'x'; /* hex */
bd5635a1
RP
884 break;
885 case 10:
ce13daa7 886 output_format = 0; /* decimal */
bd5635a1
RP
887 break;
888 case 8:
889 output_format = 'o'; /* octal */
890 break;
891 default:
ce13daa7
FF
892 error ("Unsupported output radix ``decimal %u''; output radix unchanged.",
893 radix);
894 }
895 output_radix = radix;
896 if (from_tty)
897 {
898 printf_filtered ("Output radix now set to decimal %u, hex %x, octal %o.\n",
899 radix, radix, radix);
bd5635a1
RP
900 }
901}
902
ce13daa7
FF
903/* Set both the input and output radix at once. Try to set the output radix
904 first, since it has the most restrictive range. An radix that is valid as
905 an output radix is also valid as an input radix.
906
907 It may be useful to have an unusual input radix. If the user wishes to
908 set an input radix that is not valid as an output radix, he needs to use
909 the 'set input-radix' command. */
910
bd5635a1 911static void
ce13daa7 912set_radix (arg, from_tty)
bd5635a1
RP
913 char *arg;
914 int from_tty;
bd5635a1 915{
ce13daa7 916 unsigned radix;
bd5635a1 917
ce13daa7
FF
918 radix = (arg == NULL) ? 10 : parse_and_eval_address (arg);
919 set_output_radix_1 (0, radix);
920 set_input_radix_1 (0, radix);
bd5635a1 921 if (from_tty)
ce13daa7
FF
922 {
923 printf_filtered ("Input and output radices now set to decimal %u, hex %x, octal %o.\n",
924 radix, radix, radix);
925 }
926}
bd5635a1 927
ce13daa7 928/* Show both the input and output radices. */
bd5635a1 929
ce13daa7
FF
930/*ARGSUSED*/
931static void
932show_radix (arg, from_tty)
933 char *arg;
934 int from_tty;
935{
936 if (from_tty)
937 {
938 if (input_radix == output_radix)
939 {
940 printf_filtered ("Input and output radices set to decimal %u, hex %x, octal %o.\n",
941 input_radix, input_radix, input_radix);
942 }
943 else
944 {
945 printf_filtered ("Input radix set to decimal %u, hex %x, octal %o.\n",
946 input_radix, input_radix, input_radix);
947 printf_filtered ("Output radix set to decimal %u, hex %x, octal %o.\n",
948 output_radix, output_radix, output_radix);
949 }
950 }
bd5635a1 951}
ce13daa7 952
bd5635a1 953\f
f266e564
JK
954/*ARGSUSED*/
955static void
956set_print (arg, from_tty)
957 char *arg;
958 int from_tty;
959{
199b2450 960 printf_unfiltered (
f266e564 961"\"set print\" must be followed by the name of a print subcommand.\n");
199b2450 962 help_list (setprintlist, "set print ", -1, gdb_stdout);
f266e564
JK
963}
964
965/*ARGSUSED*/
966static void
967show_print (args, from_tty)
968 char *args;
969 int from_tty;
970{
971 cmd_show_list (showprintlist, from_tty, "");
972}
973\f
bd5635a1
RP
974void
975_initialize_valprint ()
976{
977 struct cmd_list_element *c;
978
f266e564
JK
979 add_prefix_cmd ("print", no_class, set_print,
980 "Generic command for setting how things print.",
981 &setprintlist, "set print ", 0, &setlist);
36b9d39c 982 add_alias_cmd ("p", "print", no_class, 1, &setlist);
199b2450
TL
983 /* prefer set print to set prompt */
984 add_alias_cmd ("pr", "print", no_class, 1, &setlist);
985
f266e564
JK
986 add_prefix_cmd ("print", no_class, show_print,
987 "Generic command for showing print settings.",
988 &showprintlist, "show print ", 0, &showlist);
36b9d39c
JG
989 add_alias_cmd ("p", "print", no_class, 1, &showlist);
990 add_alias_cmd ("pr", "print", no_class, 1, &showlist);
f266e564 991
bd5635a1 992 add_show_from_set
f266e564 993 (add_set_cmd ("elements", no_class, var_uinteger, (char *)&print_max,
bd5635a1 994 "Set limit on string chars or array elements to print.\n\
f266e564
JK
995\"set print elements 0\" causes there to be no limit.",
996 &setprintlist),
997 &showprintlist);
bd5635a1 998
85f0a848
FF
999 add_show_from_set
1000 (add_set_cmd ("repeats", no_class, var_uinteger,
1001 (char *)&repeat_count_threshold,
1002 "Set threshold for repeated print elements.\n\
1003\"set print repeats 0\" causes all elements to be individually printed.",
1004 &setprintlist),
1005 &showprintlist);
1006
bd5635a1 1007 add_show_from_set
a8a69e63
FF
1008 (add_set_cmd ("pretty", class_support, var_boolean,
1009 (char *)&prettyprint_structs,
bd5635a1 1010 "Set prettyprinting of structures.",
f266e564
JK
1011 &setprintlist),
1012 &showprintlist);
bd5635a1
RP
1013
1014 add_show_from_set
f266e564 1015 (add_set_cmd ("union", class_support, var_boolean, (char *)&unionprint,
bd5635a1 1016 "Set printing of unions interior to structures.",
f266e564
JK
1017 &setprintlist),
1018 &showprintlist);
bd5635a1
RP
1019
1020 add_show_from_set
a8a69e63
FF
1021 (add_set_cmd ("array", class_support, var_boolean,
1022 (char *)&prettyprint_arrays,
bd5635a1 1023 "Set prettyprinting of arrays.",
f266e564
JK
1024 &setprintlist),
1025 &showprintlist);
bd5635a1
RP
1026
1027 add_show_from_set
f266e564 1028 (add_set_cmd ("address", class_support, var_boolean, (char *)&addressprint,
bd5635a1 1029 "Set printing of addresses.",
f266e564
JK
1030 &setprintlist),
1031 &showprintlist);
bd5635a1 1032
bd5635a1
RP
1033 c = add_set_cmd ("input-radix", class_support, var_uinteger,
1034 (char *)&input_radix,
1035 "Set default input radix for entering numbers.",
1036 &setlist);
1037 add_show_from_set (c, &showlist);
199b2450 1038 c->function.sfunc = set_input_radix;
bd5635a1
RP
1039
1040 c = add_set_cmd ("output-radix", class_support, var_uinteger,
1041 (char *)&output_radix,
1042 "Set default output radix for printing of values.",
1043 &setlist);
1044 add_show_from_set (c, &showlist);
199b2450 1045 c->function.sfunc = set_output_radix;
bd5635a1 1046
ce13daa7
FF
1047 /* The "set radix" and "show radix" commands are special in that they are
1048 like normal set and show commands but allow two normally independent
1049 variables to be either set or shown with a single command. So the
1050 usual add_set_cmd() and add_show_from_set() commands aren't really
1051 appropriate. */
1052 add_cmd ("radix", class_support, set_radix,
1053 "Set default input and output number radices.\n\
1054Use 'set input-radix' or 'set output-radix' to independently set each.\n\
1055Without an argument, sets both radices back to the default value of 10.",
1056 &setlist);
1057 add_cmd ("radix", class_support, show_radix,
1058 "Show the default input and output number radices.\n\
1059Use 'show input-radix' or 'show output-radix' to independently show each.",
1060 &showlist);
bd5635a1
RP
1061
1062 /* Give people the defaults which they are used to. */
a8a69e63
FF
1063 prettyprint_structs = 0;
1064 prettyprint_arrays = 0;
bd5635a1 1065 unionprint = 1;
bd5635a1 1066 addressprint = 1;
ce13daa7 1067 print_max = PRINT_MAX_DEFAULT;
bd5635a1 1068}
This page took 0.234063 seconds and 4 git commands to generate.