]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - gdb/valprint.c
gdb/testuite/
[thirdparty/binutils-gdb.git] / gdb / valprint.c
CommitLineData
c906108c 1/* Print values for GDB, the GNU debugger.
5c1c87f0 2
6aba47ca 3 Copyright (C) 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
0fb0cc75 4 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
7b6bb8da 5 2009, 2010, 2011 Free Software Foundation, Inc.
c906108c 6
c5aa993b 7 This file is part of GDB.
c906108c 8
c5aa993b
JM
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
a9762ec7 11 the Free Software Foundation; either version 3 of the License, or
c5aa993b 12 (at your option) any later version.
c906108c 13
c5aa993b
JM
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.
c906108c 18
c5aa993b 19 You should have received a copy of the GNU General Public License
a9762ec7 20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
c906108c
SS
21
22#include "defs.h"
23#include "gdb_string.h"
24#include "symtab.h"
25#include "gdbtypes.h"
26#include "value.h"
27#include "gdbcore.h"
28#include "gdbcmd.h"
29#include "target.h"
c906108c 30#include "language.h"
c906108c
SS
31#include "annotate.h"
32#include "valprint.h"
39424bef 33#include "floatformat.h"
d16aafd8 34#include "doublest.h"
19ca80ba 35#include "exceptions.h"
7678ef8f 36#include "dfp.h"
a6bac58e 37#include "python/python.h"
0c3acc09 38#include "ada-lang.h"
c906108c
SS
39
40#include <errno.h>
41
42/* Prototypes for local functions */
43
777ea8f1 44static int partial_memory_read (CORE_ADDR memaddr, gdb_byte *myaddr,
917317f4
JM
45 int len, int *errnoptr);
46
a14ed312 47static void show_print (char *, int);
c906108c 48
a14ed312 49static void set_print (char *, int);
c906108c 50
a14ed312 51static void set_radix (char *, int);
c906108c 52
a14ed312 53static void show_radix (char *, int);
c906108c 54
a14ed312 55static void set_input_radix (char *, int, struct cmd_list_element *);
c906108c 56
a14ed312 57static void set_input_radix_1 (int, unsigned);
c906108c 58
a14ed312 59static void set_output_radix (char *, int, struct cmd_list_element *);
c906108c 60
a14ed312 61static void set_output_radix_1 (int, unsigned);
c906108c 62
a14ed312 63void _initialize_valprint (void);
c906108c 64
581e13c1 65#define PRINT_MAX_DEFAULT 200 /* Start print_max off at this value. */
79a45b7d
TT
66
67struct value_print_options user_print_options =
68{
69 Val_pretty_default, /* pretty */
70 0, /* prettyprint_arrays */
71 0, /* prettyprint_structs */
72 0, /* vtblprint */
73 1, /* unionprint */
74 1, /* addressprint */
75 0, /* objectprint */
76 PRINT_MAX_DEFAULT, /* print_max */
77 10, /* repeat_count_threshold */
78 0, /* output_format */
79 0, /* format */
80 0, /* stop_print_at_null */
81 0, /* inspect_it */
82 0, /* print_array_indexes */
83 0, /* deref_ref */
84 1, /* static_field_print */
a6bac58e
TT
85 1, /* pascal_static_field_print */
86 0, /* raw */
87 0 /* summary */
79a45b7d
TT
88};
89
90/* Initialize *OPTS to be a copy of the user print options. */
91void
92get_user_print_options (struct value_print_options *opts)
93{
94 *opts = user_print_options;
95}
96
97/* Initialize *OPTS to be a copy of the user print options, but with
98 pretty-printing disabled. */
99void
100get_raw_print_options (struct value_print_options *opts)
101{
102 *opts = user_print_options;
103 opts->pretty = Val_no_prettyprint;
104}
105
106/* Initialize *OPTS to be a copy of the user print options, but using
107 FORMAT as the formatting option. */
108void
109get_formatted_print_options (struct value_print_options *opts,
110 char format)
111{
112 *opts = user_print_options;
113 opts->format = format;
114}
115
920d2a44
AC
116static void
117show_print_max (struct ui_file *file, int from_tty,
118 struct cmd_list_element *c, const char *value)
119{
3e43a32a
MS
120 fprintf_filtered (file,
121 _("Limit on string chars or array "
122 "elements to print is %s.\n"),
920d2a44
AC
123 value);
124}
125
c906108c
SS
126
127/* Default input and output radixes, and output format letter. */
128
129unsigned input_radix = 10;
920d2a44
AC
130static void
131show_input_radix (struct ui_file *file, int from_tty,
132 struct cmd_list_element *c, const char *value)
133{
3e43a32a
MS
134 fprintf_filtered (file,
135 _("Default input radix for entering numbers is %s.\n"),
920d2a44
AC
136 value);
137}
138
c906108c 139unsigned output_radix = 10;
920d2a44
AC
140static void
141show_output_radix (struct ui_file *file, int from_tty,
142 struct cmd_list_element *c, const char *value)
143{
3e43a32a
MS
144 fprintf_filtered (file,
145 _("Default output radix for printing of values is %s.\n"),
920d2a44
AC
146 value);
147}
c906108c 148
e79af960
JB
149/* By default we print arrays without printing the index of each element in
150 the array. This behavior can be changed by setting PRINT_ARRAY_INDEXES. */
151
e79af960
JB
152static void
153show_print_array_indexes (struct ui_file *file, int from_tty,
154 struct cmd_list_element *c, const char *value)
155{
156 fprintf_filtered (file, _("Printing of array indexes is %s.\n"), value);
157}
158
c906108c
SS
159/* Print repeat counts if there are more than this many repetitions of an
160 element in an array. Referenced by the low level language dependent
581e13c1 161 print routines. */
c906108c 162
920d2a44
AC
163static void
164show_repeat_count_threshold (struct ui_file *file, int from_tty,
165 struct cmd_list_element *c, const char *value)
166{
167 fprintf_filtered (file, _("Threshold for repeated print elements is %s.\n"),
168 value);
169}
c906108c 170
581e13c1 171/* If nonzero, stops printing of char arrays at first null. */
c906108c 172
920d2a44
AC
173static void
174show_stop_print_at_null (struct ui_file *file, int from_tty,
175 struct cmd_list_element *c, const char *value)
176{
3e43a32a
MS
177 fprintf_filtered (file,
178 _("Printing of char arrays to stop "
179 "at first null char is %s.\n"),
920d2a44
AC
180 value);
181}
c906108c 182
581e13c1 183/* Controls pretty printing of structures. */
c906108c 184
920d2a44
AC
185static void
186show_prettyprint_structs (struct ui_file *file, int from_tty,
187 struct cmd_list_element *c, const char *value)
188{
189 fprintf_filtered (file, _("Prettyprinting of structures is %s.\n"), value);
190}
c906108c
SS
191
192/* Controls pretty printing of arrays. */
193
920d2a44
AC
194static void
195show_prettyprint_arrays (struct ui_file *file, int from_tty,
196 struct cmd_list_element *c, const char *value)
197{
198 fprintf_filtered (file, _("Prettyprinting of arrays is %s.\n"), value);
199}
c906108c
SS
200
201/* If nonzero, causes unions inside structures or other unions to be
581e13c1 202 printed. */
c906108c 203
920d2a44
AC
204static void
205show_unionprint (struct ui_file *file, int from_tty,
206 struct cmd_list_element *c, const char *value)
207{
3e43a32a
MS
208 fprintf_filtered (file,
209 _("Printing of unions interior to structures is %s.\n"),
920d2a44
AC
210 value);
211}
c906108c 212
581e13c1 213/* If nonzero, causes machine addresses to be printed in certain contexts. */
c906108c 214
920d2a44
AC
215static void
216show_addressprint (struct ui_file *file, int from_tty,
217 struct cmd_list_element *c, const char *value)
218{
219 fprintf_filtered (file, _("Printing of addresses is %s.\n"), value);
220}
c906108c 221\f
c5aa993b 222
a6bac58e
TT
223/* A helper function for val_print. When printing in "summary" mode,
224 we want to print scalar arguments, but not aggregate arguments.
225 This function distinguishes between the two. */
226
227static int
228scalar_type_p (struct type *type)
229{
230 CHECK_TYPEDEF (type);
231 while (TYPE_CODE (type) == TYPE_CODE_REF)
232 {
233 type = TYPE_TARGET_TYPE (type);
234 CHECK_TYPEDEF (type);
235 }
236 switch (TYPE_CODE (type))
237 {
238 case TYPE_CODE_ARRAY:
239 case TYPE_CODE_STRUCT:
240 case TYPE_CODE_UNION:
241 case TYPE_CODE_SET:
242 case TYPE_CODE_STRING:
243 case TYPE_CODE_BITSTRING:
244 return 0;
245 default:
246 return 1;
247 }
248}
249
0e03807e
TT
250/* Helper function to check the validity of some bits of a value.
251
252 If TYPE represents some aggregate type (e.g., a structure), return 1.
253
254 Otherwise, any of the bytes starting at OFFSET and extending for
255 TYPE_LENGTH(TYPE) bytes are invalid, print a message to STREAM and
256 return 0. The checking is done using FUNCS.
257
258 Otherwise, return 1. */
259
260static int
261valprint_check_validity (struct ui_file *stream,
262 struct type *type,
4e07d55f 263 int embedded_offset,
0e03807e
TT
264 const struct value *val)
265{
266 CHECK_TYPEDEF (type);
267
268 if (TYPE_CODE (type) != TYPE_CODE_UNION
269 && TYPE_CODE (type) != TYPE_CODE_STRUCT
270 && TYPE_CODE (type) != TYPE_CODE_ARRAY)
271 {
4e07d55f
PA
272 if (!value_bits_valid (val, TARGET_CHAR_BIT * embedded_offset,
273 TARGET_CHAR_BIT * TYPE_LENGTH (type)))
0e03807e 274 {
585fdaa1 275 val_print_optimized_out (stream);
0e03807e
TT
276 return 0;
277 }
8cf6f0b1 278
4e07d55f 279 if (value_bits_synthetic_pointer (val, TARGET_CHAR_BIT * embedded_offset,
8cf6f0b1
TT
280 TARGET_CHAR_BIT * TYPE_LENGTH (type)))
281 {
282 fputs_filtered (_("<synthetic pointer>"), stream);
283 return 0;
284 }
4e07d55f
PA
285
286 if (!value_bytes_available (val, embedded_offset, TYPE_LENGTH (type)))
287 {
288 val_print_unavailable (stream);
289 return 0;
290 }
0e03807e
TT
291 }
292
293 return 1;
294}
295
585fdaa1
PA
296void
297val_print_optimized_out (struct ui_file *stream)
298{
299 fprintf_filtered (stream, _("<optimized out>"));
300}
301
4e07d55f
PA
302void
303val_print_unavailable (struct ui_file *stream)
304{
305 fprintf_filtered (stream, _("<unavailable>"));
306}
307
32b72a42
PA
308/* Print using the given LANGUAGE the data of type TYPE located at
309 VALADDR + EMBEDDED_OFFSET (within GDB), which came from the
310 inferior at address ADDRESS + EMBEDDED_OFFSET, onto stdio stream
311 STREAM according to OPTIONS. VAL is the whole object that came
312 from ADDRESS. VALADDR must point to the head of VAL's contents
313 buffer.
314
315 The language printers will pass down an adjusted EMBEDDED_OFFSET to
316 further helper subroutines as subfields of TYPE are printed. In
317 such cases, VALADDR is passed down unadjusted, as well as VAL, so
318 that VAL can be queried for metadata about the contents data being
319 printed, using EMBEDDED_OFFSET as an offset into VAL's contents
320 buffer. For example: "has this field been optimized out", or "I'm
321 printing an object while inspecting a traceframe; has this
322 particular piece of data been collected?".
323
324 RECURSE indicates the amount of indentation to supply before
325 continuation lines; this amount is roughly twice the value of
326 RECURSE.
327
328 If the data is printed as a string, returns the number of string
329 characters printed. */
c906108c
SS
330
331int
fc1a4b47 332val_print (struct type *type, const gdb_byte *valaddr, int embedded_offset,
79a45b7d 333 CORE_ADDR address, struct ui_file *stream, int recurse,
0e03807e 334 const struct value *val,
79a45b7d 335 const struct value_print_options *options,
d8ca156b 336 const struct language_defn *language)
c906108c 337{
19ca80ba
DJ
338 volatile struct gdb_exception except;
339 int ret = 0;
79a45b7d 340 struct value_print_options local_opts = *options;
c906108c 341 struct type *real_type = check_typedef (type);
79a45b7d
TT
342
343 if (local_opts.pretty == Val_pretty_default)
344 local_opts.pretty = (local_opts.prettyprint_structs
345 ? Val_prettyprint : Val_no_prettyprint);
c5aa993b 346
c906108c
SS
347 QUIT;
348
349 /* Ensure that the type is complete and not just a stub. If the type is
350 only a stub and we can't find and substitute its complete type, then
351 print appropriate string and return. */
352
74a9bb82 353 if (TYPE_STUB (real_type))
c906108c 354 {
0e03807e 355 fprintf_filtered (stream, _("<incomplete type>"));
c906108c
SS
356 gdb_flush (stream);
357 return (0);
358 }
c5aa993b 359
0e03807e
TT
360 if (!valprint_check_validity (stream, real_type, embedded_offset, val))
361 return 0;
362
a6bac58e
TT
363 if (!options->raw)
364 {
365 ret = apply_val_pretty_printer (type, valaddr, embedded_offset,
0e03807e
TT
366 address, stream, recurse,
367 val, options, language);
a6bac58e
TT
368 if (ret)
369 return ret;
370 }
371
372 /* Handle summary mode. If the value is a scalar, print it;
373 otherwise, print an ellipsis. */
374 if (options->summary && !scalar_type_p (type))
375 {
376 fprintf_filtered (stream, "...");
377 return 0;
378 }
379
19ca80ba
DJ
380 TRY_CATCH (except, RETURN_MASK_ERROR)
381 {
d8ca156b 382 ret = language->la_val_print (type, valaddr, embedded_offset, address,
0e03807e
TT
383 stream, recurse, val,
384 &local_opts);
19ca80ba
DJ
385 }
386 if (except.reason < 0)
387 fprintf_filtered (stream, _("<error reading variable>"));
388
389 return ret;
c906108c
SS
390}
391
806048c6
DJ
392/* Check whether the value VAL is printable. Return 1 if it is;
393 return 0 and print an appropriate error message to STREAM if it
394 is not. */
c906108c 395
806048c6
DJ
396static int
397value_check_printable (struct value *val, struct ui_file *stream)
c906108c
SS
398{
399 if (val == 0)
400 {
806048c6 401 fprintf_filtered (stream, _("<address of value unknown>"));
c906108c
SS
402 return 0;
403 }
806048c6 404
0e03807e 405 if (value_entirely_optimized_out (val))
c906108c 406 {
585fdaa1 407 val_print_optimized_out (stream);
c906108c
SS
408 return 0;
409 }
806048c6 410
bc3b79fd
TJB
411 if (TYPE_CODE (value_type (val)) == TYPE_CODE_INTERNAL_FUNCTION)
412 {
413 fprintf_filtered (stream, _("<internal function %s>"),
414 value_internal_function_name (val));
415 return 0;
416 }
417
806048c6
DJ
418 return 1;
419}
420
d8ca156b 421/* Print using the given LANGUAGE the value VAL onto stream STREAM according
79a45b7d 422 to OPTIONS.
806048c6
DJ
423
424 If the data are a string pointer, returns the number of string characters
425 printed.
426
427 This is a preferable interface to val_print, above, because it uses
428 GDB's value mechanism. */
429
430int
79a45b7d
TT
431common_val_print (struct value *val, struct ui_file *stream, int recurse,
432 const struct value_print_options *options,
d8ca156b 433 const struct language_defn *language)
806048c6
DJ
434{
435 if (!value_check_printable (val, stream))
436 return 0;
437
0c3acc09
JB
438 if (language->la_language == language_ada)
439 /* The value might have a dynamic type, which would cause trouble
440 below when trying to extract the value contents (since the value
441 size is determined from the type size which is unknown). So
442 get a fixed representation of our value. */
443 val = ada_to_fixed_value (val);
444
0e03807e 445 return val_print (value_type (val), value_contents_for_printing (val),
42ae5230 446 value_embedded_offset (val), value_address (val),
0e03807e
TT
447 stream, recurse,
448 val, options, language);
806048c6
DJ
449}
450
7348c5e1
JB
451/* Print on stream STREAM the value VAL according to OPTIONS. The value
452 is printed using the current_language syntax.
453
454 If the object printed is a string pointer, return the number of string
455 bytes printed. */
806048c6
DJ
456
457int
79a45b7d
TT
458value_print (struct value *val, struct ui_file *stream,
459 const struct value_print_options *options)
806048c6
DJ
460{
461 if (!value_check_printable (val, stream))
462 return 0;
463
a6bac58e
TT
464 if (!options->raw)
465 {
466 int r = apply_val_pretty_printer (value_type (val),
0e03807e 467 value_contents_for_printing (val),
a6bac58e
TT
468 value_embedded_offset (val),
469 value_address (val),
0e03807e
TT
470 stream, 0,
471 val, options, current_language);
a109c7c1 472
a6bac58e
TT
473 if (r)
474 return r;
475 }
476
79a45b7d 477 return LA_VALUE_PRINT (val, stream, options);
c906108c
SS
478}
479
480/* Called by various <lang>_val_print routines to print
481 TYPE_CODE_INT's. TYPE is the type. VALADDR is the address of the
482 value. STREAM is where to print the value. */
483
484void
fc1a4b47 485val_print_type_code_int (struct type *type, const gdb_byte *valaddr,
fba45db2 486 struct ui_file *stream)
c906108c 487{
50810684 488 enum bfd_endian byte_order = gdbarch_byte_order (get_type_arch (type));
d44e8473 489
c906108c
SS
490 if (TYPE_LENGTH (type) > sizeof (LONGEST))
491 {
492 LONGEST val;
493
494 if (TYPE_UNSIGNED (type)
495 && extract_long_unsigned_integer (valaddr, TYPE_LENGTH (type),
e17a4113 496 byte_order, &val))
c906108c
SS
497 {
498 print_longest (stream, 'u', 0, val);
499 }
500 else
501 {
502 /* Signed, or we couldn't turn an unsigned value into a
503 LONGEST. For signed values, one could assume two's
504 complement (a reasonable assumption, I think) and do
505 better than this. */
506 print_hex_chars (stream, (unsigned char *) valaddr,
d44e8473 507 TYPE_LENGTH (type), byte_order);
c906108c
SS
508 }
509 }
510 else
511 {
c906108c
SS
512 print_longest (stream, TYPE_UNSIGNED (type) ? 'u' : 'd', 0,
513 unpack_long (type, valaddr));
c906108c
SS
514 }
515}
516
4f2aea11
MK
517void
518val_print_type_code_flags (struct type *type, const gdb_byte *valaddr,
519 struct ui_file *stream)
520{
befae759 521 ULONGEST val = unpack_long (type, valaddr);
4f2aea11
MK
522 int bitpos, nfields = TYPE_NFIELDS (type);
523
524 fputs_filtered ("[ ", stream);
525 for (bitpos = 0; bitpos < nfields; bitpos++)
526 {
316703b9
MK
527 if (TYPE_FIELD_BITPOS (type, bitpos) != -1
528 && (val & ((ULONGEST)1 << bitpos)))
4f2aea11
MK
529 {
530 if (TYPE_FIELD_NAME (type, bitpos))
531 fprintf_filtered (stream, "%s ", TYPE_FIELD_NAME (type, bitpos));
532 else
533 fprintf_filtered (stream, "#%d ", bitpos);
534 }
535 }
536 fputs_filtered ("]", stream);
ab2188aa
PA
537
538/* Print a scalar of data of type TYPE, pointed to in GDB by VALADDR,
539 according to OPTIONS and SIZE on STREAM. Format i is not supported
540 at this level.
541
542 This is how the elements of an array or structure are printed
543 with a format. */
544}
545
546void
547val_print_scalar_formatted (struct type *type,
548 const gdb_byte *valaddr, int embedded_offset,
549 const struct value *val,
550 const struct value_print_options *options,
551 int size,
552 struct ui_file *stream)
553{
554 gdb_assert (val != NULL);
555 gdb_assert (valaddr == value_contents_for_printing_const (val));
556
557 /* If we get here with a string format, try again without it. Go
558 all the way back to the language printers, which may call us
559 again. */
560 if (options->format == 's')
561 {
562 struct value_print_options opts = *options;
563 opts.format = 0;
564 opts.deref_ref = 0;
565 val_print (type, valaddr, embedded_offset, 0, stream, 0, val, &opts,
566 current_language);
567 return;
568 }
569
570 /* A scalar object that does not have all bits available can't be
571 printed, because all bits contribute to its representation. */
572 if (!value_bits_valid (val, TARGET_CHAR_BIT * embedded_offset,
573 TARGET_CHAR_BIT * TYPE_LENGTH (type)))
574 val_print_optimized_out (stream);
4e07d55f
PA
575 else if (!value_bytes_available (val, embedded_offset, TYPE_LENGTH (type)))
576 val_print_unavailable (stream);
ab2188aa
PA
577 else
578 print_scalar_formatted (valaddr + embedded_offset, type,
579 options, size, stream);
4f2aea11
MK
580}
581
c906108c
SS
582/* Print a number according to FORMAT which is one of d,u,x,o,b,h,w,g.
583 The raison d'etre of this function is to consolidate printing of
581e13c1 584 LONG_LONG's into this one function. The format chars b,h,w,g are
bb599908 585 from print_scalar_formatted(). Numbers are printed using C
581e13c1 586 format.
bb599908
PH
587
588 USE_C_FORMAT means to use C format in all cases. Without it,
589 'o' and 'x' format do not include the standard C radix prefix
590 (leading 0 or 0x).
591
592 Hilfinger/2004-09-09: USE_C_FORMAT was originally called USE_LOCAL
593 and was intended to request formating according to the current
594 language and would be used for most integers that GDB prints. The
595 exceptional cases were things like protocols where the format of
596 the integer is a protocol thing, not a user-visible thing). The
597 parameter remains to preserve the information of what things might
598 be printed with language-specific format, should we ever resurrect
581e13c1 599 that capability. */
c906108c
SS
600
601void
bb599908 602print_longest (struct ui_file *stream, int format, int use_c_format,
fba45db2 603 LONGEST val_long)
c906108c 604{
2bfb72ee
AC
605 const char *val;
606
c906108c
SS
607 switch (format)
608 {
609 case 'd':
bb599908 610 val = int_string (val_long, 10, 1, 0, 1); break;
c906108c 611 case 'u':
bb599908 612 val = int_string (val_long, 10, 0, 0, 1); break;
c906108c 613 case 'x':
bb599908 614 val = int_string (val_long, 16, 0, 0, use_c_format); break;
c906108c 615 case 'b':
bb599908 616 val = int_string (val_long, 16, 0, 2, 1); break;
c906108c 617 case 'h':
bb599908 618 val = int_string (val_long, 16, 0, 4, 1); break;
c906108c 619 case 'w':
bb599908 620 val = int_string (val_long, 16, 0, 8, 1); break;
c906108c 621 case 'g':
bb599908 622 val = int_string (val_long, 16, 0, 16, 1); break;
c906108c
SS
623 break;
624 case 'o':
bb599908 625 val = int_string (val_long, 8, 0, 0, use_c_format); break;
c906108c 626 default:
3e43a32a
MS
627 internal_error (__FILE__, __LINE__,
628 _("failed internal consistency check"));
bb599908 629 }
2bfb72ee 630 fputs_filtered (val, stream);
c906108c
SS
631}
632
c906108c
SS
633/* This used to be a macro, but I don't think it is called often enough
634 to merit such treatment. */
635/* Convert a LONGEST to an int. This is used in contexts (e.g. number of
636 arguments to a function, number in a value history, register number, etc.)
637 where the value must not be larger than can fit in an int. */
638
639int
fba45db2 640longest_to_int (LONGEST arg)
c906108c 641{
581e13c1 642 /* Let the compiler do the work. */
c906108c
SS
643 int rtnval = (int) arg;
644
581e13c1 645 /* Check for overflows or underflows. */
c906108c
SS
646 if (sizeof (LONGEST) > sizeof (int))
647 {
648 if (rtnval != arg)
649 {
8a3fe4f8 650 error (_("Value out of range."));
c906108c
SS
651 }
652 }
653 return (rtnval);
654}
655
a73c86fb
AC
656/* Print a floating point value of type TYPE (not always a
657 TYPE_CODE_FLT), pointed to in GDB by VALADDR, on STREAM. */
c906108c
SS
658
659void
fc1a4b47 660print_floating (const gdb_byte *valaddr, struct type *type,
c84141d6 661 struct ui_file *stream)
c906108c
SS
662{
663 DOUBLEST doub;
664 int inv;
a73c86fb 665 const struct floatformat *fmt = NULL;
c906108c 666 unsigned len = TYPE_LENGTH (type);
20389057 667 enum float_kind kind;
c5aa993b 668
a73c86fb
AC
669 /* If it is a floating-point, check for obvious problems. */
670 if (TYPE_CODE (type) == TYPE_CODE_FLT)
671 fmt = floatformat_from_type (type);
20389057 672 if (fmt != NULL)
39424bef 673 {
20389057
DJ
674 kind = floatformat_classify (fmt, valaddr);
675 if (kind == float_nan)
676 {
677 if (floatformat_is_negative (fmt, valaddr))
678 fprintf_filtered (stream, "-");
679 fprintf_filtered (stream, "nan(");
680 fputs_filtered ("0x", stream);
681 fputs_filtered (floatformat_mantissa (fmt, valaddr), stream);
682 fprintf_filtered (stream, ")");
683 return;
684 }
685 else if (kind == float_infinite)
686 {
687 if (floatformat_is_negative (fmt, valaddr))
688 fputs_filtered ("-", stream);
689 fputs_filtered ("inf", stream);
690 return;
691 }
7355ddba 692 }
c906108c 693
a73c86fb
AC
694 /* NOTE: cagney/2002-01-15: The TYPE passed into print_floating()
695 isn't necessarily a TYPE_CODE_FLT. Consequently, unpack_double
696 needs to be used as that takes care of any necessary type
697 conversions. Such conversions are of course direct to DOUBLEST
698 and disregard any possible target floating point limitations.
699 For instance, a u64 would be converted and displayed exactly on a
700 host with 80 bit DOUBLEST but with loss of information on a host
701 with 64 bit DOUBLEST. */
c2f05ac9 702
c906108c
SS
703 doub = unpack_double (type, valaddr, &inv);
704 if (inv)
705 {
706 fprintf_filtered (stream, "<invalid float value>");
707 return;
708 }
709
39424bef
MK
710 /* FIXME: kettenis/2001-01-20: The following code makes too much
711 assumptions about the host and target floating point format. */
712
a73c86fb 713 /* NOTE: cagney/2002-02-03: Since the TYPE of what was passed in may
c41b8590 714 not necessarily be a TYPE_CODE_FLT, the below ignores that and
a73c86fb
AC
715 instead uses the type's length to determine the precision of the
716 floating-point value being printed. */
c2f05ac9 717
c906108c 718 if (len < sizeof (double))
c5aa993b 719 fprintf_filtered (stream, "%.9g", (double) doub);
c906108c 720 else if (len == sizeof (double))
c5aa993b 721 fprintf_filtered (stream, "%.17g", (double) doub);
c906108c
SS
722 else
723#ifdef PRINTF_HAS_LONG_DOUBLE
724 fprintf_filtered (stream, "%.35Lg", doub);
725#else
39424bef
MK
726 /* This at least wins with values that are representable as
727 doubles. */
c906108c
SS
728 fprintf_filtered (stream, "%.17g", (double) doub);
729#endif
730}
731
7678ef8f
TJB
732void
733print_decimal_floating (const gdb_byte *valaddr, struct type *type,
734 struct ui_file *stream)
735{
e17a4113 736 enum bfd_endian byte_order = gdbarch_byte_order (get_type_arch (type));
7678ef8f
TJB
737 char decstr[MAX_DECIMAL_STRING];
738 unsigned len = TYPE_LENGTH (type);
739
e17a4113 740 decimal_to_string (valaddr, len, byte_order, decstr);
7678ef8f
TJB
741 fputs_filtered (decstr, stream);
742 return;
743}
744
c5aa993b 745void
fc1a4b47 746print_binary_chars (struct ui_file *stream, const gdb_byte *valaddr,
d44e8473 747 unsigned len, enum bfd_endian byte_order)
c906108c
SS
748{
749
750#define BITS_IN_BYTES 8
751
fc1a4b47 752 const gdb_byte *p;
745b8ca0 753 unsigned int i;
c5aa993b 754 int b;
c906108c
SS
755
756 /* Declared "int" so it will be signed.
581e13c1
MS
757 This ensures that right shift will shift in zeros. */
758
c5aa993b 759 const int mask = 0x080;
c906108c
SS
760
761 /* FIXME: We should be not printing leading zeroes in most cases. */
762
d44e8473 763 if (byte_order == BFD_ENDIAN_BIG)
c906108c
SS
764 {
765 for (p = valaddr;
766 p < valaddr + len;
767 p++)
768 {
c5aa993b 769 /* Every byte has 8 binary characters; peel off
581e13c1
MS
770 and print from the MSB end. */
771
c5aa993b
JM
772 for (i = 0; i < (BITS_IN_BYTES * sizeof (*p)); i++)
773 {
774 if (*p & (mask >> i))
775 b = 1;
776 else
777 b = 0;
778
779 fprintf_filtered (stream, "%1d", b);
780 }
c906108c
SS
781 }
782 }
783 else
784 {
785 for (p = valaddr + len - 1;
786 p >= valaddr;
787 p--)
788 {
c5aa993b
JM
789 for (i = 0; i < (BITS_IN_BYTES * sizeof (*p)); i++)
790 {
791 if (*p & (mask >> i))
792 b = 1;
793 else
794 b = 0;
795
796 fprintf_filtered (stream, "%1d", b);
797 }
c906108c
SS
798 }
799 }
c906108c
SS
800}
801
802/* VALADDR points to an integer of LEN bytes.
581e13c1
MS
803 Print it in octal on stream or format it in buf. */
804
c906108c 805void
fc1a4b47 806print_octal_chars (struct ui_file *stream, const gdb_byte *valaddr,
d44e8473 807 unsigned len, enum bfd_endian byte_order)
c906108c 808{
fc1a4b47 809 const gdb_byte *p;
c906108c 810 unsigned char octa1, octa2, octa3, carry;
c5aa993b
JM
811 int cycle;
812
c906108c
SS
813 /* FIXME: We should be not printing leading zeroes in most cases. */
814
815
816 /* Octal is 3 bits, which doesn't fit. Yuk. So we have to track
817 * the extra bits, which cycle every three bytes:
818 *
819 * Byte side: 0 1 2 3
820 * | | | |
821 * bit number 123 456 78 | 9 012 345 6 | 78 901 234 | 567 890 12 |
822 *
823 * Octal side: 0 1 carry 3 4 carry ...
824 *
825 * Cycle number: 0 1 2
826 *
827 * But of course we are printing from the high side, so we have to
828 * figure out where in the cycle we are so that we end up with no
829 * left over bits at the end.
830 */
831#define BITS_IN_OCTAL 3
832#define HIGH_ZERO 0340
833#define LOW_ZERO 0016
834#define CARRY_ZERO 0003
835#define HIGH_ONE 0200
836#define MID_ONE 0160
837#define LOW_ONE 0016
838#define CARRY_ONE 0001
839#define HIGH_TWO 0300
840#define MID_TWO 0070
841#define LOW_TWO 0007
842
843 /* For 32 we start in cycle 2, with two bits and one bit carry;
581e13c1
MS
844 for 64 in cycle in cycle 1, with one bit and a two bit carry. */
845
c906108c
SS
846 cycle = (len * BITS_IN_BYTES) % BITS_IN_OCTAL;
847 carry = 0;
c5aa993b 848
bb599908 849 fputs_filtered ("0", stream);
d44e8473 850 if (byte_order == BFD_ENDIAN_BIG)
c906108c
SS
851 {
852 for (p = valaddr;
853 p < valaddr + len;
854 p++)
855 {
c5aa993b
JM
856 switch (cycle)
857 {
858 case 0:
581e13c1
MS
859 /* No carry in, carry out two bits. */
860
c5aa993b
JM
861 octa1 = (HIGH_ZERO & *p) >> 5;
862 octa2 = (LOW_ZERO & *p) >> 2;
863 carry = (CARRY_ZERO & *p);
864 fprintf_filtered (stream, "%o", octa1);
865 fprintf_filtered (stream, "%o", octa2);
866 break;
867
868 case 1:
581e13c1
MS
869 /* Carry in two bits, carry out one bit. */
870
c5aa993b
JM
871 octa1 = (carry << 1) | ((HIGH_ONE & *p) >> 7);
872 octa2 = (MID_ONE & *p) >> 4;
873 octa3 = (LOW_ONE & *p) >> 1;
874 carry = (CARRY_ONE & *p);
875 fprintf_filtered (stream, "%o", octa1);
876 fprintf_filtered (stream, "%o", octa2);
877 fprintf_filtered (stream, "%o", octa3);
878 break;
879
880 case 2:
581e13c1
MS
881 /* Carry in one bit, no carry out. */
882
c5aa993b
JM
883 octa1 = (carry << 2) | ((HIGH_TWO & *p) >> 6);
884 octa2 = (MID_TWO & *p) >> 3;
885 octa3 = (LOW_TWO & *p);
886 carry = 0;
887 fprintf_filtered (stream, "%o", octa1);
888 fprintf_filtered (stream, "%o", octa2);
889 fprintf_filtered (stream, "%o", octa3);
890 break;
891
892 default:
8a3fe4f8 893 error (_("Internal error in octal conversion;"));
c5aa993b
JM
894 }
895
896 cycle++;
897 cycle = cycle % BITS_IN_OCTAL;
c906108c
SS
898 }
899 }
900 else
901 {
902 for (p = valaddr + len - 1;
903 p >= valaddr;
904 p--)
905 {
c5aa993b
JM
906 switch (cycle)
907 {
908 case 0:
909 /* Carry out, no carry in */
581e13c1 910
c5aa993b
JM
911 octa1 = (HIGH_ZERO & *p) >> 5;
912 octa2 = (LOW_ZERO & *p) >> 2;
913 carry = (CARRY_ZERO & *p);
914 fprintf_filtered (stream, "%o", octa1);
915 fprintf_filtered (stream, "%o", octa2);
916 break;
917
918 case 1:
919 /* Carry in, carry out */
581e13c1 920
c5aa993b
JM
921 octa1 = (carry << 1) | ((HIGH_ONE & *p) >> 7);
922 octa2 = (MID_ONE & *p) >> 4;
923 octa3 = (LOW_ONE & *p) >> 1;
924 carry = (CARRY_ONE & *p);
925 fprintf_filtered (stream, "%o", octa1);
926 fprintf_filtered (stream, "%o", octa2);
927 fprintf_filtered (stream, "%o", octa3);
928 break;
929
930 case 2:
931 /* Carry in, no carry out */
581e13c1 932
c5aa993b
JM
933 octa1 = (carry << 2) | ((HIGH_TWO & *p) >> 6);
934 octa2 = (MID_TWO & *p) >> 3;
935 octa3 = (LOW_TWO & *p);
936 carry = 0;
937 fprintf_filtered (stream, "%o", octa1);
938 fprintf_filtered (stream, "%o", octa2);
939 fprintf_filtered (stream, "%o", octa3);
940 break;
941
942 default:
8a3fe4f8 943 error (_("Internal error in octal conversion;"));
c5aa993b
JM
944 }
945
946 cycle++;
947 cycle = cycle % BITS_IN_OCTAL;
c906108c
SS
948 }
949 }
950
c906108c
SS
951}
952
953/* VALADDR points to an integer of LEN bytes.
581e13c1
MS
954 Print it in decimal on stream or format it in buf. */
955
c906108c 956void
fc1a4b47 957print_decimal_chars (struct ui_file *stream, const gdb_byte *valaddr,
d44e8473 958 unsigned len, enum bfd_endian byte_order)
c906108c
SS
959{
960#define TEN 10
c5aa993b 961#define CARRY_OUT( x ) ((x) / TEN) /* extend char to int */
c906108c
SS
962#define CARRY_LEFT( x ) ((x) % TEN)
963#define SHIFT( x ) ((x) << 4)
c906108c
SS
964#define LOW_NIBBLE( x ) ( (x) & 0x00F)
965#define HIGH_NIBBLE( x ) (((x) & 0x0F0) >> 4)
966
fc1a4b47 967 const gdb_byte *p;
c906108c 968 unsigned char *digits;
c5aa993b
JM
969 int carry;
970 int decimal_len;
971 int i, j, decimal_digits;
972 int dummy;
973 int flip;
974
c906108c 975 /* Base-ten number is less than twice as many digits
581e13c1
MS
976 as the base 16 number, which is 2 digits per byte. */
977
c906108c 978 decimal_len = len * 2 * 2;
3c37485b 979 digits = xmalloc (decimal_len);
c906108c 980
c5aa993b
JM
981 for (i = 0; i < decimal_len; i++)
982 {
c906108c 983 digits[i] = 0;
c5aa993b 984 }
c906108c 985
c906108c
SS
986 /* Ok, we have an unknown number of bytes of data to be printed in
987 * decimal.
988 *
989 * Given a hex number (in nibbles) as XYZ, we start by taking X and
990 * decemalizing it as "x1 x2" in two decimal nibbles. Then we multiply
991 * the nibbles by 16, add Y and re-decimalize. Repeat with Z.
992 *
993 * The trick is that "digits" holds a base-10 number, but sometimes
581e13c1 994 * the individual digits are > 10.
c906108c
SS
995 *
996 * Outer loop is per nibble (hex digit) of input, from MSD end to
997 * LSD end.
998 */
c5aa993b 999 decimal_digits = 0; /* Number of decimal digits so far */
d44e8473 1000 p = (byte_order == BFD_ENDIAN_BIG) ? valaddr : valaddr + len - 1;
c906108c 1001 flip = 0;
d44e8473 1002 while ((byte_order == BFD_ENDIAN_BIG) ? (p < valaddr + len) : (p >= valaddr))
c5aa993b 1003 {
c906108c
SS
1004 /*
1005 * Multiply current base-ten number by 16 in place.
1006 * Each digit was between 0 and 9, now is between
1007 * 0 and 144.
1008 */
c5aa993b
JM
1009 for (j = 0; j < decimal_digits; j++)
1010 {
1011 digits[j] = SHIFT (digits[j]);
1012 }
1013
c906108c
SS
1014 /* Take the next nibble off the input and add it to what
1015 * we've got in the LSB position. Bottom 'digit' is now
1016 * between 0 and 159.
1017 *
1018 * "flip" is used to run this loop twice for each byte.
1019 */
c5aa993b
JM
1020 if (flip == 0)
1021 {
581e13c1
MS
1022 /* Take top nibble. */
1023
c5aa993b
JM
1024 digits[0] += HIGH_NIBBLE (*p);
1025 flip = 1;
1026 }
1027 else
1028 {
581e13c1
MS
1029 /* Take low nibble and bump our pointer "p". */
1030
c5aa993b 1031 digits[0] += LOW_NIBBLE (*p);
d44e8473
MD
1032 if (byte_order == BFD_ENDIAN_BIG)
1033 p++;
1034 else
1035 p--;
c5aa993b
JM
1036 flip = 0;
1037 }
c906108c
SS
1038
1039 /* Re-decimalize. We have to do this often enough
1040 * that we don't overflow, but once per nibble is
1041 * overkill. Easier this way, though. Note that the
1042 * carry is often larger than 10 (e.g. max initial
1043 * carry out of lowest nibble is 15, could bubble all
1044 * the way up greater than 10). So we have to do
1045 * the carrying beyond the last current digit.
1046 */
1047 carry = 0;
c5aa993b
JM
1048 for (j = 0; j < decimal_len - 1; j++)
1049 {
1050 digits[j] += carry;
1051
1052 /* "/" won't handle an unsigned char with
1053 * a value that if signed would be negative.
1054 * So extend to longword int via "dummy".
1055 */
1056 dummy = digits[j];
1057 carry = CARRY_OUT (dummy);
1058 digits[j] = CARRY_LEFT (dummy);
1059
1060 if (j >= decimal_digits && carry == 0)
1061 {
1062 /*
1063 * All higher digits are 0 and we
1064 * no longer have a carry.
1065 *
1066 * Note: "j" is 0-based, "decimal_digits" is
1067 * 1-based.
1068 */
1069 decimal_digits = j + 1;
1070 break;
1071 }
1072 }
1073 }
c906108c
SS
1074
1075 /* Ok, now "digits" is the decimal representation, with
581e13c1
MS
1076 the "decimal_digits" actual digits. Print! */
1077
c5aa993b
JM
1078 for (i = decimal_digits - 1; i >= 0; i--)
1079 {
1080 fprintf_filtered (stream, "%1d", digits[i]);
1081 }
b8c9b27d 1082 xfree (digits);
c906108c
SS
1083}
1084
1085/* VALADDR points to an integer of LEN bytes. Print it in hex on stream. */
1086
6b9acc27 1087void
fc1a4b47 1088print_hex_chars (struct ui_file *stream, const gdb_byte *valaddr,
d44e8473 1089 unsigned len, enum bfd_endian byte_order)
c906108c 1090{
fc1a4b47 1091 const gdb_byte *p;
c906108c
SS
1092
1093 /* FIXME: We should be not printing leading zeroes in most cases. */
1094
bb599908 1095 fputs_filtered ("0x", stream);
d44e8473 1096 if (byte_order == BFD_ENDIAN_BIG)
c906108c
SS
1097 {
1098 for (p = valaddr;
1099 p < valaddr + len;
1100 p++)
1101 {
1102 fprintf_filtered (stream, "%02x", *p);
1103 }
1104 }
1105 else
1106 {
1107 for (p = valaddr + len - 1;
1108 p >= valaddr;
1109 p--)
1110 {
1111 fprintf_filtered (stream, "%02x", *p);
1112 }
1113 }
c906108c
SS
1114}
1115
3e43a32a 1116/* VALADDR points to a char integer of LEN bytes.
581e13c1 1117 Print it out in appropriate language form on stream.
6b9acc27
JJ
1118 Omit any leading zero chars. */
1119
1120void
6c7a06a3
TT
1121print_char_chars (struct ui_file *stream, struct type *type,
1122 const gdb_byte *valaddr,
d44e8473 1123 unsigned len, enum bfd_endian byte_order)
6b9acc27 1124{
fc1a4b47 1125 const gdb_byte *p;
6b9acc27 1126
d44e8473 1127 if (byte_order == BFD_ENDIAN_BIG)
6b9acc27
JJ
1128 {
1129 p = valaddr;
1130 while (p < valaddr + len - 1 && *p == 0)
1131 ++p;
1132
1133 while (p < valaddr + len)
1134 {
6c7a06a3 1135 LA_EMIT_CHAR (*p, type, stream, '\'');
6b9acc27
JJ
1136 ++p;
1137 }
1138 }
1139 else
1140 {
1141 p = valaddr + len - 1;
1142 while (p > valaddr && *p == 0)
1143 --p;
1144
1145 while (p >= valaddr)
1146 {
6c7a06a3 1147 LA_EMIT_CHAR (*p, type, stream, '\'');
6b9acc27
JJ
1148 --p;
1149 }
1150 }
1151}
1152
79a45b7d 1153/* Print on STREAM using the given OPTIONS the index for the element
e79af960
JB
1154 at INDEX of an array whose index type is INDEX_TYPE. */
1155
1156void
1157maybe_print_array_index (struct type *index_type, LONGEST index,
79a45b7d
TT
1158 struct ui_file *stream,
1159 const struct value_print_options *options)
e79af960
JB
1160{
1161 struct value *index_value;
1162
79a45b7d 1163 if (!options->print_array_indexes)
e79af960
JB
1164 return;
1165
1166 index_value = value_from_longest (index_type, index);
1167
79a45b7d
TT
1168 LA_PRINT_ARRAY_INDEX (index_value, stream, options);
1169}
e79af960 1170
c906108c 1171/* Called by various <lang>_val_print routines to print elements of an
c5aa993b 1172 array in the form "<elem1>, <elem2>, <elem3>, ...".
c906108c 1173
c5aa993b
JM
1174 (FIXME?) Assumes array element separator is a comma, which is correct
1175 for all languages currently handled.
1176 (FIXME?) Some languages have a notation for repeated array elements,
581e13c1 1177 perhaps we should try to use that notation when appropriate. */
c906108c
SS
1178
1179void
490f124f
PA
1180val_print_array_elements (struct type *type,
1181 const gdb_byte *valaddr, int embedded_offset,
a2bd3dcd 1182 CORE_ADDR address, struct ui_file *stream,
79a45b7d 1183 int recurse,
0e03807e 1184 const struct value *val,
79a45b7d 1185 const struct value_print_options *options,
fba45db2 1186 unsigned int i)
c906108c
SS
1187{
1188 unsigned int things_printed = 0;
1189 unsigned len;
e79af960 1190 struct type *elttype, *index_type;
c906108c
SS
1191 unsigned eltlen;
1192 /* Position of the array element we are examining to see
1193 whether it is repeated. */
1194 unsigned int rep1;
1195 /* Number of repetitions we have detected so far. */
1196 unsigned int reps;
dbc98a8b 1197 LONGEST low_bound, high_bound;
c5aa993b 1198
c906108c
SS
1199 elttype = TYPE_TARGET_TYPE (type);
1200 eltlen = TYPE_LENGTH (check_typedef (elttype));
e79af960 1201 index_type = TYPE_INDEX_TYPE (type);
c906108c 1202
dbc98a8b 1203 if (get_array_bounds (type, &low_bound, &high_bound))
75be741b
JB
1204 {
1205 /* The array length should normally be HIGH_BOUND - LOW_BOUND + 1.
1206 But we have to be a little extra careful, because some languages
1207 such as Ada allow LOW_BOUND to be greater than HIGH_BOUND for
1208 empty arrays. In that situation, the array length is just zero,
1209 not negative! */
1210 if (low_bound > high_bound)
1211 len = 0;
1212 else
1213 len = high_bound - low_bound + 1;
1214 }
e936309c
JB
1215 else
1216 {
dbc98a8b
KW
1217 warning (_("unable to get bounds of array, assuming null array"));
1218 low_bound = 0;
1219 len = 0;
168de233
JB
1220 }
1221
c906108c
SS
1222 annotate_array_section_begin (i, elttype);
1223
79a45b7d 1224 for (; i < len && things_printed < options->print_max; i++)
c906108c
SS
1225 {
1226 if (i != 0)
1227 {
79a45b7d 1228 if (options->prettyprint_arrays)
c906108c
SS
1229 {
1230 fprintf_filtered (stream, ",\n");
1231 print_spaces_filtered (2 + 2 * recurse, stream);
1232 }
1233 else
1234 {
1235 fprintf_filtered (stream, ", ");
1236 }
1237 }
1238 wrap_here (n_spaces (2 + 2 * recurse));
dbc98a8b 1239 maybe_print_array_index (index_type, i + low_bound,
79a45b7d 1240 stream, options);
c906108c
SS
1241
1242 rep1 = i + 1;
1243 reps = 1;
490f124f 1244 while (rep1 < len
c8c1c22f
PA
1245 && value_available_contents_eq (val,
1246 embedded_offset + i * eltlen,
1247 val,
1248 embedded_offset + rep1 * eltlen,
1249 eltlen))
c906108c
SS
1250 {
1251 ++reps;
1252 ++rep1;
1253 }
1254
79a45b7d 1255 if (reps > options->repeat_count_threshold)
c906108c 1256 {
490f124f
PA
1257 val_print (elttype, valaddr, embedded_offset + i * eltlen,
1258 address, stream, recurse + 1, val, options,
1259 current_language);
c906108c
SS
1260 annotate_elt_rep (reps);
1261 fprintf_filtered (stream, " <repeats %u times>", reps);
1262 annotate_elt_rep_end ();
1263
1264 i = rep1 - 1;
79a45b7d 1265 things_printed += options->repeat_count_threshold;
c906108c
SS
1266 }
1267 else
1268 {
490f124f
PA
1269 val_print (elttype, valaddr, embedded_offset + i * eltlen,
1270 address,
0e03807e 1271 stream, recurse + 1, val, options, current_language);
c906108c
SS
1272 annotate_elt ();
1273 things_printed++;
1274 }
1275 }
1276 annotate_array_section_end ();
1277 if (i < len)
1278 {
1279 fprintf_filtered (stream, "...");
1280 }
1281}
1282
917317f4
JM
1283/* Read LEN bytes of target memory at address MEMADDR, placing the
1284 results in GDB's memory at MYADDR. Returns a count of the bytes
1285 actually read, and optionally an errno value in the location
581e13c1 1286 pointed to by ERRNOPTR if ERRNOPTR is non-null. */
917317f4
JM
1287
1288/* FIXME: cagney/1999-10-14: Only used by val_print_string. Can this
1289 function be eliminated. */
1290
1291static int
3e43a32a
MS
1292partial_memory_read (CORE_ADDR memaddr, gdb_byte *myaddr,
1293 int len, int *errnoptr)
917317f4 1294{
581e13c1
MS
1295 int nread; /* Number of bytes actually read. */
1296 int errcode; /* Error from last read. */
917317f4 1297
581e13c1 1298 /* First try a complete read. */
917317f4
JM
1299 errcode = target_read_memory (memaddr, myaddr, len);
1300 if (errcode == 0)
1301 {
581e13c1 1302 /* Got it all. */
917317f4
JM
1303 nread = len;
1304 }
1305 else
1306 {
581e13c1 1307 /* Loop, reading one byte at a time until we get as much as we can. */
917317f4
JM
1308 for (errcode = 0, nread = 0; len > 0 && errcode == 0; nread++, len--)
1309 {
1310 errcode = target_read_memory (memaddr++, myaddr++, 1);
1311 }
581e13c1 1312 /* If an error, the last read was unsuccessful, so adjust count. */
917317f4
JM
1313 if (errcode != 0)
1314 {
1315 nread--;
1316 }
1317 }
1318 if (errnoptr != NULL)
1319 {
1320 *errnoptr = errcode;
1321 }
1322 return (nread);
1323}
1324
ae6a3a4c
TJB
1325/* Read a string from the inferior, at ADDR, with LEN characters of WIDTH bytes
1326 each. Fetch at most FETCHLIMIT characters. BUFFER will be set to a newly
1327 allocated buffer containing the string, which the caller is responsible to
1328 free, and BYTES_READ will be set to the number of bytes read. Returns 0 on
1329 success, or errno on failure.
1330
1331 If LEN > 0, reads exactly LEN characters (including eventual NULs in
1332 the middle or end of the string). If LEN is -1, stops at the first
1333 null character (not necessarily the first null byte) up to a maximum
1334 of FETCHLIMIT characters. Set FETCHLIMIT to UINT_MAX to read as many
1335 characters as possible from the string.
1336
1337 Unless an exception is thrown, BUFFER will always be allocated, even on
1338 failure. In this case, some characters might have been read before the
1339 failure happened. Check BYTES_READ to recognize this situation.
1340
1341 Note: There was a FIXME asking to make this code use target_read_string,
1342 but this function is more general (can read past null characters, up to
581e13c1 1343 given LEN). Besides, it is used much more often than target_read_string
ae6a3a4c
TJB
1344 so it is more tested. Perhaps callers of target_read_string should use
1345 this function instead? */
c906108c
SS
1346
1347int
ae6a3a4c 1348read_string (CORE_ADDR addr, int len, int width, unsigned int fetchlimit,
e17a4113 1349 enum bfd_endian byte_order, gdb_byte **buffer, int *bytes_read)
c906108c 1350{
ae6a3a4c
TJB
1351 int found_nul; /* Non-zero if we found the nul char. */
1352 int errcode; /* Errno returned from bad reads. */
1353 unsigned int nfetch; /* Chars to fetch / chars fetched. */
1354 unsigned int chunksize; /* Size of each fetch, in chars. */
3e43a32a
MS
1355 gdb_byte *bufptr; /* Pointer to next available byte in
1356 buffer. */
ae6a3a4c
TJB
1357 gdb_byte *limit; /* First location past end of fetch buffer. */
1358 struct cleanup *old_chain = NULL; /* Top of the old cleanup chain. */
1359
1360 /* Decide how large of chunks to try to read in one operation. This
c906108c
SS
1361 is also pretty simple. If LEN >= zero, then we want fetchlimit chars,
1362 so we might as well read them all in one operation. If LEN is -1, we
ae6a3a4c 1363 are looking for a NUL terminator to end the fetching, so we might as
c906108c
SS
1364 well read in blocks that are large enough to be efficient, but not so
1365 large as to be slow if fetchlimit happens to be large. So we choose the
1366 minimum of 8 and fetchlimit. We used to use 200 instead of 8 but
1367 200 is way too big for remote debugging over a serial line. */
1368
1369 chunksize = (len == -1 ? min (8, fetchlimit) : fetchlimit);
1370
ae6a3a4c
TJB
1371 /* Loop until we either have all the characters, or we encounter
1372 some error, such as bumping into the end of the address space. */
c906108c
SS
1373
1374 found_nul = 0;
b5096abe
PM
1375 *buffer = NULL;
1376
1377 old_chain = make_cleanup (free_current_contents, buffer);
c906108c
SS
1378
1379 if (len > 0)
1380 {
ae6a3a4c
TJB
1381 *buffer = (gdb_byte *) xmalloc (len * width);
1382 bufptr = *buffer;
c906108c 1383
917317f4 1384 nfetch = partial_memory_read (addr, bufptr, len * width, &errcode)
c906108c
SS
1385 / width;
1386 addr += nfetch * width;
1387 bufptr += nfetch * width;
1388 }
1389 else if (len == -1)
1390 {
1391 unsigned long bufsize = 0;
ae6a3a4c 1392
c906108c
SS
1393 do
1394 {
1395 QUIT;
1396 nfetch = min (chunksize, fetchlimit - bufsize);
1397
ae6a3a4c
TJB
1398 if (*buffer == NULL)
1399 *buffer = (gdb_byte *) xmalloc (nfetch * width);
c906108c 1400 else
b5096abe
PM
1401 *buffer = (gdb_byte *) xrealloc (*buffer,
1402 (nfetch + bufsize) * width);
c906108c 1403
ae6a3a4c 1404 bufptr = *buffer + bufsize * width;
c906108c
SS
1405 bufsize += nfetch;
1406
ae6a3a4c 1407 /* Read as much as we can. */
917317f4 1408 nfetch = partial_memory_read (addr, bufptr, nfetch * width, &errcode)
ae6a3a4c 1409 / width;
c906108c 1410
ae6a3a4c 1411 /* Scan this chunk for the null character that terminates the string
c906108c
SS
1412 to print. If found, we don't need to fetch any more. Note
1413 that bufptr is explicitly left pointing at the next character
ae6a3a4c
TJB
1414 after the null character, or at the next character after the end
1415 of the buffer. */
c906108c
SS
1416
1417 limit = bufptr + nfetch * width;
1418 while (bufptr < limit)
1419 {
1420 unsigned long c;
1421
e17a4113 1422 c = extract_unsigned_integer (bufptr, width, byte_order);
c906108c
SS
1423 addr += width;
1424 bufptr += width;
1425 if (c == 0)
1426 {
1427 /* We don't care about any error which happened after
ae6a3a4c 1428 the NUL terminator. */
c906108c
SS
1429 errcode = 0;
1430 found_nul = 1;
1431 break;
1432 }
1433 }
1434 }
c5aa993b 1435 while (errcode == 0 /* no error */
ae6a3a4c
TJB
1436 && bufptr - *buffer < fetchlimit * width /* no overrun */
1437 && !found_nul); /* haven't found NUL yet */
c906108c
SS
1438 }
1439 else
ae6a3a4c
TJB
1440 { /* Length of string is really 0! */
1441 /* We always allocate *buffer. */
1442 *buffer = bufptr = xmalloc (1);
c906108c
SS
1443 errcode = 0;
1444 }
1445
1446 /* bufptr and addr now point immediately beyond the last byte which we
1447 consider part of the string (including a '\0' which ends the string). */
ae6a3a4c
TJB
1448 *bytes_read = bufptr - *buffer;
1449
1450 QUIT;
1451
1452 discard_cleanups (old_chain);
1453
1454 return errcode;
1455}
1456
1457/* Print a string from the inferior, starting at ADDR and printing up to LEN
1458 characters, of WIDTH bytes a piece, to STREAM. If LEN is -1, printing
1459 stops at the first null byte, otherwise printing proceeds (including null
1460 bytes) until either print_max or LEN characters have been printed,
09ca9e2e
TT
1461 whichever is smaller. ENCODING is the name of the string's
1462 encoding. It can be NULL, in which case the target encoding is
1463 assumed. */
ae6a3a4c
TJB
1464
1465int
09ca9e2e
TT
1466val_print_string (struct type *elttype, const char *encoding,
1467 CORE_ADDR addr, int len,
6c7a06a3 1468 struct ui_file *stream,
ae6a3a4c
TJB
1469 const struct value_print_options *options)
1470{
1471 int force_ellipsis = 0; /* Force ellipsis to be printed if nonzero. */
1472 int errcode; /* Errno returned from bad reads. */
581e13c1 1473 int found_nul; /* Non-zero if we found the nul char. */
ae6a3a4c
TJB
1474 unsigned int fetchlimit; /* Maximum number of chars to print. */
1475 int bytes_read;
1476 gdb_byte *buffer = NULL; /* Dynamically growable fetch buffer. */
1477 struct cleanup *old_chain = NULL; /* Top of the old cleanup chain. */
5af949e3 1478 struct gdbarch *gdbarch = get_type_arch (elttype);
e17a4113 1479 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
6c7a06a3 1480 int width = TYPE_LENGTH (elttype);
ae6a3a4c
TJB
1481
1482 /* First we need to figure out the limit on the number of characters we are
1483 going to attempt to fetch and print. This is actually pretty simple. If
1484 LEN >= zero, then the limit is the minimum of LEN and print_max. If
1485 LEN is -1, then the limit is print_max. This is true regardless of
1486 whether print_max is zero, UINT_MAX (unlimited), or something in between,
1487 because finding the null byte (or available memory) is what actually
1488 limits the fetch. */
1489
3e43a32a
MS
1490 fetchlimit = (len == -1 ? options->print_max : min (len,
1491 options->print_max));
ae6a3a4c 1492
e17a4113
UW
1493 errcode = read_string (addr, len, width, fetchlimit, byte_order,
1494 &buffer, &bytes_read);
ae6a3a4c
TJB
1495 old_chain = make_cleanup (xfree, buffer);
1496
1497 addr += bytes_read;
c906108c 1498
3e43a32a
MS
1499 /* We now have either successfully filled the buffer to fetchlimit,
1500 or terminated early due to an error or finding a null char when
1501 LEN is -1. */
ae6a3a4c
TJB
1502
1503 /* Determine found_nul by looking at the last character read. */
e17a4113
UW
1504 found_nul = extract_unsigned_integer (buffer + bytes_read - width, width,
1505 byte_order) == 0;
c906108c
SS
1506 if (len == -1 && !found_nul)
1507 {
777ea8f1 1508 gdb_byte *peekbuf;
c906108c 1509
ae6a3a4c 1510 /* We didn't find a NUL terminator we were looking for. Attempt
c5aa993b
JM
1511 to peek at the next character. If not successful, or it is not
1512 a null byte, then force ellipsis to be printed. */
c906108c 1513
777ea8f1 1514 peekbuf = (gdb_byte *) alloca (width);
c906108c
SS
1515
1516 if (target_read_memory (addr, peekbuf, width) == 0
e17a4113 1517 && extract_unsigned_integer (peekbuf, width, byte_order) != 0)
c906108c
SS
1518 force_ellipsis = 1;
1519 }
ae6a3a4c 1520 else if ((len >= 0 && errcode != 0) || (len > bytes_read / width))
c906108c
SS
1521 {
1522 /* Getting an error when we have a requested length, or fetching less
c5aa993b 1523 than the number of characters actually requested, always make us
ae6a3a4c 1524 print ellipsis. */
c906108c
SS
1525 force_ellipsis = 1;
1526 }
1527
c906108c
SS
1528 /* If we get an error before fetching anything, don't print a string.
1529 But if we fetch something and then get an error, print the string
1530 and then the error message. */
ae6a3a4c 1531 if (errcode == 0 || bytes_read > 0)
c906108c 1532 {
79a45b7d 1533 if (options->addressprint)
c906108c
SS
1534 {
1535 fputs_filtered (" ", stream);
1536 }
be759fcf 1537 LA_PRINT_STRING (stream, elttype, buffer, bytes_read / width,
3a772aa4 1538 encoding, force_ellipsis, options);
c906108c
SS
1539 }
1540
1541 if (errcode != 0)
1542 {
1543 if (errcode == EIO)
1544 {
1545 fprintf_filtered (stream, " <Address ");
5af949e3 1546 fputs_filtered (paddress (gdbarch, addr), stream);
c906108c
SS
1547 fprintf_filtered (stream, " out of bounds>");
1548 }
1549 else
1550 {
1551 fprintf_filtered (stream, " <Error reading address ");
5af949e3 1552 fputs_filtered (paddress (gdbarch, addr), stream);
c906108c
SS
1553 fprintf_filtered (stream, ": %s>", safe_strerror (errcode));
1554 }
1555 }
ae6a3a4c 1556
c906108c
SS
1557 gdb_flush (stream);
1558 do_cleanups (old_chain);
ae6a3a4c
TJB
1559
1560 return (bytes_read / width);
c906108c 1561}
c906108c 1562\f
c5aa993b 1563
09e6485f
PA
1564/* The 'set input-radix' command writes to this auxiliary variable.
1565 If the requested radix is valid, INPUT_RADIX is updated; otherwise,
1566 it is left unchanged. */
1567
1568static unsigned input_radix_1 = 10;
1569
c906108c
SS
1570/* Validate an input or output radix setting, and make sure the user
1571 knows what they really did here. Radix setting is confusing, e.g.
1572 setting the input radix to "10" never changes it! */
1573
c906108c 1574static void
fba45db2 1575set_input_radix (char *args, int from_tty, struct cmd_list_element *c)
c906108c 1576{
09e6485f 1577 set_input_radix_1 (from_tty, input_radix_1);
c906108c
SS
1578}
1579
c906108c 1580static void
fba45db2 1581set_input_radix_1 (int from_tty, unsigned radix)
c906108c
SS
1582{
1583 /* We don't currently disallow any input radix except 0 or 1, which don't
1584 make any mathematical sense. In theory, we can deal with any input
1585 radix greater than 1, even if we don't have unique digits for every
1586 value from 0 to radix-1, but in practice we lose on large radix values.
1587 We should either fix the lossage or restrict the radix range more.
581e13c1 1588 (FIXME). */
c906108c
SS
1589
1590 if (radix < 2)
1591 {
09e6485f 1592 input_radix_1 = input_radix;
8a3fe4f8 1593 error (_("Nonsense input radix ``decimal %u''; input radix unchanged."),
c906108c
SS
1594 radix);
1595 }
09e6485f 1596 input_radix_1 = input_radix = radix;
c906108c
SS
1597 if (from_tty)
1598 {
3e43a32a
MS
1599 printf_filtered (_("Input radix now set to "
1600 "decimal %u, hex %x, octal %o.\n"),
c906108c
SS
1601 radix, radix, radix);
1602 }
1603}
1604
09e6485f
PA
1605/* The 'set output-radix' command writes to this auxiliary variable.
1606 If the requested radix is valid, OUTPUT_RADIX is updated,
1607 otherwise, it is left unchanged. */
1608
1609static unsigned output_radix_1 = 10;
1610
c906108c 1611static void
fba45db2 1612set_output_radix (char *args, int from_tty, struct cmd_list_element *c)
c906108c 1613{
09e6485f 1614 set_output_radix_1 (from_tty, output_radix_1);
c906108c
SS
1615}
1616
1617static void
fba45db2 1618set_output_radix_1 (int from_tty, unsigned radix)
c906108c
SS
1619{
1620 /* Validate the radix and disallow ones that we aren't prepared to
581e13c1 1621 handle correctly, leaving the radix unchanged. */
c906108c
SS
1622 switch (radix)
1623 {
1624 case 16:
79a45b7d 1625 user_print_options.output_format = 'x'; /* hex */
c906108c
SS
1626 break;
1627 case 10:
79a45b7d 1628 user_print_options.output_format = 0; /* decimal */
c906108c
SS
1629 break;
1630 case 8:
79a45b7d 1631 user_print_options.output_format = 'o'; /* octal */
c906108c
SS
1632 break;
1633 default:
09e6485f 1634 output_radix_1 = output_radix;
3e43a32a
MS
1635 error (_("Unsupported output radix ``decimal %u''; "
1636 "output radix unchanged."),
c906108c
SS
1637 radix);
1638 }
09e6485f 1639 output_radix_1 = output_radix = radix;
c906108c
SS
1640 if (from_tty)
1641 {
3e43a32a
MS
1642 printf_filtered (_("Output radix now set to "
1643 "decimal %u, hex %x, octal %o.\n"),
c906108c
SS
1644 radix, radix, radix);
1645 }
1646}
1647
1648/* Set both the input and output radix at once. Try to set the output radix
1649 first, since it has the most restrictive range. An radix that is valid as
1650 an output radix is also valid as an input radix.
1651
1652 It may be useful to have an unusual input radix. If the user wishes to
1653 set an input radix that is not valid as an output radix, he needs to use
581e13c1 1654 the 'set input-radix' command. */
c906108c
SS
1655
1656static void
fba45db2 1657set_radix (char *arg, int from_tty)
c906108c
SS
1658{
1659 unsigned radix;
1660
bb518678 1661 radix = (arg == NULL) ? 10 : parse_and_eval_long (arg);
c906108c
SS
1662 set_output_radix_1 (0, radix);
1663 set_input_radix_1 (0, radix);
1664 if (from_tty)
1665 {
3e43a32a
MS
1666 printf_filtered (_("Input and output radices now set to "
1667 "decimal %u, hex %x, octal %o.\n"),
c906108c
SS
1668 radix, radix, radix);
1669 }
1670}
1671
581e13c1 1672/* Show both the input and output radices. */
c906108c 1673
c906108c 1674static void
fba45db2 1675show_radix (char *arg, int from_tty)
c906108c
SS
1676{
1677 if (from_tty)
1678 {
1679 if (input_radix == output_radix)
1680 {
3e43a32a
MS
1681 printf_filtered (_("Input and output radices set to "
1682 "decimal %u, hex %x, octal %o.\n"),
c906108c
SS
1683 input_radix, input_radix, input_radix);
1684 }
1685 else
1686 {
3e43a32a
MS
1687 printf_filtered (_("Input radix set to decimal "
1688 "%u, hex %x, octal %o.\n"),
c906108c 1689 input_radix, input_radix, input_radix);
3e43a32a
MS
1690 printf_filtered (_("Output radix set to decimal "
1691 "%u, hex %x, octal %o.\n"),
c906108c
SS
1692 output_radix, output_radix, output_radix);
1693 }
1694 }
1695}
c906108c 1696\f
c5aa993b 1697
c906108c 1698static void
fba45db2 1699set_print (char *arg, int from_tty)
c906108c
SS
1700{
1701 printf_unfiltered (
c5aa993b 1702 "\"set print\" must be followed by the name of a print subcommand.\n");
c906108c
SS
1703 help_list (setprintlist, "set print ", -1, gdb_stdout);
1704}
1705
c906108c 1706static void
fba45db2 1707show_print (char *args, int from_tty)
c906108c
SS
1708{
1709 cmd_show_list (showprintlist, from_tty, "");
1710}
1711\f
1712void
fba45db2 1713_initialize_valprint (void)
c906108c 1714{
c906108c 1715 add_prefix_cmd ("print", no_class, set_print,
1bedd215 1716 _("Generic command for setting how things print."),
c906108c 1717 &setprintlist, "set print ", 0, &setlist);
c5aa993b 1718 add_alias_cmd ("p", "print", no_class, 1, &setlist);
581e13c1 1719 /* Prefer set print to set prompt. */
c906108c
SS
1720 add_alias_cmd ("pr", "print", no_class, 1, &setlist);
1721
1722 add_prefix_cmd ("print", no_class, show_print,
1bedd215 1723 _("Generic command for showing print settings."),
c906108c 1724 &showprintlist, "show print ", 0, &showlist);
c5aa993b
JM
1725 add_alias_cmd ("p", "print", no_class, 1, &showlist);
1726 add_alias_cmd ("pr", "print", no_class, 1, &showlist);
c906108c 1727
79a45b7d
TT
1728 add_setshow_uinteger_cmd ("elements", no_class,
1729 &user_print_options.print_max, _("\
35096d9d
AC
1730Set limit on string chars or array elements to print."), _("\
1731Show limit on string chars or array elements to print."), _("\
1732\"set print elements 0\" causes there to be no limit."),
1733 NULL,
920d2a44 1734 show_print_max,
35096d9d 1735 &setprintlist, &showprintlist);
c906108c 1736
79a45b7d
TT
1737 add_setshow_boolean_cmd ("null-stop", no_class,
1738 &user_print_options.stop_print_at_null, _("\
5bf193a2
AC
1739Set printing of char arrays to stop at first null char."), _("\
1740Show printing of char arrays to stop at first null char."), NULL,
1741 NULL,
920d2a44 1742 show_stop_print_at_null,
5bf193a2 1743 &setprintlist, &showprintlist);
c906108c 1744
35096d9d 1745 add_setshow_uinteger_cmd ("repeats", no_class,
79a45b7d 1746 &user_print_options.repeat_count_threshold, _("\
35096d9d
AC
1747Set threshold for repeated print elements."), _("\
1748Show threshold for repeated print elements."), _("\
1749\"set print repeats 0\" causes all elements to be individually printed."),
1750 NULL,
920d2a44 1751 show_repeat_count_threshold,
35096d9d 1752 &setprintlist, &showprintlist);
c906108c 1753
79a45b7d
TT
1754 add_setshow_boolean_cmd ("pretty", class_support,
1755 &user_print_options.prettyprint_structs, _("\
5bf193a2
AC
1756Set prettyprinting of structures."), _("\
1757Show prettyprinting of structures."), NULL,
1758 NULL,
920d2a44 1759 show_prettyprint_structs,
5bf193a2
AC
1760 &setprintlist, &showprintlist);
1761
79a45b7d
TT
1762 add_setshow_boolean_cmd ("union", class_support,
1763 &user_print_options.unionprint, _("\
5bf193a2
AC
1764Set printing of unions interior to structures."), _("\
1765Show printing of unions interior to structures."), NULL,
1766 NULL,
920d2a44 1767 show_unionprint,
5bf193a2
AC
1768 &setprintlist, &showprintlist);
1769
79a45b7d
TT
1770 add_setshow_boolean_cmd ("array", class_support,
1771 &user_print_options.prettyprint_arrays, _("\
5bf193a2
AC
1772Set prettyprinting of arrays."), _("\
1773Show prettyprinting of arrays."), NULL,
1774 NULL,
920d2a44 1775 show_prettyprint_arrays,
5bf193a2
AC
1776 &setprintlist, &showprintlist);
1777
79a45b7d
TT
1778 add_setshow_boolean_cmd ("address", class_support,
1779 &user_print_options.addressprint, _("\
5bf193a2
AC
1780Set printing of addresses."), _("\
1781Show printing of addresses."), NULL,
1782 NULL,
920d2a44 1783 show_addressprint,
5bf193a2 1784 &setprintlist, &showprintlist);
c906108c 1785
1e8fb976
PA
1786 add_setshow_zuinteger_cmd ("input-radix", class_support, &input_radix_1,
1787 _("\
35096d9d
AC
1788Set default input radix for entering numbers."), _("\
1789Show default input radix for entering numbers."), NULL,
1e8fb976
PA
1790 set_input_radix,
1791 show_input_radix,
1792 &setlist, &showlist);
35096d9d 1793
1e8fb976
PA
1794 add_setshow_zuinteger_cmd ("output-radix", class_support, &output_radix_1,
1795 _("\
35096d9d
AC
1796Set default output radix for printing of values."), _("\
1797Show default output radix for printing of values."), NULL,
1e8fb976
PA
1798 set_output_radix,
1799 show_output_radix,
1800 &setlist, &showlist);
c906108c 1801
cb1a6d5f
AC
1802 /* The "set radix" and "show radix" commands are special in that
1803 they are like normal set and show commands but allow two normally
1804 independent variables to be either set or shown with a single
b66df561 1805 command. So the usual deprecated_add_set_cmd() and [deleted]
581e13c1 1806 add_show_from_set() commands aren't really appropriate. */
b66df561
AC
1807 /* FIXME: i18n: With the new add_setshow_integer command, that is no
1808 longer true - show can display anything. */
1a966eab
AC
1809 add_cmd ("radix", class_support, set_radix, _("\
1810Set default input and output number radices.\n\
c906108c 1811Use 'set input-radix' or 'set output-radix' to independently set each.\n\
1a966eab 1812Without an argument, sets both radices back to the default value of 10."),
c906108c 1813 &setlist);
1a966eab
AC
1814 add_cmd ("radix", class_support, show_radix, _("\
1815Show the default input and output number radices.\n\
1816Use 'show input-radix' or 'show output-radix' to independently show each."),
c906108c
SS
1817 &showlist);
1818
e79af960 1819 add_setshow_boolean_cmd ("array-indexes", class_support,
79a45b7d 1820 &user_print_options.print_array_indexes, _("\
e79af960
JB
1821Set printing of array indexes."), _("\
1822Show printing of array indexes"), NULL, NULL, show_print_array_indexes,
1823 &setprintlist, &showprintlist);
c906108c 1824}