1 /* Print values for GDB, the GNU debugger.
2 Copyright 1986, 1988, 1989, 1991, 1992, 1993, 1994, 1998
3 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 2 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, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
22 #include "gdb_string.h"
37 /* Prototypes for local functions */
39 static void print_hex_chars PARAMS ((GDB_FILE *, unsigned char *,
42 static void show_print PARAMS ((char *, int));
44 static void set_print PARAMS ((char *, int));
46 static void set_radix PARAMS ((char *, int));
48 static void show_radix PARAMS ((char *, int));
50 static void set_input_radix PARAMS ((char *, int, struct cmd_list_element *));
52 static void set_input_radix_1 PARAMS ((int, unsigned));
54 static void set_output_radix PARAMS ((char *, int, struct cmd_list_element *));
56 static void set_output_radix_1 PARAMS ((int, unsigned));
58 void _initialize_valprint PARAMS ((void));
60 /* Maximum number of chars to print for a string pointer value or vector
61 contents, or UINT_MAX for no limit. Note that "set print elements 0"
62 stores UINT_MAX in print_max, which displays in a show command as
65 unsigned int print_max;
66 #define PRINT_MAX_DEFAULT 200 /* Start print_max off at this value. */
68 /* Default input and output radixes, and output format letter. */
70 unsigned input_radix = 10;
71 unsigned output_radix = 10;
72 int output_format = 0;
74 /* Print repeat counts if there are more than this many repetitions of an
75 element in an array. Referenced by the low level language dependent
78 unsigned int repeat_count_threshold = 10;
80 /* If nonzero, stops printing of char arrays at first null. */
82 int stop_print_at_null;
84 /* Controls pretty printing of structures. */
86 int prettyprint_structs;
88 /* Controls pretty printing of arrays. */
90 int prettyprint_arrays;
92 /* If nonzero, causes unions inside structures or other unions to be
95 int unionprint; /* Controls printing of nested unions. */
97 /* If nonzero, causes machine addresses to be printed in certain contexts. */
99 int addressprint; /* Controls printing of machine addresses */
102 /* Print data of type TYPE located at VALADDR (within GDB), which came from
103 the inferior at address ADDRESS, onto stdio stream STREAM according to
104 FORMAT (a letter, or 0 for natural format using TYPE).
106 If DEREF_REF is nonzero, then dereference references, otherwise just print
109 The PRETTY parameter controls prettyprinting.
111 If the data are a string pointer, returns the number of string characters
114 FIXME: The data at VALADDR is in target byte order. If gdb is ever
115 enhanced to be able to debug more than the single target it was compiled
116 for (specific CPU type and thus specific target byte ordering), then
117 either the print routines are going to have to take this into account,
118 or the data is going to have to be passed into here already converted
119 to the host byte ordering, whichever is more convenient. */
123 val_print (type, valaddr, embedded_offset, address,
124 stream, format, deref_ref, recurse, pretty)
133 enum val_prettyprint pretty;
135 struct type *real_type = check_typedef (type);
136 if (pretty == Val_pretty_default)
138 pretty = prettyprint_structs ? Val_prettyprint : Val_no_prettyprint;
143 /* Ensure that the type is complete and not just a stub. If the type is
144 only a stub and we can't find and substitute its complete type, then
145 print appropriate string and return. */
147 if (TYPE_FLAGS (real_type) & TYPE_FLAG_STUB)
149 fprintf_filtered (stream, "<incomplete type>");
154 return (LA_VAL_PRINT (type, valaddr, embedded_offset, address,
155 stream, format, deref_ref, recurse, pretty));
158 /* Print the value VAL in C-ish syntax on stream STREAM.
159 FORMAT is a format-letter, or 0 for print in natural format of data type.
160 If the object printed is a string pointer, returns
161 the number of string bytes printed. */
164 value_print (val, stream, format, pretty)
168 enum val_prettyprint pretty;
172 printf_filtered ("<address of value unknown>");
175 if (VALUE_OPTIMIZED_OUT (val))
177 printf_filtered ("<value optimized out>");
180 return LA_VALUE_PRINT (val, stream, format, pretty);
183 /* Called by various <lang>_val_print routines to print
184 TYPE_CODE_INT's. TYPE is the type. VALADDR is the address of the
185 value. STREAM is where to print the value. */
188 val_print_type_code_int (type, valaddr, stream)
193 if (TYPE_LENGTH (type) > sizeof (LONGEST))
197 if (TYPE_UNSIGNED (type)
198 && extract_long_unsigned_integer (valaddr, TYPE_LENGTH (type),
201 print_longest (stream, 'u', 0, val);
205 /* Signed, or we couldn't turn an unsigned value into a
206 LONGEST. For signed values, one could assume two's
207 complement (a reasonable assumption, I think) and do
209 print_hex_chars (stream, (unsigned char *) valaddr,
215 #ifdef PRINT_TYPELESS_INTEGER
216 PRINT_TYPELESS_INTEGER (stream, type, unpack_long (type, valaddr));
218 print_longest (stream, TYPE_UNSIGNED (type) ? 'u' : 'd', 0,
219 unpack_long (type, valaddr));
224 /* Print a number according to FORMAT which is one of d,u,x,o,b,h,w,g.
225 The raison d'etre of this function is to consolidate printing of
226 LONG_LONG's into this one function. Some platforms have long longs but
227 don't have a printf() that supports "ll" in the format string. We handle
228 these by seeing if the number is representable as either a signed or
229 unsigned long, depending upon what format is desired, and if not we just
230 bail out and print the number in hex.
232 The format chars b,h,w,g are from print_scalar_formatted(). If USE_LOCAL,
233 format it according to the current language (this should be used for most
234 integers which GDB prints, the exception is things like protocols where
235 the format of the integer is a protocol thing, not a user-visible thing).
238 #if defined (CC_HAS_LONG_LONG) && !defined (PRINTF_HAS_LONG_LONG)
240 print_decimal (stream, sign, use_local, val_ulong)
246 unsigned long temp[3];
250 temp[i] = val_ulong % (1000 * 1000 * 1000);
251 val_ulong /= (1000 * 1000 * 1000);
254 while (val_ulong != 0 && i < (sizeof (temp) / sizeof (temp[0])));
258 fprintf_filtered (stream, "%s%lu",
262 fprintf_filtered (stream, "%s%lu%09lu",
263 sign, temp[1], temp[0]);
266 fprintf_filtered (stream, "%s%lu%09lu%09lu",
267 sign, temp[2], temp[1], temp[0]);
277 print_longest (stream, format, use_local, val_long)
283 #if defined (CC_HAS_LONG_LONG) && !defined (PRINTF_HAS_LONG_LONG)
284 if (sizeof (long) < sizeof (LONGEST))
290 /* Print a signed value, that doesn't fit in a long */
291 if ((long) val_long != val_long)
294 print_decimal (stream, "-", use_local, -val_long);
296 print_decimal (stream, "", use_local, val_long);
303 /* Print an unsigned value, that doesn't fit in a long */
304 if ((unsigned long) val_long != (ULONGEST) val_long)
306 print_decimal (stream, "", use_local, val_long);
317 /* Print as unsigned value, must fit completely in unsigned long */
319 unsigned long temp = val_long;
320 if (temp != val_long)
322 /* Urk, can't represent value in long so print in hex.
323 Do shift in two operations so that if sizeof (long)
324 == sizeof (LONGEST) we can avoid warnings from
325 picky compilers about shifts >= the size of the
327 unsigned long vbot = (unsigned long) val_long;
328 LONGEST temp = (val_long >> (sizeof (long) * HOST_CHAR_BIT - 1));
329 unsigned long vtop = temp >> 1;
330 fprintf_filtered (stream, "0x%lx%08lx", vtop, vbot);
339 #if defined (CC_HAS_LONG_LONG) && defined (PRINTF_HAS_LONG_LONG)
343 fprintf_filtered (stream,
344 use_local ? local_decimal_format_custom ("ll")
349 fprintf_filtered (stream, "%llu", val_long);
352 fprintf_filtered (stream,
353 use_local ? local_hex_format_custom ("ll")
358 fprintf_filtered (stream,
359 use_local ? local_octal_format_custom ("ll")
364 fprintf_filtered (stream, local_hex_format_custom ("02ll"), val_long);
367 fprintf_filtered (stream, local_hex_format_custom ("04ll"), val_long);
370 fprintf_filtered (stream, local_hex_format_custom ("08ll"), val_long);
373 fprintf_filtered (stream, local_hex_format_custom ("016ll"), val_long);
378 #else /* !CC_HAS_LONG_LONG || !PRINTF_HAS_LONG_LONG*/
379 /* In the following it is important to coerce (val_long) to a long. It does
380 nothing if !LONG_LONG, but it will chop off the top half (which we know
381 we can ignore) if the host supports long longs. */
386 fprintf_filtered (stream,
387 use_local ? local_decimal_format_custom ("l")
392 fprintf_filtered (stream, "%lu", (unsigned long) val_long);
395 fprintf_filtered (stream,
396 use_local ? local_hex_format_custom ("l")
398 (unsigned long) val_long);
401 fprintf_filtered (stream,
402 use_local ? local_octal_format_custom ("l")
404 (unsigned long) val_long);
407 fprintf_filtered (stream, local_hex_format_custom ("02l"),
408 (unsigned long) val_long);
411 fprintf_filtered (stream, local_hex_format_custom ("04l"),
412 (unsigned long) val_long);
415 fprintf_filtered (stream, local_hex_format_custom ("08l"),
416 (unsigned long) val_long);
419 fprintf_filtered (stream, local_hex_format_custom ("016l"),
420 (unsigned long) val_long);
425 #endif /* CC_HAS_LONG_LONG || PRINTF_HAS_LONG_LONG */
429 strcat_longest (format, use_local, val_long, buf, buflen)
434 int buflen; /* ignored, for now */
436 #if defined (CC_HAS_LONG_LONG) && !defined (PRINTF_HAS_LONG_LONG)
439 vtop = val_long >> (sizeof (long) * HOST_CHAR_BIT);
440 vbot = (long) val_long;
442 if ((format == 'd' && (val_long < INT_MIN || val_long > INT_MAX))
443 || ((format == 'u' || format == 'x') && (unsigned long long)val_long > UINT_MAX))
445 sprintf (buf, "0x%lx%08lx", vtop, vbot);
450 #ifdef PRINTF_HAS_LONG_LONG
455 (use_local ? local_decimal_format_custom ("ll") : "%lld"),
459 sprintf (buf, "%llu", val_long);
463 (use_local ? local_hex_format_custom ("ll") : "%llx"),
469 (use_local ? local_octal_format_custom ("ll") : "%llo"),
473 sprintf (buf, local_hex_format_custom ("02ll"), val_long);
476 sprintf (buf, local_hex_format_custom ("04ll"), val_long);
479 sprintf (buf, local_hex_format_custom ("08ll"), val_long);
482 sprintf (buf, local_hex_format_custom ("016ll"), val_long);
487 #else /* !PRINTF_HAS_LONG_LONG */
488 /* In the following it is important to coerce (val_long) to a long. It does
489 nothing if !LONG_LONG, but it will chop off the top half (which we know
490 we can ignore) if the host supports long longs. */
495 sprintf (buf, (use_local ? local_decimal_format_custom ("l") : "%ld"),
499 sprintf (buf, "%lu", ((unsigned long) val_long));
502 sprintf (buf, (use_local ? local_hex_format_custom ("l") : "%lx"),
506 sprintf (buf, (use_local ? local_octal_format_custom ("l") : "%lo"),
510 sprintf (buf, local_hex_format_custom ("02l"),
514 sprintf (buf, local_hex_format_custom ("04l"),
518 sprintf (buf, local_hex_format_custom ("08l"),
522 sprintf (buf, local_hex_format_custom ("016l"),
529 #endif /* !PRINTF_HAS_LONG_LONG */
532 /* This used to be a macro, but I don't think it is called often enough
533 to merit such treatment. */
534 /* Convert a LONGEST to an int. This is used in contexts (e.g. number of
535 arguments to a function, number in a value history, register number, etc.)
536 where the value must not be larger than can fit in an int. */
542 /* Let the compiler do the work */
543 int rtnval = (int) arg;
545 /* Check for overflows or underflows */
546 if (sizeof (LONGEST) > sizeof (int))
550 error ("Value out of range.");
556 /* Print a floating point value of type TYPE, pointed to in GDB by VALADDR,
560 print_floating (valaddr, type, stream)
567 unsigned len = TYPE_LENGTH (type);
569 #if defined (IEEE_FLOAT)
571 /* Check for NaN's. Note that this code does not depend on us being
572 on an IEEE conforming system. It only depends on the target
573 machine using IEEE representation. This means (a)
574 cross-debugging works right, and (2) IEEE_FLOAT can (and should)
575 be defined for systems like the 68881, which uses IEEE
576 representation, but is not IEEE conforming. */
579 unsigned long low, high;
580 /* Is the sign bit 0? */
582 /* Is it is a NaN (i.e. the exponent is all ones and
583 the fraction is nonzero)? */
586 /* For lint, initialize these two variables to suppress warning: */
587 low = high = nonnegative = 0;
590 /* It's single precision. */
591 /* Assume that floating point byte order is the same as
592 integer byte order. */
593 low = extract_unsigned_integer (valaddr, 4);
594 nonnegative = ((low & 0x80000000) == 0);
595 is_nan = ((((low >> 23) & 0xFF) == 0xFF)
596 && 0 != (low & 0x7FFFFF));
602 /* It's double precision. Get the high and low words. */
604 /* Assume that floating point byte order is the same as
605 integer byte order. */
606 if (TARGET_BYTE_ORDER == BIG_ENDIAN)
608 low = extract_unsigned_integer (valaddr + 4, 4);
609 high = extract_unsigned_integer (valaddr, 4);
613 low = extract_unsigned_integer (valaddr, 4);
614 high = extract_unsigned_integer (valaddr + 4, 4);
616 nonnegative = ((high & 0x80000000) == 0);
617 is_nan = (((high >> 20) & 0x7ff) == 0x7ff
618 && ! ((((high & 0xfffff) == 0)) && (low == 0)));
622 /* Extended. We can't detect NaNs for extendeds yet. Also note
623 that currently extendeds get nuked to double in
624 REGISTER_CONVERTIBLE. */
629 /* The meaning of the sign and fraction is not defined by IEEE.
630 But the user might know what they mean. For example, they
631 (in an implementation-defined manner) distinguish between
632 signaling and quiet NaN's. */
634 fprintf_filtered (stream, "-NaN(0x%lx%.8lx)" + nonnegative,
637 fprintf_filtered (stream, "-NaN(0x%lx)" + nonnegative, low);
641 #endif /* IEEE_FLOAT. */
643 doub = unpack_double (type, valaddr, &inv);
646 fprintf_filtered (stream, "<invalid float value>");
650 if (len < sizeof (double))
651 fprintf_filtered (stream, "%.9g", (double) doub);
652 else if (len == sizeof (double))
653 fprintf_filtered (stream, "%.17g", (double) doub);
655 #ifdef PRINTF_HAS_LONG_DOUBLE
656 fprintf_filtered (stream, "%.35Lg", doub);
658 /* This at least wins with values that are representable as doubles */
659 fprintf_filtered (stream, "%.17g", (double) doub);
664 print_binary_chars (stream, valaddr, len)
666 unsigned char *valaddr;
670 #define BITS_IN_BYTES 8
676 /* Declared "int" so it will be signed.
677 * This ensures that right shift will shift in zeros.
679 const int mask = 0x080;
681 /* FIXME: We should be not printing leading zeroes in most cases. */
683 fprintf_filtered (stream, local_binary_format_prefix ());
684 if (TARGET_BYTE_ORDER == BIG_ENDIAN)
690 /* Every byte has 8 binary characters; peel off
691 * and print from the MSB end.
693 for( i = 0; i < (BITS_IN_BYTES * sizeof( *p )); i++ ) {
694 if( *p & ( mask >> i ))
699 fprintf_filtered (stream, "%1d", b);
705 for (p = valaddr + len - 1;
709 for( i = 0; i < (BITS_IN_BYTES * sizeof( *p )); i++ ) {
710 if( *p & ( mask >> i ))
715 fprintf_filtered (stream, "%1d", b);
719 fprintf_filtered (stream, local_binary_format_suffix ());
722 /* VALADDR points to an integer of LEN bytes.
723 * Print it in octal on stream or format it in buf.
726 print_octal_chars (stream, valaddr, len)
728 unsigned char *valaddr;
732 unsigned char octa1, octa2, octa3, carry;
735 /* FIXME: We should be not printing leading zeroes in most cases. */
738 /* Octal is 3 bits, which doesn't fit. Yuk. So we have to track
739 * the extra bits, which cycle every three bytes:
743 * bit number 123 456 78 | 9 012 345 6 | 78 901 234 | 567 890 12 |
745 * Octal side: 0 1 carry 3 4 carry ...
747 * Cycle number: 0 1 2
749 * But of course we are printing from the high side, so we have to
750 * figure out where in the cycle we are so that we end up with no
751 * left over bits at the end.
753 #define BITS_IN_OCTAL 3
754 #define HIGH_ZERO 0340
755 #define LOW_ZERO 0016
756 #define CARRY_ZERO 0003
757 #define HIGH_ONE 0200
760 #define CARRY_ONE 0001
761 #define HIGH_TWO 0300
765 /* For 32 we start in cycle 2, with two bits and one bit carry;
766 * for 64 in cycle in cycle 1, with one bit and a two bit carry.
768 cycle = (len * BITS_IN_BYTES) % BITS_IN_OCTAL;
771 fprintf_filtered (stream, local_octal_format_prefix ());
772 if (TARGET_BYTE_ORDER == BIG_ENDIAN)
780 /* No carry in, carry out two bits.
782 octa1 = (HIGH_ZERO & *p) >> 5;
783 octa2 = (LOW_ZERO & *p) >> 2;
784 carry = (CARRY_ZERO & *p);
785 fprintf_filtered (stream, "%o", octa1);
786 fprintf_filtered (stream, "%o", octa2);
790 /* Carry in two bits, carry out one bit.
792 octa1 = (carry << 1) | ((HIGH_ONE & *p) >> 7);
793 octa2 = (MID_ONE & *p) >> 4;
794 octa3 = (LOW_ONE & *p) >> 1;
795 carry = (CARRY_ONE & *p);
796 fprintf_filtered (stream, "%o", octa1);
797 fprintf_filtered (stream, "%o", octa2);
798 fprintf_filtered (stream, "%o", octa3);
802 /* Carry in one bit, no carry out.
804 octa1 = (carry << 2) | ((HIGH_TWO & *p) >> 6);
805 octa2 = (MID_TWO & *p) >> 3;
806 octa3 = (LOW_TWO & *p);
808 fprintf_filtered (stream, "%o", octa1);
809 fprintf_filtered (stream, "%o", octa2);
810 fprintf_filtered (stream, "%o", octa3);
814 error( "Internal error in octal conversion;" );
818 cycle = cycle % BITS_IN_OCTAL;
823 for (p = valaddr + len - 1;
829 /* Carry out, no carry in */
830 octa1 = (HIGH_ZERO & *p) >> 5;
831 octa2 = (LOW_ZERO & *p) >> 2;
832 carry = (CARRY_ZERO & *p);
833 fprintf_filtered (stream, "%o", octa1);
834 fprintf_filtered (stream, "%o", octa2);
838 /* Carry in, carry out */
839 octa1 = (carry << 1) | ((HIGH_ONE & *p) >> 7);
840 octa2 = (MID_ONE & *p) >> 4;
841 octa3 = (LOW_ONE & *p) >> 1;
842 carry = (CARRY_ONE & *p);
843 fprintf_filtered (stream, "%o", octa1);
844 fprintf_filtered (stream, "%o", octa2);
845 fprintf_filtered (stream, "%o", octa3);
849 /* Carry in, no carry out */
850 octa1 = (carry << 2) | ((HIGH_TWO & *p) >> 6);
851 octa2 = (MID_TWO & *p) >> 3;
852 octa3 = (LOW_TWO & *p);
854 fprintf_filtered (stream, "%o", octa1);
855 fprintf_filtered (stream, "%o", octa2);
856 fprintf_filtered (stream, "%o", octa3);
860 error( "Internal error in octal conversion;" );
864 cycle = cycle % BITS_IN_OCTAL;
868 fprintf_filtered (stream, local_octal_format_suffix ());
871 /* VALADDR points to an integer of LEN bytes.
872 * Print it in decimal on stream or format it in buf.
875 print_decimal_chars (stream, valaddr, len)
877 unsigned char *valaddr;
881 #define TWO_TO_FOURTH 16
882 #define CARRY_OUT( x ) ((x) / TEN) /* extend char to int */
883 #define CARRY_LEFT( x ) ((x) % TEN)
884 #define SHIFT( x ) ((x) << 4)
886 ((TARGET_BYTE_ORDER == BIG_ENDIAN) ? valaddr : valaddr + len - 1)
888 ((TARGET_BYTE_ORDER == BIG_ENDIAN) ? (p < valaddr + len) : (p >= valaddr))
890 ((TARGET_BYTE_ORDER == BIG_ENDIAN) ? p++ : p-- )
891 #define LOW_NIBBLE( x ) ( (x) & 0x00F)
892 #define HIGH_NIBBLE( x ) (((x) & 0x0F0) >> 4)
895 unsigned char *digits;
898 int i, j, decimal_digits;
902 /* Base-ten number is less than twice as many digits
903 * as the base 16 number, which is 2 digits per byte.
905 decimal_len = len * 2 * 2;
906 digits = (unsigned char *) malloc( decimal_len );
908 error( "Can't allocate memory for conversion to decimal." );
910 for( i = 0; i < decimal_len; i++ ) {
914 fprintf_filtered (stream, local_decimal_format_prefix ());
916 /* Ok, we have an unknown number of bytes of data to be printed in
919 * Given a hex number (in nibbles) as XYZ, we start by taking X and
920 * decemalizing it as "x1 x2" in two decimal nibbles. Then we multiply
921 * the nibbles by 16, add Y and re-decimalize. Repeat with Z.
923 * The trick is that "digits" holds a base-10 number, but sometimes
924 * the individual digits are > 10.
926 * Outer loop is per nibble (hex digit) of input, from MSD end to
929 decimal_digits = 0; /* Number of decimal digits so far */
934 * Multiply current base-ten number by 16 in place.
935 * Each digit was between 0 and 9, now is between
938 for( j = 0; j < decimal_digits; j++ ) {
939 digits[j] = SHIFT( digits[j] );
942 /* Take the next nibble off the input and add it to what
943 * we've got in the LSB position. Bottom 'digit' is now
946 * "flip" is used to run this loop twice for each byte.
951 digits[0] += HIGH_NIBBLE( *p );
955 /* Take low nibble and bump our pointer "p".
957 digits[0] += LOW_NIBBLE( *p );
962 /* Re-decimalize. We have to do this often enough
963 * that we don't overflow, but once per nibble is
964 * overkill. Easier this way, though. Note that the
965 * carry is often larger than 10 (e.g. max initial
966 * carry out of lowest nibble is 15, could bubble all
967 * the way up greater than 10). So we have to do
968 * the carrying beyond the last current digit.
971 for( j = 0; j < decimal_len - 1; j++ ) {
974 /* "/" won't handle an unsigned char with
975 * a value that if signed would be negative.
976 * So extend to longword int via "dummy".
979 carry = CARRY_OUT( dummy );
980 digits[j] = CARRY_LEFT( dummy );
982 if( j >= decimal_digits && carry == 0 ) {
984 * All higher digits are 0 and we
985 * no longer have a carry.
987 * Note: "j" is 0-based, "decimal_digits" is
990 decimal_digits = j + 1;
996 /* Ok, now "digits" is the decimal representation, with
997 * the "decimal_digits" actual digits. Print!
999 for( i = decimal_digits - 1; i >= 0; i-- ) {
1000 fprintf_filtered( stream, "%1d", digits[i] );
1004 fprintf_filtered (stream, local_decimal_format_suffix ());
1007 /* VALADDR points to an integer of LEN bytes. Print it in hex on stream. */
1010 print_hex_chars (stream, valaddr, len)
1012 unsigned char *valaddr;
1017 /* FIXME: We should be not printing leading zeroes in most cases. */
1019 fprintf_filtered (stream, local_hex_format_prefix ());
1020 if (TARGET_BYTE_ORDER == BIG_ENDIAN)
1026 fprintf_filtered (stream, "%02x", *p);
1031 for (p = valaddr + len - 1;
1035 fprintf_filtered (stream, "%02x", *p);
1038 fprintf_filtered (stream, local_hex_format_suffix ());
1041 /* Called by various <lang>_val_print routines to print elements of an
1042 array in the form "<elem1>, <elem2>, <elem3>, ...".
1044 (FIXME?) Assumes array element separator is a comma, which is correct
1045 for all languages currently handled.
1046 (FIXME?) Some languages have a notation for repeated array elements,
1047 perhaps we should try to use that notation when appropriate.
1051 val_print_array_elements (type, valaddr, address, stream, format, deref_ref,
1060 enum val_prettyprint pretty;
1063 unsigned int things_printed = 0;
1065 struct type *elttype;
1067 /* Position of the array element we are examining to see
1068 whether it is repeated. */
1070 /* Number of repetitions we have detected so far. */
1073 elttype = TYPE_TARGET_TYPE (type);
1074 eltlen = TYPE_LENGTH (check_typedef (elttype));
1075 len = TYPE_LENGTH (type) / eltlen;
1077 annotate_array_section_begin (i, elttype);
1079 for (; i < len && things_printed < print_max; i++)
1083 if (prettyprint_arrays)
1085 fprintf_filtered (stream, ",\n");
1086 print_spaces_filtered (2 + 2 * recurse, stream);
1090 fprintf_filtered (stream, ", ");
1093 wrap_here (n_spaces (2 + 2 * recurse));
1097 while ((rep1 < len) &&
1098 !memcmp (valaddr + i * eltlen, valaddr + rep1 * eltlen, eltlen))
1104 if (reps > repeat_count_threshold)
1106 val_print (elttype, valaddr + i * eltlen, 0, 0, stream, format,
1107 deref_ref, recurse + 1, pretty);
1108 annotate_elt_rep (reps);
1109 fprintf_filtered (stream, " <repeats %u times>", reps);
1110 annotate_elt_rep_end ();
1113 things_printed += repeat_count_threshold;
1117 val_print (elttype, valaddr + i * eltlen, 0, 0, stream, format,
1118 deref_ref, recurse + 1, pretty);
1123 annotate_array_section_end ();
1126 fprintf_filtered (stream, "...");
1130 /* Print a string from the inferior, starting at ADDR and printing up to LEN
1131 characters, of WIDTH bytes a piece, to STREAM. If LEN is -1, printing
1132 stops at the first null byte, otherwise printing proceeds (including null
1133 bytes) until either print_max or LEN characters have been printed,
1134 whichever is smaller. */
1136 /* FIXME: Use target_read_string. */
1139 val_print_string (addr, len, width, stream)
1145 int force_ellipsis = 0; /* Force ellipsis to be printed if nonzero. */
1146 int errcode; /* Errno returned from bad reads. */
1147 unsigned int fetchlimit; /* Maximum number of chars to print. */
1148 unsigned int nfetch; /* Chars to fetch / chars fetched. */
1149 unsigned int chunksize; /* Size of each fetch, in chars. */
1150 char *buffer = NULL; /* Dynamically growable fetch buffer. */
1151 char *bufptr; /* Pointer to next available byte in buffer. */
1152 char *limit; /* First location past end of fetch buffer. */
1153 struct cleanup *old_chain = NULL; /* Top of the old cleanup chain. */
1154 int found_nul; /* Non-zero if we found the nul char */
1156 /* First we need to figure out the limit on the number of characters we are
1157 going to attempt to fetch and print. This is actually pretty simple. If
1158 LEN >= zero, then the limit is the minimum of LEN and print_max. If
1159 LEN is -1, then the limit is print_max. This is true regardless of
1160 whether print_max is zero, UINT_MAX (unlimited), or something in between,
1161 because finding the null byte (or available memory) is what actually
1162 limits the fetch. */
1164 fetchlimit = (len == -1 ? print_max : min (len, print_max));
1166 /* Now decide how large of chunks to try to read in one operation. This
1167 is also pretty simple. If LEN >= zero, then we want fetchlimit chars,
1168 so we might as well read them all in one operation. If LEN is -1, we
1169 are looking for a null terminator to end the fetching, so we might as
1170 well read in blocks that are large enough to be efficient, but not so
1171 large as to be slow if fetchlimit happens to be large. So we choose the
1172 minimum of 8 and fetchlimit. We used to use 200 instead of 8 but
1173 200 is way too big for remote debugging over a serial line. */
1175 chunksize = (len == -1 ? min (8, fetchlimit) : fetchlimit);
1177 /* Loop until we either have all the characters to print, or we encounter
1178 some error, such as bumping into the end of the address space. */
1181 old_chain = make_cleanup (null_cleanup, 0);
1185 buffer = (char *) xmalloc (len * width);
1187 old_chain = make_cleanup (free, buffer);
1189 nfetch = target_read_memory_partial (addr, bufptr, len * width, &errcode)
1191 addr += nfetch * width;
1192 bufptr += nfetch * width;
1196 unsigned long bufsize = 0;
1200 nfetch = min (chunksize, fetchlimit - bufsize);
1203 buffer = (char *) xmalloc (nfetch * width);
1206 discard_cleanups (old_chain);
1207 buffer = (char *) xrealloc (buffer, (nfetch + bufsize) * width);
1210 old_chain = make_cleanup (free, buffer);
1211 bufptr = buffer + bufsize * width;
1214 /* Read as much as we can. */
1215 nfetch = target_read_memory_partial (addr, bufptr, nfetch * width, &errcode)
1218 /* Scan this chunk for the null byte that terminates the string
1219 to print. If found, we don't need to fetch any more. Note
1220 that bufptr is explicitly left pointing at the next character
1221 after the null byte, or at the next character after the end of
1224 limit = bufptr + nfetch * width;
1225 while (bufptr < limit)
1229 c = extract_unsigned_integer (bufptr, width);
1234 /* We don't care about any error which happened after
1235 the NULL terminator. */
1242 while (errcode == 0 /* no error */
1243 && bufptr - buffer < fetchlimit * width /* no overrun */
1244 && !found_nul); /* haven't found nul yet */
1247 { /* length of string is really 0! */
1248 buffer = bufptr = NULL;
1252 /* bufptr and addr now point immediately beyond the last byte which we
1253 consider part of the string (including a '\0' which ends the string). */
1255 /* We now have either successfully filled the buffer to fetchlimit, or
1256 terminated early due to an error or finding a null char when LEN is -1. */
1258 if (len == -1 && !found_nul)
1262 /* We didn't find a null terminator we were looking for. Attempt
1263 to peek at the next character. If not successful, or it is not
1264 a null byte, then force ellipsis to be printed. */
1266 peekbuf = (char *) alloca (width);
1268 if (target_read_memory (addr, peekbuf, width) == 0
1269 && extract_unsigned_integer (peekbuf, width) != 0)
1272 else if ((len >= 0 && errcode != 0) || (len > (bufptr - buffer)/width))
1274 /* Getting an error when we have a requested length, or fetching less
1275 than the number of characters actually requested, always make us
1282 /* If we get an error before fetching anything, don't print a string.
1283 But if we fetch something and then get an error, print the string
1284 and then the error message. */
1285 if (errcode == 0 || bufptr > buffer)
1289 fputs_filtered (" ", stream);
1291 LA_PRINT_STRING (stream, buffer, (bufptr - buffer)/width, width, force_ellipsis);
1298 fprintf_filtered (stream, " <Address ");
1299 print_address_numeric (addr, 1, stream);
1300 fprintf_filtered (stream, " out of bounds>");
1304 fprintf_filtered (stream, " <Error reading address ");
1305 print_address_numeric (addr, 1, stream);
1306 fprintf_filtered (stream, ": %s>", safe_strerror (errcode));
1310 do_cleanups (old_chain);
1311 return ((bufptr - buffer)/width);
1315 /* Validate an input or output radix setting, and make sure the user
1316 knows what they really did here. Radix setting is confusing, e.g.
1317 setting the input radix to "10" never changes it! */
1321 set_input_radix (args, from_tty, c)
1324 struct cmd_list_element *c;
1326 set_input_radix_1 (from_tty, *(unsigned *)c->var);
1331 set_input_radix_1 (from_tty, radix)
1335 /* We don't currently disallow any input radix except 0 or 1, which don't
1336 make any mathematical sense. In theory, we can deal with any input
1337 radix greater than 1, even if we don't have unique digits for every
1338 value from 0 to radix-1, but in practice we lose on large radix values.
1339 We should either fix the lossage or restrict the radix range more.
1344 error ("Nonsense input radix ``decimal %u''; input radix unchanged.",
1347 input_radix = radix;
1350 printf_filtered ("Input radix now set to decimal %u, hex %x, octal %o.\n",
1351 radix, radix, radix);
1357 set_output_radix (args, from_tty, c)
1360 struct cmd_list_element *c;
1362 set_output_radix_1 (from_tty, *(unsigned *)c->var);
1366 set_output_radix_1 (from_tty, radix)
1370 /* Validate the radix and disallow ones that we aren't prepared to
1371 handle correctly, leaving the radix unchanged. */
1375 output_format = 'x'; /* hex */
1378 output_format = 0; /* decimal */
1381 output_format = 'o'; /* octal */
1384 error ("Unsupported output radix ``decimal %u''; output radix unchanged.",
1387 output_radix = radix;
1390 printf_filtered ("Output radix now set to decimal %u, hex %x, octal %o.\n",
1391 radix, radix, radix);
1395 /* Set both the input and output radix at once. Try to set the output radix
1396 first, since it has the most restrictive range. An radix that is valid as
1397 an output radix is also valid as an input radix.
1399 It may be useful to have an unusual input radix. If the user wishes to
1400 set an input radix that is not valid as an output radix, he needs to use
1401 the 'set input-radix' command. */
1404 set_radix (arg, from_tty)
1410 radix = (arg == NULL) ? 10 : parse_and_eval_address (arg);
1411 set_output_radix_1 (0, radix);
1412 set_input_radix_1 (0, radix);
1415 printf_filtered ("Input and output radices now set to decimal %u, hex %x, octal %o.\n",
1416 radix, radix, radix);
1420 /* Show both the input and output radices. */
1424 show_radix (arg, from_tty)
1430 if (input_radix == output_radix)
1432 printf_filtered ("Input and output radices set to decimal %u, hex %x, octal %o.\n",
1433 input_radix, input_radix, input_radix);
1437 printf_filtered ("Input radix set to decimal %u, hex %x, octal %o.\n",
1438 input_radix, input_radix, input_radix);
1439 printf_filtered ("Output radix set to decimal %u, hex %x, octal %o.\n",
1440 output_radix, output_radix, output_radix);
1448 set_print (arg, from_tty)
1453 "\"set print\" must be followed by the name of a print subcommand.\n");
1454 help_list (setprintlist, "set print ", -1, gdb_stdout);
1459 show_print (args, from_tty)
1463 cmd_show_list (showprintlist, from_tty, "");
1467 _initialize_valprint ()
1469 struct cmd_list_element *c;
1471 add_prefix_cmd ("print", no_class, set_print,
1472 "Generic command for setting how things print.",
1473 &setprintlist, "set print ", 0, &setlist);
1474 add_alias_cmd ("p", "print", no_class, 1, &setlist);
1475 /* prefer set print to set prompt */
1476 add_alias_cmd ("pr", "print", no_class, 1, &setlist);
1478 add_prefix_cmd ("print", no_class, show_print,
1479 "Generic command for showing print settings.",
1480 &showprintlist, "show print ", 0, &showlist);
1481 add_alias_cmd ("p", "print", no_class, 1, &showlist);
1482 add_alias_cmd ("pr", "print", no_class, 1, &showlist);
1485 (add_set_cmd ("elements", no_class, var_uinteger, (char *)&print_max,
1486 "Set limit on string chars or array elements to print.\n\
1487 \"set print elements 0\" causes there to be no limit.",
1492 (add_set_cmd ("null-stop", no_class, var_boolean,
1493 (char *)&stop_print_at_null,
1494 "Set printing of char arrays to stop at first null char.",
1499 (add_set_cmd ("repeats", no_class, var_uinteger,
1500 (char *)&repeat_count_threshold,
1501 "Set threshold for repeated print elements.\n\
1502 \"set print repeats 0\" causes all elements to be individually printed.",
1507 (add_set_cmd ("pretty", class_support, var_boolean,
1508 (char *)&prettyprint_structs,
1509 "Set prettyprinting of structures.",
1514 (add_set_cmd ("union", class_support, var_boolean, (char *)&unionprint,
1515 "Set printing of unions interior to structures.",
1520 (add_set_cmd ("array", class_support, var_boolean,
1521 (char *)&prettyprint_arrays,
1522 "Set prettyprinting of arrays.",
1527 (add_set_cmd ("address", class_support, var_boolean, (char *)&addressprint,
1528 "Set printing of addresses.",
1532 c = add_set_cmd ("input-radix", class_support, var_uinteger,
1533 (char *)&input_radix,
1534 "Set default input radix for entering numbers.",
1536 add_show_from_set (c, &showlist);
1537 c->function.sfunc = set_input_radix;
1539 c = add_set_cmd ("output-radix", class_support, var_uinteger,
1540 (char *)&output_radix,
1541 "Set default output radix for printing of values.",
1543 add_show_from_set (c, &showlist);
1544 c->function.sfunc = set_output_radix;
1546 /* The "set radix" and "show radix" commands are special in that they are
1547 like normal set and show commands but allow two normally independent
1548 variables to be either set or shown with a single command. So the
1549 usual add_set_cmd() and add_show_from_set() commands aren't really
1551 add_cmd ("radix", class_support, set_radix,
1552 "Set default input and output number radices.\n\
1553 Use 'set input-radix' or 'set output-radix' to independently set each.\n\
1554 Without an argument, sets both radices back to the default value of 10.",
1556 add_cmd ("radix", class_support, show_radix,
1557 "Show the default input and output number radices.\n\
1558 Use 'show input-radix' or 'show output-radix' to independently show each.",
1561 /* Give people the defaults which they are used to. */
1562 prettyprint_structs = 0;
1563 prettyprint_arrays = 0;
1566 print_max = PRINT_MAX_DEFAULT;