Include gdb_assert.h in common-defs.h
[platform/upstream/binutils.git] / gdb / expprint.c
1 /* Print in infix form a struct expression.
2
3    Copyright (C) 1986-2014 Free Software Foundation, Inc.
4
5    This file is part of GDB.
6
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 3 of the License, or
10    (at your option) any later version.
11
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.
16
17    You should have received a copy of the GNU General Public License
18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19
20 #include "defs.h"
21 #include "symtab.h"
22 #include "gdbtypes.h"
23 #include "expression.h"
24 #include "value.h"
25 #include "language.h"
26 #include "parser-defs.h"
27 #include "user-regs.h"          /* For user_reg_map_regnum_to_name.  */
28 #include "target.h"
29 #include <string.h>
30 #include "block.h"
31 #include "objfiles.h"
32 #include "valprint.h"
33
34 #include <ctype.h>
35
36 void
37 print_expression (struct expression *exp, struct ui_file *stream)
38 {
39   int pc = 0;
40
41   print_subexp (exp, &pc, stream, PREC_NULL);
42 }
43
44 /* Print the subexpression of EXP that starts in position POS, on STREAM.
45    PREC is the precedence of the surrounding operator;
46    if the precedence of the main operator of this subexpression is less,
47    parentheses are needed here.  */
48
49 void
50 print_subexp (struct expression *exp, int *pos,
51               struct ui_file *stream, enum precedence prec)
52 {
53   exp->language_defn->la_exp_desc->print_subexp (exp, pos, stream, prec);
54 }
55
56 /* Standard implementation of print_subexp for use in language_defn
57    vectors.  */
58 void
59 print_subexp_standard (struct expression *exp, int *pos,
60                        struct ui_file *stream, enum precedence prec)
61 {
62   unsigned tem;
63   const struct op_print *op_print_tab;
64   int pc;
65   unsigned nargs;
66   char *op_str;
67   int assign_modify = 0;
68   enum exp_opcode opcode;
69   enum precedence myprec = PREC_NULL;
70   /* Set to 1 for a right-associative operator.  */
71   int assoc = 0;
72   struct value *val;
73   char *tempstr = NULL;
74
75   op_print_tab = exp->language_defn->la_op_print_tab;
76   pc = (*pos)++;
77   opcode = exp->elts[pc].opcode;
78   switch (opcode)
79     {
80       /* Common ops */
81
82     case OP_TYPE:
83       (*pos) += 2;
84       type_print (exp->elts[pc + 1].type, "", stream, 0);
85       return;
86
87     case OP_SCOPE:
88       myprec = PREC_PREFIX;
89       assoc = 0;
90       fputs_filtered (type_name_no_tag (exp->elts[pc + 1].type), stream);
91       fputs_filtered ("::", stream);
92       nargs = longest_to_int (exp->elts[pc + 2].longconst);
93       (*pos) += 4 + BYTES_TO_EXP_ELEM (nargs + 1);
94       fputs_filtered (&exp->elts[pc + 3].string, stream);
95       return;
96
97     case OP_LONG:
98       {
99         struct value_print_options opts;
100
101         get_no_prettyformat_print_options (&opts);
102         (*pos) += 3;
103         value_print (value_from_longest (exp->elts[pc + 1].type,
104                                          exp->elts[pc + 2].longconst),
105                      stream, &opts);
106       }
107       return;
108
109     case OP_DOUBLE:
110       {
111         struct value_print_options opts;
112
113         get_no_prettyformat_print_options (&opts);
114         (*pos) += 3;
115         value_print (value_from_double (exp->elts[pc + 1].type,
116                                         exp->elts[pc + 2].doubleconst),
117                      stream, &opts);
118       }
119       return;
120
121     case OP_VAR_VALUE:
122       {
123         const struct block *b;
124
125         (*pos) += 3;
126         b = exp->elts[pc + 1].block;
127         if (b != NULL
128             && BLOCK_FUNCTION (b) != NULL
129             && SYMBOL_PRINT_NAME (BLOCK_FUNCTION (b)) != NULL)
130           {
131             fputs_filtered (SYMBOL_PRINT_NAME (BLOCK_FUNCTION (b)), stream);
132             fputs_filtered ("::", stream);
133           }
134         fputs_filtered (SYMBOL_PRINT_NAME (exp->elts[pc + 2].symbol), stream);
135       }
136       return;
137
138     case OP_VAR_ENTRY_VALUE:
139       {
140         (*pos) += 2;
141         fprintf_filtered (stream, "%s@entry",
142                           SYMBOL_PRINT_NAME (exp->elts[pc + 1].symbol));
143       }
144       return;
145
146     case OP_LAST:
147       (*pos) += 2;
148       fprintf_filtered (stream, "$%d",
149                         longest_to_int (exp->elts[pc + 1].longconst));
150       return;
151
152     case OP_REGISTER:
153       {
154         const char *name = &exp->elts[pc + 2].string;
155
156         (*pos) += 3 + BYTES_TO_EXP_ELEM (exp->elts[pc + 1].longconst + 1);
157         fprintf_filtered (stream, "$%s", name);
158         return;
159       }
160
161     case OP_BOOL:
162       (*pos) += 2;
163       fprintf_filtered (stream, "%s",
164                         longest_to_int (exp->elts[pc + 1].longconst)
165                         ? "TRUE" : "FALSE");
166       return;
167
168     case OP_INTERNALVAR:
169       (*pos) += 2;
170       fprintf_filtered (stream, "$%s",
171                         internalvar_name (exp->elts[pc + 1].internalvar));
172       return;
173
174     case OP_FUNCALL:
175       (*pos) += 2;
176       nargs = longest_to_int (exp->elts[pc + 1].longconst);
177       print_subexp (exp, pos, stream, PREC_SUFFIX);
178       fputs_filtered (" (", stream);
179       for (tem = 0; tem < nargs; tem++)
180         {
181           if (tem != 0)
182             fputs_filtered (", ", stream);
183           print_subexp (exp, pos, stream, PREC_ABOVE_COMMA);
184         }
185       fputs_filtered (")", stream);
186       return;
187
188     case OP_NAME:
189       nargs = longest_to_int (exp->elts[pc + 1].longconst);
190       (*pos) += 3 + BYTES_TO_EXP_ELEM (nargs + 1);
191       fputs_filtered (&exp->elts[pc + 2].string, stream);
192       return;
193
194     case OP_STRING:
195       {
196         struct value_print_options opts;
197
198         nargs = longest_to_int (exp->elts[pc + 1].longconst);
199         (*pos) += 3 + BYTES_TO_EXP_ELEM (nargs + 1);
200         /* LA_PRINT_STRING will print using the current repeat count threshold.
201            If necessary, we can temporarily set it to zero, or pass it as an
202            additional parameter to LA_PRINT_STRING.  -fnf */
203         get_user_print_options (&opts);
204         LA_PRINT_STRING (stream, builtin_type (exp->gdbarch)->builtin_char,
205                          (gdb_byte *) &exp->elts[pc + 2].string, nargs,
206                          NULL, 0, &opts);
207       }
208       return;
209
210     case OP_OBJC_NSSTRING:      /* Objective-C Foundation Class
211                                    NSString constant.  */
212       {
213         struct value_print_options opts;
214
215         nargs = longest_to_int (exp->elts[pc + 1].longconst);
216         (*pos) += 3 + BYTES_TO_EXP_ELEM (nargs + 1);
217         fputs_filtered ("@\"", stream);
218         get_user_print_options (&opts);
219         LA_PRINT_STRING (stream, builtin_type (exp->gdbarch)->builtin_char,
220                          (gdb_byte *) &exp->elts[pc + 2].string, nargs,
221                          NULL, 0, &opts);
222         fputs_filtered ("\"", stream);
223       }
224       return;
225
226     case OP_OBJC_MSGCALL:
227       {                 /* Objective C message (method) call.  */
228         char *selector;
229
230         (*pos) += 3;
231         nargs = longest_to_int (exp->elts[pc + 2].longconst);
232         fprintf_unfiltered (stream, "[");
233         print_subexp (exp, pos, stream, PREC_SUFFIX);
234         if (0 == target_read_string (exp->elts[pc + 1].longconst,
235                                      &selector, 1024, NULL))
236           {
237             error (_("bad selector"));
238             return;
239           }
240         if (nargs)
241           {
242             char *s, *nextS;
243
244             s = alloca (strlen (selector) + 1);
245             strcpy (s, selector);
246             for (tem = 0; tem < nargs; tem++)
247               {
248                 nextS = strchr (s, ':');
249                 gdb_assert (nextS);     /* Make sure we found ':'.  */
250                 *nextS = '\0';
251                 fprintf_unfiltered (stream, " %s: ", s);
252                 s = nextS + 1;
253                 print_subexp (exp, pos, stream, PREC_ABOVE_COMMA);
254               }
255           }
256         else
257           {
258             fprintf_unfiltered (stream, " %s", selector);
259           }
260         fprintf_unfiltered (stream, "]");
261         /* "selector" was malloc'd by target_read_string.  Free it.  */
262         xfree (selector);
263         return;
264       }
265
266     case OP_ARRAY:
267       (*pos) += 3;
268       nargs = longest_to_int (exp->elts[pc + 2].longconst);
269       nargs -= longest_to_int (exp->elts[pc + 1].longconst);
270       nargs++;
271       tem = 0;
272       if (exp->elts[pc + 4].opcode == OP_LONG
273           && exp->elts[pc + 5].type
274              == builtin_type (exp->gdbarch)->builtin_char
275           && exp->language_defn->la_language == language_c)
276         {
277           /* Attempt to print C character arrays using string syntax.
278              Walk through the args, picking up one character from each
279              of the OP_LONG expression elements.  If any array element
280              does not match our expection of what we should find for
281              a simple string, revert back to array printing.  Note that
282              the last expression element is an explicit null terminator
283              byte, which doesn't get printed.  */
284           tempstr = alloca (nargs);
285           pc += 4;
286           while (tem < nargs)
287             {
288               if (exp->elts[pc].opcode != OP_LONG
289                   || exp->elts[pc + 1].type
290                      != builtin_type (exp->gdbarch)->builtin_char)
291                 {
292                   /* Not a simple array of char, use regular array
293                      printing.  */
294                   tem = 0;
295                   break;
296                 }
297               else
298                 {
299                   tempstr[tem++] =
300                     longest_to_int (exp->elts[pc + 2].longconst);
301                   pc += 4;
302                 }
303             }
304         }
305       if (tem > 0)
306         {
307           struct value_print_options opts;
308
309           get_user_print_options (&opts);
310           LA_PRINT_STRING (stream, builtin_type (exp->gdbarch)->builtin_char,
311                            (gdb_byte *) tempstr, nargs - 1, NULL, 0, &opts);
312           (*pos) = pc;
313         }
314       else
315         {
316           fputs_filtered (" {", stream);
317           for (tem = 0; tem < nargs; tem++)
318             {
319               if (tem != 0)
320                 {
321                   fputs_filtered (", ", stream);
322                 }
323               print_subexp (exp, pos, stream, PREC_ABOVE_COMMA);
324             }
325           fputs_filtered ("}", stream);
326         }
327       return;
328
329     case TERNOP_COND:
330       if ((int) prec > (int) PREC_COMMA)
331         fputs_filtered ("(", stream);
332       /* Print the subexpressions, forcing parentheses
333          around any binary operations within them.
334          This is more parentheses than are strictly necessary,
335          but it looks clearer.  */
336       print_subexp (exp, pos, stream, PREC_HYPER);
337       fputs_filtered (" ? ", stream);
338       print_subexp (exp, pos, stream, PREC_HYPER);
339       fputs_filtered (" : ", stream);
340       print_subexp (exp, pos, stream, PREC_HYPER);
341       if ((int) prec > (int) PREC_COMMA)
342         fputs_filtered (")", stream);
343       return;
344
345     case TERNOP_SLICE:
346       print_subexp (exp, pos, stream, PREC_SUFFIX);
347       fputs_filtered ("(", stream);
348       print_subexp (exp, pos, stream, PREC_ABOVE_COMMA);
349       fputs_filtered (opcode == TERNOP_SLICE ? " : " : " UP ", stream);
350       print_subexp (exp, pos, stream, PREC_ABOVE_COMMA);
351       fputs_filtered (")", stream);
352       return;
353
354     case STRUCTOP_STRUCT:
355       tem = longest_to_int (exp->elts[pc + 1].longconst);
356       (*pos) += 3 + BYTES_TO_EXP_ELEM (tem + 1);
357       print_subexp (exp, pos, stream, PREC_SUFFIX);
358       fputs_filtered (".", stream);
359       fputs_filtered (&exp->elts[pc + 2].string, stream);
360       return;
361
362       /* Will not occur for Modula-2.  */
363     case STRUCTOP_PTR:
364       tem = longest_to_int (exp->elts[pc + 1].longconst);
365       (*pos) += 3 + BYTES_TO_EXP_ELEM (tem + 1);
366       print_subexp (exp, pos, stream, PREC_SUFFIX);
367       fputs_filtered ("->", stream);
368       fputs_filtered (&exp->elts[pc + 2].string, stream);
369       return;
370
371     case STRUCTOP_MEMBER:
372       print_subexp (exp, pos, stream, PREC_SUFFIX);
373       fputs_filtered (".*", stream);
374       print_subexp (exp, pos, stream, PREC_SUFFIX);
375       return;
376
377     case STRUCTOP_MPTR:
378       print_subexp (exp, pos, stream, PREC_SUFFIX);
379       fputs_filtered ("->*", stream);
380       print_subexp (exp, pos, stream, PREC_SUFFIX);
381       return;
382
383     case BINOP_SUBSCRIPT:
384       print_subexp (exp, pos, stream, PREC_SUFFIX);
385       fputs_filtered ("[", stream);
386       print_subexp (exp, pos, stream, PREC_ABOVE_COMMA);
387       fputs_filtered ("]", stream);
388       return;
389
390     case UNOP_POSTINCREMENT:
391       print_subexp (exp, pos, stream, PREC_SUFFIX);
392       fputs_filtered ("++", stream);
393       return;
394
395     case UNOP_POSTDECREMENT:
396       print_subexp (exp, pos, stream, PREC_SUFFIX);
397       fputs_filtered ("--", stream);
398       return;
399
400     case UNOP_CAST:
401       (*pos) += 2;
402       if ((int) prec > (int) PREC_PREFIX)
403         fputs_filtered ("(", stream);
404       fputs_filtered ("(", stream);
405       type_print (exp->elts[pc + 1].type, "", stream, 0);
406       fputs_filtered (") ", stream);
407       print_subexp (exp, pos, stream, PREC_PREFIX);
408       if ((int) prec > (int) PREC_PREFIX)
409         fputs_filtered (")", stream);
410       return;
411
412     case UNOP_CAST_TYPE:
413       if ((int) prec > (int) PREC_PREFIX)
414         fputs_filtered ("(", stream);
415       fputs_filtered ("(", stream);
416       print_subexp (exp, pos, stream, PREC_PREFIX);
417       fputs_filtered (") ", stream);
418       print_subexp (exp, pos, stream, PREC_PREFIX);
419       if ((int) prec > (int) PREC_PREFIX)
420         fputs_filtered (")", stream);
421       return;
422
423     case UNOP_DYNAMIC_CAST:
424     case UNOP_REINTERPRET_CAST:
425       fputs_filtered (opcode == UNOP_DYNAMIC_CAST ? "dynamic_cast"
426                       : "reinterpret_cast", stream);
427       fputs_filtered ("<", stream);
428       print_subexp (exp, pos, stream, PREC_PREFIX);
429       fputs_filtered ("> (", stream);
430       print_subexp (exp, pos, stream, PREC_PREFIX);
431       fputs_filtered (")", stream);
432       return;
433
434     case UNOP_MEMVAL:
435       (*pos) += 2;
436       if ((int) prec > (int) PREC_PREFIX)
437         fputs_filtered ("(", stream);
438       if (TYPE_CODE (exp->elts[pc + 1].type) == TYPE_CODE_FUNC
439           && exp->elts[pc + 3].opcode == OP_LONG)
440         {
441           struct value_print_options opts;
442
443           /* We have a minimal symbol fn, probably.  It's encoded
444              as a UNOP_MEMVAL (function-type) of an OP_LONG (int, address).
445              Swallow the OP_LONG (including both its opcodes); ignore
446              its type; print the value in the type of the MEMVAL.  */
447           (*pos) += 4;
448           val = value_at_lazy (exp->elts[pc + 1].type,
449                                (CORE_ADDR) exp->elts[pc + 5].longconst);
450           get_no_prettyformat_print_options (&opts);
451           value_print (val, stream, &opts);
452         }
453       else
454         {
455           fputs_filtered ("{", stream);
456           type_print (exp->elts[pc + 1].type, "", stream, 0);
457           fputs_filtered ("} ", stream);
458           print_subexp (exp, pos, stream, PREC_PREFIX);
459         }
460       if ((int) prec > (int) PREC_PREFIX)
461         fputs_filtered (")", stream);
462       return;
463
464     case UNOP_MEMVAL_TYPE:
465       if ((int) prec > (int) PREC_PREFIX)
466         fputs_filtered ("(", stream);
467       fputs_filtered ("{", stream);
468       print_subexp (exp, pos, stream, PREC_PREFIX);
469       fputs_filtered ("} ", stream);
470       print_subexp (exp, pos, stream, PREC_PREFIX);
471       if ((int) prec > (int) PREC_PREFIX)
472         fputs_filtered (")", stream);
473       return;
474
475     case UNOP_MEMVAL_TLS:
476       (*pos) += 3;
477       if ((int) prec > (int) PREC_PREFIX)
478         fputs_filtered ("(", stream);
479       fputs_filtered ("{", stream);
480       type_print (exp->elts[pc + 2].type, "", stream, 0);
481       fputs_filtered ("} ", stream);
482       print_subexp (exp, pos, stream, PREC_PREFIX);
483       if ((int) prec > (int) PREC_PREFIX)
484         fputs_filtered (")", stream);
485       return;
486
487     case BINOP_ASSIGN_MODIFY:
488       opcode = exp->elts[pc + 1].opcode;
489       (*pos) += 2;
490       myprec = PREC_ASSIGN;
491       assoc = 1;
492       assign_modify = 1;
493       op_str = "???";
494       for (tem = 0; op_print_tab[tem].opcode != OP_NULL; tem++)
495         if (op_print_tab[tem].opcode == opcode)
496           {
497             op_str = op_print_tab[tem].string;
498             break;
499           }
500       if (op_print_tab[tem].opcode != opcode)
501         /* Not found; don't try to keep going because we don't know how
502            to interpret further elements.  */
503         error (_("Invalid expression"));
504       break;
505
506       /* C++ ops */
507
508     case OP_THIS:
509       ++(*pos);
510       if (exp->language_defn->la_name_of_this)
511         fputs_filtered (exp->language_defn->la_name_of_this, stream);
512       else
513         fprintf_filtered (stream, _("<language %s has no 'this'>"),
514                           exp->language_defn->la_name);
515       return;
516
517       /* Modula-2 ops */
518
519     case MULTI_SUBSCRIPT:
520       (*pos) += 2;
521       nargs = longest_to_int (exp->elts[pc + 1].longconst);
522       print_subexp (exp, pos, stream, PREC_SUFFIX);
523       fprintf_unfiltered (stream, " [");
524       for (tem = 0; tem < nargs; tem++)
525         {
526           if (tem != 0)
527             fprintf_unfiltered (stream, ", ");
528           print_subexp (exp, pos, stream, PREC_ABOVE_COMMA);
529         }
530       fprintf_unfiltered (stream, "]");
531       return;
532
533     case BINOP_VAL:
534       (*pos) += 2;
535       fprintf_unfiltered (stream, "VAL(");
536       type_print (exp->elts[pc + 1].type, "", stream, 0);
537       fprintf_unfiltered (stream, ",");
538       print_subexp (exp, pos, stream, PREC_PREFIX);
539       fprintf_unfiltered (stream, ")");
540       return;
541
542     case TYPE_INSTANCE:
543       {
544         LONGEST count = exp->elts[pc + 1].longconst;
545
546         /* The COUNT.  */
547         (*pos)++;
548         fputs_unfiltered ("TypesInstance(", stream);
549         while (count-- > 0)
550           {
551             type_print (exp->elts[(*pos)++].type, "", stream, 0);
552             if (count > 0)
553               fputs_unfiltered (",", stream);
554           }
555         fputs_unfiltered (",", stream);
556         /* Ending COUNT and ending TYPE_INSTANCE.  */
557         (*pos) += 2;
558         print_subexp (exp, pos, stream, PREC_PREFIX);
559         fputs_unfiltered (")", stream);
560         return;
561       }
562
563       /* Default ops */
564
565     default:
566       op_str = "???";
567       for (tem = 0; op_print_tab[tem].opcode != OP_NULL; tem++)
568         if (op_print_tab[tem].opcode == opcode)
569           {
570             op_str = op_print_tab[tem].string;
571             myprec = op_print_tab[tem].precedence;
572             assoc = op_print_tab[tem].right_assoc;
573             break;
574           }
575       if (op_print_tab[tem].opcode != opcode)
576         /* Not found; don't try to keep going because we don't know how
577            to interpret further elements.  For example, this happens
578            if opcode is OP_TYPE.  */
579         error (_("Invalid expression"));
580     }
581
582   /* Note that PREC_BUILTIN will always emit parentheses.  */
583   if ((int) myprec < (int) prec)
584     fputs_filtered ("(", stream);
585   if ((int) opcode > (int) BINOP_END)
586     {
587       if (assoc)
588         {
589           /* Unary postfix operator.  */
590           print_subexp (exp, pos, stream, PREC_SUFFIX);
591           fputs_filtered (op_str, stream);
592         }
593       else
594         {
595           /* Unary prefix operator.  */
596           fputs_filtered (op_str, stream);
597           if (myprec == PREC_BUILTIN_FUNCTION)
598             fputs_filtered ("(", stream);
599           print_subexp (exp, pos, stream, PREC_PREFIX);
600           if (myprec == PREC_BUILTIN_FUNCTION)
601             fputs_filtered (")", stream);
602         }
603     }
604   else
605     {
606       /* Binary operator.  */
607       /* Print left operand.
608          If operator is right-associative,
609          increment precedence for this operand.  */
610       print_subexp (exp, pos, stream,
611                     (enum precedence) ((int) myprec + assoc));
612       /* Print the operator itself.  */
613       if (assign_modify)
614         fprintf_filtered (stream, " %s= ", op_str);
615       else if (op_str[0] == ',')
616         fprintf_filtered (stream, "%s ", op_str);
617       else
618         fprintf_filtered (stream, " %s ", op_str);
619       /* Print right operand.
620          If operator is left-associative,
621          increment precedence for this operand.  */
622       print_subexp (exp, pos, stream,
623                     (enum precedence) ((int) myprec + !assoc));
624     }
625
626   if ((int) myprec < (int) prec)
627     fputs_filtered (")", stream);
628 }
629
630 /* Return the operator corresponding to opcode OP as
631    a string.   NULL indicates that the opcode was not found in the
632    current language table.  */
633 char *
634 op_string (enum exp_opcode op)
635 {
636   int tem;
637   const struct op_print *op_print_tab;
638
639   op_print_tab = current_language->la_op_print_tab;
640   for (tem = 0; op_print_tab[tem].opcode != OP_NULL; tem++)
641     if (op_print_tab[tem].opcode == op)
642       return op_print_tab[tem].string;
643   return NULL;
644 }
645
646 /* Support for dumping the raw data from expressions in a human readable
647    form.  */
648
649 static int dump_subexp_body (struct expression *exp, struct ui_file *, int);
650
651 /* Name for OPCODE, when it appears in expression EXP.  */
652
653 char *
654 op_name (struct expression *exp, enum exp_opcode opcode)
655 {
656   return exp->language_defn->la_exp_desc->op_name (opcode);
657 }
658
659 /* Default name for the standard operator OPCODE (i.e., one defined in
660    the definition of enum exp_opcode).  */
661
662 char *
663 op_name_standard (enum exp_opcode opcode)
664 {
665   switch (opcode)
666     {
667     default:
668       {
669         static char buf[30];
670
671         xsnprintf (buf, sizeof (buf), "<unknown %d>", opcode);
672         return buf;
673       }
674 #define OP(name)        \
675     case name:          \
676       return #name ;
677 #include "std-operator.def"
678 #undef OP
679     }
680 }
681
682 /* Print a raw dump of expression EXP to STREAM.
683    NOTE, if non-NULL, is printed as extra explanatory text.  */
684
685 void
686 dump_raw_expression (struct expression *exp, struct ui_file *stream,
687                      char *note)
688 {
689   int elt;
690   char *opcode_name;
691   char *eltscan;
692   int eltsize;
693
694   fprintf_filtered (stream, "Dump of expression @ ");
695   gdb_print_host_address (exp, stream);
696   if (note)
697     fprintf_filtered (stream, ", %s:", note);
698   fprintf_filtered (stream, "\n\tLanguage %s, %d elements, %ld bytes each.\n",
699                     exp->language_defn->la_name, exp->nelts,
700                     (long) sizeof (union exp_element));
701   fprintf_filtered (stream, "\t%5s  %20s  %16s  %s\n", "Index", "Opcode",
702                     "Hex Value", "String Value");
703   for (elt = 0; elt < exp->nelts; elt++)
704     {
705       fprintf_filtered (stream, "\t%5d  ", elt);
706       opcode_name = op_name (exp, exp->elts[elt].opcode);
707
708       fprintf_filtered (stream, "%20s  ", opcode_name);
709       print_longest (stream, 'd', 0, exp->elts[elt].longconst);
710       fprintf_filtered (stream, "  ");
711
712       for (eltscan = (char *) &exp->elts[elt],
713            eltsize = sizeof (union exp_element);
714            eltsize-- > 0;
715            eltscan++)
716         {
717           fprintf_filtered (stream, "%c",
718                             isprint (*eltscan) ? (*eltscan & 0xFF) : '.');
719         }
720       fprintf_filtered (stream, "\n");
721     }
722 }
723
724 /* Dump the subexpression of prefix expression EXP whose operator is at
725    position ELT onto STREAM.  Returns the position of the next 
726    subexpression in EXP.  */
727
728 int
729 dump_subexp (struct expression *exp, struct ui_file *stream, int elt)
730 {
731   static int indent = 0;
732   int i;
733
734   fprintf_filtered (stream, "\n");
735   fprintf_filtered (stream, "\t%5d  ", elt);
736
737   for (i = 1; i <= indent; i++)
738     fprintf_filtered (stream, " ");
739   indent += 2;
740
741   fprintf_filtered (stream, "%-20s  ", op_name (exp, exp->elts[elt].opcode));
742
743   elt = dump_subexp_body (exp, stream, elt);
744
745   indent -= 2;
746
747   return elt;
748 }
749
750 /* Dump the operands of prefix expression EXP whose opcode is at
751    position ELT onto STREAM.  Returns the position of the next 
752    subexpression in EXP.  */
753
754 static int
755 dump_subexp_body (struct expression *exp, struct ui_file *stream, int elt)
756 {
757   return exp->language_defn->la_exp_desc->dump_subexp_body (exp, stream, elt);
758 }
759
760 /* Default value for subexp_body in exp_descriptor vector.  */
761
762 int
763 dump_subexp_body_standard (struct expression *exp, 
764                            struct ui_file *stream, int elt)
765 {
766   int opcode = exp->elts[elt++].opcode;
767
768   switch (opcode)
769     {
770     case TERNOP_COND:
771     case TERNOP_SLICE:
772       elt = dump_subexp (exp, stream, elt);
773       /* FALL THROUGH */
774     case BINOP_ADD:
775     case BINOP_SUB:
776     case BINOP_MUL:
777     case BINOP_DIV:
778     case BINOP_REM:
779     case BINOP_MOD:
780     case BINOP_LSH:
781     case BINOP_RSH:
782     case BINOP_LOGICAL_AND:
783     case BINOP_LOGICAL_OR:
784     case BINOP_BITWISE_AND:
785     case BINOP_BITWISE_IOR:
786     case BINOP_BITWISE_XOR:
787     case BINOP_EQUAL:
788     case BINOP_NOTEQUAL:
789     case BINOP_LESS:
790     case BINOP_GTR:
791     case BINOP_LEQ:
792     case BINOP_GEQ:
793     case BINOP_REPEAT:
794     case BINOP_ASSIGN:
795     case BINOP_COMMA:
796     case BINOP_SUBSCRIPT:
797     case BINOP_EXP:
798     case BINOP_MIN:
799     case BINOP_MAX:
800     case BINOP_INTDIV:
801     case BINOP_ASSIGN_MODIFY:
802     case BINOP_VAL:
803     case BINOP_CONCAT:
804     case BINOP_END:
805     case STRUCTOP_MEMBER:
806     case STRUCTOP_MPTR:
807       elt = dump_subexp (exp, stream, elt);
808       /* FALL THROUGH */
809     case UNOP_NEG:
810     case UNOP_LOGICAL_NOT:
811     case UNOP_COMPLEMENT:
812     case UNOP_IND:
813     case UNOP_ADDR:
814     case UNOP_PREINCREMENT:
815     case UNOP_POSTINCREMENT:
816     case UNOP_PREDECREMENT:
817     case UNOP_POSTDECREMENT:
818     case UNOP_SIZEOF:
819     case UNOP_PLUS:
820     case UNOP_CAP:
821     case UNOP_CHR:
822     case UNOP_ORD:
823     case UNOP_ABS:
824     case UNOP_FLOAT:
825     case UNOP_HIGH:
826     case UNOP_MAX:
827     case UNOP_MIN:
828     case UNOP_ODD:
829     case UNOP_TRUNC:
830       elt = dump_subexp (exp, stream, elt);
831       break;
832     case OP_LONG:
833       fprintf_filtered (stream, "Type @");
834       gdb_print_host_address (exp->elts[elt].type, stream);
835       fprintf_filtered (stream, " (");
836       type_print (exp->elts[elt].type, NULL, stream, 0);
837       fprintf_filtered (stream, "), value %ld (0x%lx)",
838                         (long) exp->elts[elt + 1].longconst,
839                         (long) exp->elts[elt + 1].longconst);
840       elt += 3;
841       break;
842     case OP_DOUBLE:
843       fprintf_filtered (stream, "Type @");
844       gdb_print_host_address (exp->elts[elt].type, stream);
845       fprintf_filtered (stream, " (");
846       type_print (exp->elts[elt].type, NULL, stream, 0);
847       fprintf_filtered (stream, "), value %g",
848                         (double) exp->elts[elt + 1].doubleconst);
849       elt += 3;
850       break;
851     case OP_VAR_VALUE:
852       fprintf_filtered (stream, "Block @");
853       gdb_print_host_address (exp->elts[elt].block, stream);
854       fprintf_filtered (stream, ", symbol @");
855       gdb_print_host_address (exp->elts[elt + 1].symbol, stream);
856       fprintf_filtered (stream, " (%s)",
857                         SYMBOL_PRINT_NAME (exp->elts[elt + 1].symbol));
858       elt += 3;
859       break;
860     case OP_VAR_ENTRY_VALUE:
861       fprintf_filtered (stream, "Entry value of symbol @");
862       gdb_print_host_address (exp->elts[elt].symbol, stream);
863       fprintf_filtered (stream, " (%s)",
864                         SYMBOL_PRINT_NAME (exp->elts[elt].symbol));
865       elt += 2;
866       break;
867     case OP_LAST:
868       fprintf_filtered (stream, "History element %ld",
869                         (long) exp->elts[elt].longconst);
870       elt += 2;
871       break;
872     case OP_REGISTER:
873       fprintf_filtered (stream, "Register $%s", &exp->elts[elt + 1].string);
874       elt += 3 + BYTES_TO_EXP_ELEM (exp->elts[elt].longconst + 1);
875       break;
876     case OP_INTERNALVAR:
877       fprintf_filtered (stream, "Internal var @");
878       gdb_print_host_address (exp->elts[elt].internalvar, stream);
879       fprintf_filtered (stream, " (%s)",
880                         internalvar_name (exp->elts[elt].internalvar));
881       elt += 2;
882       break;
883     case OP_FUNCALL:
884       {
885         int i, nargs;
886
887         nargs = longest_to_int (exp->elts[elt].longconst);
888
889         fprintf_filtered (stream, "Number of args: %d", nargs);
890         elt += 2;
891
892         for (i = 1; i <= nargs + 1; i++)
893           elt = dump_subexp (exp, stream, elt);
894       }
895       break;
896     case OP_ARRAY:
897       {
898         int lower, upper;
899         int i;
900
901         lower = longest_to_int (exp->elts[elt].longconst);
902         upper = longest_to_int (exp->elts[elt + 1].longconst);
903
904         fprintf_filtered (stream, "Bounds [%d:%d]", lower, upper);
905         elt += 3;
906
907         for (i = 1; i <= upper - lower + 1; i++)
908           elt = dump_subexp (exp, stream, elt);
909       }
910       break;
911     case UNOP_DYNAMIC_CAST:
912     case UNOP_REINTERPRET_CAST:
913     case UNOP_CAST_TYPE:
914     case UNOP_MEMVAL_TYPE:
915       fprintf_filtered (stream, " (");
916       elt = dump_subexp (exp, stream, elt);
917       fprintf_filtered (stream, ")");
918       elt = dump_subexp (exp, stream, elt);
919       break;
920     case UNOP_MEMVAL:
921     case UNOP_CAST:
922       fprintf_filtered (stream, "Type @");
923       gdb_print_host_address (exp->elts[elt].type, stream);
924       fprintf_filtered (stream, " (");
925       type_print (exp->elts[elt].type, NULL, stream, 0);
926       fprintf_filtered (stream, ")");
927       elt = dump_subexp (exp, stream, elt + 2);
928       break;
929     case UNOP_MEMVAL_TLS:
930       fprintf_filtered (stream, "TLS type @");
931       gdb_print_host_address (exp->elts[elt + 1].type, stream);
932       fprintf_filtered (stream, " (__thread /* \"%s\" */ ",
933                         (exp->elts[elt].objfile == NULL ? "(null)"
934                          : objfile_name (exp->elts[elt].objfile)));
935       type_print (exp->elts[elt + 1].type, NULL, stream, 0);
936       fprintf_filtered (stream, ")");
937       elt = dump_subexp (exp, stream, elt + 3);
938       break;
939     case OP_TYPE:
940       fprintf_filtered (stream, "Type @");
941       gdb_print_host_address (exp->elts[elt].type, stream);
942       fprintf_filtered (stream, " (");
943       type_print (exp->elts[elt].type, NULL, stream, 0);
944       fprintf_filtered (stream, ")");
945       elt += 2;
946       break;
947     case OP_TYPEOF:
948     case OP_DECLTYPE:
949       fprintf_filtered (stream, "Typeof (");
950       elt = dump_subexp (exp, stream, elt);
951       fprintf_filtered (stream, ")");
952       break;
953     case OP_TYPEID:
954       fprintf_filtered (stream, "typeid (");
955       elt = dump_subexp (exp, stream, elt);
956       fprintf_filtered (stream, ")");
957       break;
958     case STRUCTOP_STRUCT:
959     case STRUCTOP_PTR:
960       {
961         char *elem_name;
962         int len;
963
964         len = longest_to_int (exp->elts[elt].longconst);
965         elem_name = &exp->elts[elt + 1].string;
966
967         fprintf_filtered (stream, "Element name: `%.*s'", len, elem_name);
968         elt = dump_subexp (exp, stream, elt + 3 + BYTES_TO_EXP_ELEM (len + 1));
969       }
970       break;
971     case OP_SCOPE:
972       {
973         char *elem_name;
974         int len;
975
976         fprintf_filtered (stream, "Type @");
977         gdb_print_host_address (exp->elts[elt].type, stream);
978         fprintf_filtered (stream, " (");
979         type_print (exp->elts[elt].type, NULL, stream, 0);
980         fprintf_filtered (stream, ") ");
981
982         len = longest_to_int (exp->elts[elt + 1].longconst);
983         elem_name = &exp->elts[elt + 2].string;
984
985         fprintf_filtered (stream, "Field name: `%.*s'", len, elem_name);
986         elt += 4 + BYTES_TO_EXP_ELEM (len + 1);
987       }
988       break;
989     case TYPE_INSTANCE:
990       {
991         LONGEST len;
992
993         len = exp->elts[elt++].longconst;
994         fprintf_filtered (stream, "%s TypeInstance: ", plongest (len));
995         while (len-- > 0)
996           {
997             fprintf_filtered (stream, "Type @");
998             gdb_print_host_address (exp->elts[elt].type, stream);
999             fprintf_filtered (stream, " (");
1000             type_print (exp->elts[elt].type, NULL, stream, 0);
1001             fprintf_filtered (stream, ")");
1002             elt++;
1003             if (len > 0)
1004               fputs_filtered (", ", stream);
1005           }
1006         /* Ending LEN and ending TYPE_INSTANCE.  */
1007         elt += 2;
1008         elt = dump_subexp (exp, stream, elt);
1009       }
1010       break;
1011     case OP_STRING:
1012       {
1013         LONGEST len = exp->elts[elt].longconst;
1014         LONGEST type = exp->elts[elt + 1].longconst;
1015
1016         fprintf_filtered (stream, "Language-specific string type: %s",
1017                           plongest (type));
1018
1019         /* Skip length.  */
1020         elt += 1;
1021
1022         /* Skip string content. */
1023         elt += BYTES_TO_EXP_ELEM (len);
1024
1025         /* Skip length and ending OP_STRING. */
1026         elt += 2;
1027       }
1028       break;
1029     default:
1030     case OP_NULL:
1031     case MULTI_SUBSCRIPT:
1032     case OP_F77_UNDETERMINED_ARGLIST:
1033     case OP_COMPLEX:
1034     case OP_BOOL:
1035     case OP_M2_STRING:
1036     case OP_THIS:
1037     case OP_NAME:
1038       fprintf_filtered (stream, "Unknown format");
1039     }
1040
1041   return elt;
1042 }
1043
1044 void
1045 dump_prefix_expression (struct expression *exp, struct ui_file *stream)
1046 {
1047   int elt;
1048
1049   fprintf_filtered (stream, "Dump of expression @ ");
1050   gdb_print_host_address (exp, stream);
1051   fputs_filtered (", after conversion to prefix form:\nExpression: `", stream);
1052   print_expression (exp, stream);
1053   fprintf_filtered (stream, "'\n\tLanguage %s, %d elements, %ld bytes each.\n",
1054                     exp->language_defn->la_name, exp->nelts,
1055                     (long) sizeof (union exp_element));
1056   fputs_filtered ("\n", stream);
1057
1058   for (elt = 0; elt < exp->nelts;)
1059     elt = dump_subexp (exp, stream, elt);
1060   fputs_filtered ("\n", stream);
1061 }