Include gdb_assert.h in common-defs.h
[platform/upstream/binutils.git] / gdb / parse.c
1 /* Parse expressions for GDB.
2
3    Copyright (C) 1986-2014 Free Software Foundation, Inc.
4
5    Modified from expread.y by the Department of Computer Science at the
6    State University of New York at Buffalo, 1991.
7
8    This file is part of GDB.
9
10    This program is free software; you can redistribute it and/or modify
11    it under the terms of the GNU General Public License as published by
12    the Free Software Foundation; either version 3 of the License, or
13    (at your option) any later version.
14
15    This program is distributed in the hope that it will be useful,
16    but WITHOUT ANY WARRANTY; without even the implied warranty of
17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18    GNU General Public License for more details.
19
20    You should have received a copy of the GNU General Public License
21    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
22
23 /* Parse an expression from text in a string,
24    and return the result as a struct expression pointer.
25    That structure contains arithmetic operations in reverse polish,
26    with constants represented by operations that are followed by special data.
27    See expression.h for the details of the format.
28    What is important here is that it can be built up sequentially
29    during the process of parsing; the lower levels of the tree always
30    come first in the result.  */
31
32 #include "defs.h"
33 #include <ctype.h>
34 #include "arch-utils.h"
35 #include <string.h>
36 #include "symtab.h"
37 #include "gdbtypes.h"
38 #include "frame.h"
39 #include "expression.h"
40 #include "value.h"
41 #include "command.h"
42 #include "language.h"
43 #include "f-lang.h"
44 #include "parser-defs.h"
45 #include "gdbcmd.h"
46 #include "symfile.h"            /* for overlay functions */
47 #include "inferior.h"
48 #include "doublest.h"
49 #include "block.h"
50 #include "source.h"
51 #include "objfiles.h"
52 #include "exceptions.h"
53 #include "user-regs.h"
54
55 /* Standard set of definitions for printing, dumping, prefixifying,
56  * and evaluating expressions.  */
57
58 const struct exp_descriptor exp_descriptor_standard = 
59   {
60     print_subexp_standard,
61     operator_length_standard,
62     operator_check_standard,
63     op_name_standard,
64     dump_subexp_body_standard,
65     evaluate_subexp_standard
66   };
67 \f
68 /* Global variables declared in parser-defs.h (and commented there).  */
69 const struct block *expression_context_block;
70 CORE_ADDR expression_context_pc;
71 const struct block *innermost_block;
72 int arglist_len;
73 static struct type_stack type_stack;
74 const char *lexptr;
75 const char *prev_lexptr;
76 int paren_depth;
77 int comma_terminates;
78
79 /* True if parsing an expression to attempt completion.  */
80 int parse_completion;
81
82 /* The index of the last struct expression directly before a '.' or
83    '->'.  This is set when parsing and is only used when completing a
84    field name.  It is -1 if no dereference operation was found.  */
85 static int expout_last_struct = -1;
86
87 /* If we are completing a tagged type name, this will be nonzero.  */
88 static enum type_code expout_tag_completion_type = TYPE_CODE_UNDEF;
89
90 /* The token for tagged type name completion.  */
91 static char *expout_completion_name;
92
93 \f
94 static unsigned int expressiondebug = 0;
95 static void
96 show_expressiondebug (struct ui_file *file, int from_tty,
97                       struct cmd_list_element *c, const char *value)
98 {
99   fprintf_filtered (file, _("Expression debugging is %s.\n"), value);
100 }
101
102
103 /* Non-zero if an expression parser should set yydebug.  */
104 int parser_debug;
105
106 static void
107 show_parserdebug (struct ui_file *file, int from_tty,
108                   struct cmd_list_element *c, const char *value)
109 {
110   fprintf_filtered (file, _("Parser debugging is %s.\n"), value);
111 }
112
113
114 static void free_funcalls (void *ignore);
115
116 static int prefixify_subexp (struct expression *, struct expression *, int,
117                              int);
118
119 static struct expression *parse_exp_in_context (const char **, CORE_ADDR,
120                                                 const struct block *, int, 
121                                                 int, int *);
122 static struct expression *parse_exp_in_context_1 (const char **, CORE_ADDR,
123                                                   const struct block *, int,
124                                                   int, int *);
125
126 void _initialize_parse (void);
127
128 /* Data structure for saving values of arglist_len for function calls whose
129    arguments contain other function calls.  */
130
131 struct funcall
132   {
133     struct funcall *next;
134     int arglist_len;
135   };
136
137 static struct funcall *funcall_chain;
138
139 /* Begin counting arguments for a function call,
140    saving the data about any containing call.  */
141
142 void
143 start_arglist (void)
144 {
145   struct funcall *new;
146
147   new = (struct funcall *) xmalloc (sizeof (struct funcall));
148   new->next = funcall_chain;
149   new->arglist_len = arglist_len;
150   arglist_len = 0;
151   funcall_chain = new;
152 }
153
154 /* Return the number of arguments in a function call just terminated,
155    and restore the data for the containing function call.  */
156
157 int
158 end_arglist (void)
159 {
160   int val = arglist_len;
161   struct funcall *call = funcall_chain;
162
163   funcall_chain = call->next;
164   arglist_len = call->arglist_len;
165   xfree (call);
166   return val;
167 }
168
169 /* Free everything in the funcall chain.
170    Used when there is an error inside parsing.  */
171
172 static void
173 free_funcalls (void *ignore)
174 {
175   struct funcall *call, *next;
176
177   for (call = funcall_chain; call; call = next)
178     {
179       next = call->next;
180       xfree (call);
181     }
182 }
183 \f
184
185 /* See definition in parser-defs.h.  */
186
187 void
188 initialize_expout (struct parser_state *ps, size_t initial_size,
189                    const struct language_defn *lang,
190                    struct gdbarch *gdbarch)
191 {
192   ps->expout_size = initial_size;
193   ps->expout_ptr = 0;
194   ps->expout = xmalloc (sizeof (struct expression)
195                         + EXP_ELEM_TO_BYTES (ps->expout_size));
196   ps->expout->language_defn = lang;
197   ps->expout->gdbarch = gdbarch;
198 }
199
200 /* See definition in parser-defs.h.  */
201
202 void
203 reallocate_expout (struct parser_state *ps)
204 {
205   /* Record the actual number of expression elements, and then
206      reallocate the expression memory so that we free up any
207      excess elements.  */
208
209   ps->expout->nelts = ps->expout_ptr;
210   ps->expout = (struct expression *)
211      xrealloc (ps->expout,
212                sizeof (struct expression)
213                + EXP_ELEM_TO_BYTES (ps->expout_ptr));
214 }
215
216 /* This page contains the functions for adding data to the struct expression
217    being constructed.  */
218
219 /* Add one element to the end of the expression.  */
220
221 /* To avoid a bug in the Sun 4 compiler, we pass things that can fit into
222    a register through here.  */
223
224 static void
225 write_exp_elt (struct parser_state *ps, const union exp_element *expelt)
226 {
227   if (ps->expout_ptr >= ps->expout_size)
228     {
229       ps->expout_size *= 2;
230       ps->expout = (struct expression *)
231         xrealloc (ps->expout, sizeof (struct expression)
232                   + EXP_ELEM_TO_BYTES (ps->expout_size));
233     }
234   ps->expout->elts[ps->expout_ptr++] = *expelt;
235 }
236
237 void
238 write_exp_elt_opcode (struct parser_state *ps, enum exp_opcode expelt)
239 {
240   union exp_element tmp;
241
242   memset (&tmp, 0, sizeof (union exp_element));
243   tmp.opcode = expelt;
244   write_exp_elt (ps, &tmp);
245 }
246
247 void
248 write_exp_elt_sym (struct parser_state *ps, struct symbol *expelt)
249 {
250   union exp_element tmp;
251
252   memset (&tmp, 0, sizeof (union exp_element));
253   tmp.symbol = expelt;
254   write_exp_elt (ps, &tmp);
255 }
256
257 void
258 write_exp_elt_block (struct parser_state *ps, const struct block *b)
259 {
260   union exp_element tmp;
261
262   memset (&tmp, 0, sizeof (union exp_element));
263   tmp.block = b;
264   write_exp_elt (ps, &tmp);
265 }
266
267 void
268 write_exp_elt_objfile (struct parser_state *ps, struct objfile *objfile)
269 {
270   union exp_element tmp;
271
272   memset (&tmp, 0, sizeof (union exp_element));
273   tmp.objfile = objfile;
274   write_exp_elt (ps, &tmp);
275 }
276
277 void
278 write_exp_elt_longcst (struct parser_state *ps, LONGEST expelt)
279 {
280   union exp_element tmp;
281
282   memset (&tmp, 0, sizeof (union exp_element));
283   tmp.longconst = expelt;
284   write_exp_elt (ps, &tmp);
285 }
286
287 void
288 write_exp_elt_dblcst (struct parser_state *ps, DOUBLEST expelt)
289 {
290   union exp_element tmp;
291
292   memset (&tmp, 0, sizeof (union exp_element));
293   tmp.doubleconst = expelt;
294   write_exp_elt (ps, &tmp);
295 }
296
297 void
298 write_exp_elt_decfloatcst (struct parser_state *ps, gdb_byte expelt[16])
299 {
300   union exp_element tmp;
301   int index;
302
303   for (index = 0; index < 16; index++)
304     tmp.decfloatconst[index] = expelt[index];
305
306   write_exp_elt (ps, &tmp);
307 }
308
309 void
310 write_exp_elt_type (struct parser_state *ps, struct type *expelt)
311 {
312   union exp_element tmp;
313
314   memset (&tmp, 0, sizeof (union exp_element));
315   tmp.type = expelt;
316   write_exp_elt (ps, &tmp);
317 }
318
319 void
320 write_exp_elt_intern (struct parser_state *ps, struct internalvar *expelt)
321 {
322   union exp_element tmp;
323
324   memset (&tmp, 0, sizeof (union exp_element));
325   tmp.internalvar = expelt;
326   write_exp_elt (ps, &tmp);
327 }
328
329 /* Add a string constant to the end of the expression.
330
331    String constants are stored by first writing an expression element
332    that contains the length of the string, then stuffing the string
333    constant itself into however many expression elements are needed
334    to hold it, and then writing another expression element that contains
335    the length of the string.  I.e. an expression element at each end of
336    the string records the string length, so you can skip over the 
337    expression elements containing the actual string bytes from either
338    end of the string.  Note that this also allows gdb to handle
339    strings with embedded null bytes, as is required for some languages.
340
341    Don't be fooled by the fact that the string is null byte terminated,
342    this is strictly for the convenience of debugging gdb itself.
343    Gdb does not depend up the string being null terminated, since the
344    actual length is recorded in expression elements at each end of the
345    string.  The null byte is taken into consideration when computing how
346    many expression elements are required to hold the string constant, of
347    course.  */
348
349
350 void
351 write_exp_string (struct parser_state *ps, struct stoken str)
352 {
353   int len = str.length;
354   size_t lenelt;
355   char *strdata;
356
357   /* Compute the number of expression elements required to hold the string
358      (including a null byte terminator), along with one expression element
359      at each end to record the actual string length (not including the
360      null byte terminator).  */
361
362   lenelt = 2 + BYTES_TO_EXP_ELEM (len + 1);
363
364   increase_expout_size (ps, lenelt);
365
366   /* Write the leading length expression element (which advances the current
367      expression element index), then write the string constant followed by a
368      terminating null byte, and then write the trailing length expression
369      element.  */
370
371   write_exp_elt_longcst (ps, (LONGEST) len);
372   strdata = (char *) &ps->expout->elts[ps->expout_ptr];
373   memcpy (strdata, str.ptr, len);
374   *(strdata + len) = '\0';
375   ps->expout_ptr += lenelt - 2;
376   write_exp_elt_longcst (ps, (LONGEST) len);
377 }
378
379 /* Add a vector of string constants to the end of the expression.
380
381    This adds an OP_STRING operation, but encodes the contents
382    differently from write_exp_string.  The language is expected to
383    handle evaluation of this expression itself.
384    
385    After the usual OP_STRING header, TYPE is written into the
386    expression as a long constant.  The interpretation of this field is
387    up to the language evaluator.
388    
389    Next, each string in VEC is written.  The length is written as a
390    long constant, followed by the contents of the string.  */
391
392 void
393 write_exp_string_vector (struct parser_state *ps, int type,
394                          struct stoken_vector *vec)
395 {
396   int i, len;
397   size_t n_slots;
398
399   /* Compute the size.  We compute the size in number of slots to
400      avoid issues with string padding.  */
401   n_slots = 0;
402   for (i = 0; i < vec->len; ++i)
403     {
404       /* One slot for the length of this element, plus the number of
405          slots needed for this string.  */
406       n_slots += 1 + BYTES_TO_EXP_ELEM (vec->tokens[i].length);
407     }
408
409   /* One more slot for the type of the string.  */
410   ++n_slots;
411
412   /* Now compute a phony string length.  */
413   len = EXP_ELEM_TO_BYTES (n_slots) - 1;
414
415   n_slots += 4;
416   increase_expout_size (ps, n_slots);
417
418   write_exp_elt_opcode (ps, OP_STRING);
419   write_exp_elt_longcst (ps, len);
420   write_exp_elt_longcst (ps, type);
421
422   for (i = 0; i < vec->len; ++i)
423     {
424       write_exp_elt_longcst (ps, vec->tokens[i].length);
425       memcpy (&ps->expout->elts[ps->expout_ptr], vec->tokens[i].ptr,
426               vec->tokens[i].length);
427       ps->expout_ptr += BYTES_TO_EXP_ELEM (vec->tokens[i].length);
428     }
429
430   write_exp_elt_longcst (ps, len);
431   write_exp_elt_opcode (ps, OP_STRING);
432 }
433
434 /* Add a bitstring constant to the end of the expression.
435
436    Bitstring constants are stored by first writing an expression element
437    that contains the length of the bitstring (in bits), then stuffing the
438    bitstring constant itself into however many expression elements are
439    needed to hold it, and then writing another expression element that
440    contains the length of the bitstring.  I.e. an expression element at
441    each end of the bitstring records the bitstring length, so you can skip
442    over the expression elements containing the actual bitstring bytes from
443    either end of the bitstring.  */
444
445 void
446 write_exp_bitstring (struct parser_state *ps, struct stoken str)
447 {
448   int bits = str.length;        /* length in bits */
449   int len = (bits + HOST_CHAR_BIT - 1) / HOST_CHAR_BIT;
450   size_t lenelt;
451   char *strdata;
452
453   /* Compute the number of expression elements required to hold the bitstring,
454      along with one expression element at each end to record the actual
455      bitstring length in bits.  */
456
457   lenelt = 2 + BYTES_TO_EXP_ELEM (len);
458
459   increase_expout_size (ps, lenelt);
460
461   /* Write the leading length expression element (which advances the current
462      expression element index), then write the bitstring constant, and then
463      write the trailing length expression element.  */
464
465   write_exp_elt_longcst (ps, (LONGEST) bits);
466   strdata = (char *) &ps->expout->elts[ps->expout_ptr];
467   memcpy (strdata, str.ptr, len);
468   ps->expout_ptr += lenelt - 2;
469   write_exp_elt_longcst (ps, (LONGEST) bits);
470 }
471
472 /* Add the appropriate elements for a minimal symbol to the end of
473    the expression.  */
474
475 void
476 write_exp_msymbol (struct parser_state *ps,
477                    struct bound_minimal_symbol bound_msym)
478 {
479   struct minimal_symbol *msymbol = bound_msym.minsym;
480   struct objfile *objfile = bound_msym.objfile;
481   struct gdbarch *gdbarch = get_objfile_arch (objfile);
482
483   CORE_ADDR addr = BMSYMBOL_VALUE_ADDRESS (bound_msym);
484   struct obj_section *section = MSYMBOL_OBJ_SECTION (objfile, msymbol);
485   enum minimal_symbol_type type = MSYMBOL_TYPE (msymbol);
486   CORE_ADDR pc;
487
488   /* The minimal symbol might point to a function descriptor;
489      resolve it to the actual code address instead.  */
490   pc = gdbarch_convert_from_func_ptr_addr (gdbarch, addr, &current_target);
491   if (pc != addr)
492     {
493       struct bound_minimal_symbol ifunc_msym = lookup_minimal_symbol_by_pc (pc);
494
495       /* In this case, assume we have a code symbol instead of
496          a data symbol.  */
497
498       if (ifunc_msym.minsym != NULL
499           && MSYMBOL_TYPE (ifunc_msym.minsym) == mst_text_gnu_ifunc
500           && BMSYMBOL_VALUE_ADDRESS (ifunc_msym) == pc)
501         {
502           /* A function descriptor has been resolved but PC is still in the
503              STT_GNU_IFUNC resolver body (such as because inferior does not
504              run to be able to call it).  */
505
506           type = mst_text_gnu_ifunc;
507         }
508       else
509         type = mst_text;
510       section = NULL;
511       addr = pc;
512     }
513
514   if (overlay_debugging)
515     addr = symbol_overlayed_address (addr, section);
516
517   write_exp_elt_opcode (ps, OP_LONG);
518   /* Let's make the type big enough to hold a 64-bit address.  */
519   write_exp_elt_type (ps, objfile_type (objfile)->builtin_core_addr);
520   write_exp_elt_longcst (ps, (LONGEST) addr);
521   write_exp_elt_opcode (ps, OP_LONG);
522
523   if (section && section->the_bfd_section->flags & SEC_THREAD_LOCAL)
524     {
525       write_exp_elt_opcode (ps, UNOP_MEMVAL_TLS);
526       write_exp_elt_objfile (ps, objfile);
527       write_exp_elt_type (ps, objfile_type (objfile)->nodebug_tls_symbol);
528       write_exp_elt_opcode (ps, UNOP_MEMVAL_TLS);
529       return;
530     }
531
532   write_exp_elt_opcode (ps, UNOP_MEMVAL);
533   switch (type)
534     {
535     case mst_text:
536     case mst_file_text:
537     case mst_solib_trampoline:
538       write_exp_elt_type (ps, objfile_type (objfile)->nodebug_text_symbol);
539       break;
540
541     case mst_text_gnu_ifunc:
542       write_exp_elt_type (ps, objfile_type (objfile)
543                           ->nodebug_text_gnu_ifunc_symbol);
544       break;
545
546     case mst_data:
547     case mst_file_data:
548     case mst_bss:
549     case mst_file_bss:
550       write_exp_elt_type (ps, objfile_type (objfile)->nodebug_data_symbol);
551       break;
552
553     case mst_slot_got_plt:
554       write_exp_elt_type (ps, objfile_type (objfile)->nodebug_got_plt_symbol);
555       break;
556
557     default:
558       write_exp_elt_type (ps, objfile_type (objfile)->nodebug_unknown_symbol);
559       break;
560     }
561   write_exp_elt_opcode (ps, UNOP_MEMVAL);
562 }
563
564 /* Mark the current index as the starting location of a structure
565    expression.  This is used when completing on field names.  */
566
567 void
568 mark_struct_expression (struct parser_state *ps)
569 {
570   gdb_assert (parse_completion
571               && expout_tag_completion_type == TYPE_CODE_UNDEF);
572   expout_last_struct = ps->expout_ptr;
573 }
574
575 /* Indicate that the current parser invocation is completing a tag.
576    TAG is the type code of the tag, and PTR and LENGTH represent the
577    start of the tag name.  */
578
579 void
580 mark_completion_tag (enum type_code tag, const char *ptr, int length)
581 {
582   gdb_assert (parse_completion
583               && expout_tag_completion_type == TYPE_CODE_UNDEF
584               && expout_completion_name == NULL
585               && expout_last_struct == -1);
586   gdb_assert (tag == TYPE_CODE_UNION
587               || tag == TYPE_CODE_STRUCT
588               || tag == TYPE_CODE_CLASS
589               || tag == TYPE_CODE_ENUM);
590   expout_tag_completion_type = tag;
591   expout_completion_name = xmalloc (length + 1);
592   memcpy (expout_completion_name, ptr, length);
593   expout_completion_name[length] = '\0';
594 }
595
596 \f
597 /* Recognize tokens that start with '$'.  These include:
598
599    $regname     A native register name or a "standard
600    register name".
601
602    $variable    A convenience variable with a name chosen
603    by the user.
604
605    $digits              Value history with index <digits>, starting
606    from the first value which has index 1.
607
608    $$digits     Value history with index <digits> relative
609    to the last value.  I.e. $$0 is the last
610    value, $$1 is the one previous to that, $$2
611    is the one previous to $$1, etc.
612
613    $ | $0 | $$0 The last value in the value history.
614
615    $$           An abbreviation for the second to the last
616    value in the value history, I.e. $$1  */
617
618 void
619 write_dollar_variable (struct parser_state *ps, struct stoken str)
620 {
621   struct symbol *sym = NULL;
622   struct bound_minimal_symbol msym;
623   struct internalvar *isym = NULL;
624
625   /* Handle the tokens $digits; also $ (short for $0) and $$ (short for $$1)
626      and $$digits (equivalent to $<-digits> if you could type that).  */
627
628   int negate = 0;
629   int i = 1;
630   /* Double dollar means negate the number and add -1 as well.
631      Thus $$ alone means -1.  */
632   if (str.length >= 2 && str.ptr[1] == '$')
633     {
634       negate = 1;
635       i = 2;
636     }
637   if (i == str.length)
638     {
639       /* Just dollars (one or two).  */
640       i = -negate;
641       goto handle_last;
642     }
643   /* Is the rest of the token digits?  */
644   for (; i < str.length; i++)
645     if (!(str.ptr[i] >= '0' && str.ptr[i] <= '9'))
646       break;
647   if (i == str.length)
648     {
649       i = atoi (str.ptr + 1 + negate);
650       if (negate)
651         i = -i;
652       goto handle_last;
653     }
654
655   /* Handle tokens that refer to machine registers:
656      $ followed by a register name.  */
657   i = user_reg_map_name_to_regnum (parse_gdbarch (ps),
658                                    str.ptr + 1, str.length - 1);
659   if (i >= 0)
660     goto handle_register;
661
662   /* Any names starting with $ are probably debugger internal variables.  */
663
664   isym = lookup_only_internalvar (copy_name (str) + 1);
665   if (isym)
666     {
667       write_exp_elt_opcode (ps, OP_INTERNALVAR);
668       write_exp_elt_intern (ps, isym);
669       write_exp_elt_opcode (ps, OP_INTERNALVAR);
670       return;
671     }
672
673   /* On some systems, such as HP-UX and hppa-linux, certain system routines 
674      have names beginning with $ or $$.  Check for those, first.  */
675
676   sym = lookup_symbol (copy_name (str), (struct block *) NULL,
677                        VAR_DOMAIN, NULL);
678   if (sym)
679     {
680       write_exp_elt_opcode (ps, OP_VAR_VALUE);
681       write_exp_elt_block (ps, block_found);    /* set by lookup_symbol */
682       write_exp_elt_sym (ps, sym);
683       write_exp_elt_opcode (ps, OP_VAR_VALUE);
684       return;
685     }
686   msym = lookup_bound_minimal_symbol (copy_name (str));
687   if (msym.minsym)
688     {
689       write_exp_msymbol (ps, msym);
690       return;
691     }
692
693   /* Any other names are assumed to be debugger internal variables.  */
694
695   write_exp_elt_opcode (ps, OP_INTERNALVAR);
696   write_exp_elt_intern (ps, create_internalvar (copy_name (str) + 1));
697   write_exp_elt_opcode (ps, OP_INTERNALVAR);
698   return;
699 handle_last:
700   write_exp_elt_opcode (ps, OP_LAST);
701   write_exp_elt_longcst (ps, (LONGEST) i);
702   write_exp_elt_opcode (ps, OP_LAST);
703   return;
704 handle_register:
705   write_exp_elt_opcode (ps, OP_REGISTER);
706   str.length--;
707   str.ptr++;
708   write_exp_string (ps, str);
709   write_exp_elt_opcode (ps, OP_REGISTER);
710   return;
711 }
712
713
714 const char *
715 find_template_name_end (const char *p)
716 {
717   int depth = 1;
718   int just_seen_right = 0;
719   int just_seen_colon = 0;
720   int just_seen_space = 0;
721
722   if (!p || (*p != '<'))
723     return 0;
724
725   while (*++p)
726     {
727       switch (*p)
728         {
729         case '\'':
730         case '\"':
731         case '{':
732         case '}':
733           /* In future, may want to allow these??  */
734           return 0;
735         case '<':
736           depth++;              /* start nested template */
737           if (just_seen_colon || just_seen_right || just_seen_space)
738             return 0;           /* but not after : or :: or > or space */
739           break;
740         case '>':
741           if (just_seen_colon || just_seen_right)
742             return 0;           /* end a (nested?) template */
743           just_seen_right = 1;  /* but not after : or :: */
744           if (--depth == 0)     /* also disallow >>, insist on > > */
745             return ++p;         /* if outermost ended, return */
746           break;
747         case ':':
748           if (just_seen_space || (just_seen_colon > 1))
749             return 0;           /* nested class spec coming up */
750           just_seen_colon++;    /* we allow :: but not :::: */
751           break;
752         case ' ':
753           break;
754         default:
755           if (!((*p >= 'a' && *p <= 'z') ||     /* allow token chars */
756                 (*p >= 'A' && *p <= 'Z') ||
757                 (*p >= '0' && *p <= '9') ||
758                 (*p == '_') || (*p == ',') ||   /* commas for template args */
759                 (*p == '&') || (*p == '*') ||   /* pointer and ref types */
760                 (*p == '(') || (*p == ')') ||   /* function types */
761                 (*p == '[') || (*p == ']')))    /* array types */
762             return 0;
763         }
764       if (*p != ' ')
765         just_seen_space = 0;
766       if (*p != ':')
767         just_seen_colon = 0;
768       if (*p != '>')
769         just_seen_right = 0;
770     }
771   return 0;
772 }
773 \f
774
775 /* Return a null-terminated temporary copy of the name of a string token.
776
777    Tokens that refer to names do so with explicit pointer and length,
778    so they can share the storage that lexptr is parsing.
779    When it is necessary to pass a name to a function that expects
780    a null-terminated string, the substring is copied out
781    into a separate block of storage.
782
783    N.B. A single buffer is reused on each call.  */
784
785 char *
786 copy_name (struct stoken token)
787 {
788   /* A temporary buffer for identifiers, so we can null-terminate them.
789      We allocate this with xrealloc.  parse_exp_1 used to allocate with
790      alloca, using the size of the whole expression as a conservative
791      estimate of the space needed.  However, macro expansion can
792      introduce names longer than the original expression; there's no
793      practical way to know beforehand how large that might be.  */
794   static char *namecopy;
795   static size_t namecopy_size;
796
797   /* Make sure there's enough space for the token.  */
798   if (namecopy_size < token.length + 1)
799     {
800       namecopy_size = token.length + 1;
801       namecopy = xrealloc (namecopy, token.length + 1);
802     }
803       
804   memcpy (namecopy, token.ptr, token.length);
805   namecopy[token.length] = 0;
806
807   return namecopy;
808 }
809 \f
810
811 /* See comments on parser-defs.h.  */
812
813 int
814 prefixify_expression (struct expression *expr)
815 {
816   int len = sizeof (struct expression) + EXP_ELEM_TO_BYTES (expr->nelts);
817   struct expression *temp;
818   int inpos = expr->nelts, outpos = 0;
819
820   temp = (struct expression *) alloca (len);
821
822   /* Copy the original expression into temp.  */
823   memcpy (temp, expr, len);
824
825   return prefixify_subexp (temp, expr, inpos, outpos);
826 }
827
828 /* Return the number of exp_elements in the postfix subexpression 
829    of EXPR whose operator is at index ENDPOS - 1 in EXPR.  */
830
831 int
832 length_of_subexp (struct expression *expr, int endpos)
833 {
834   int oplen, args;
835
836   operator_length (expr, endpos, &oplen, &args);
837
838   while (args > 0)
839     {
840       oplen += length_of_subexp (expr, endpos - oplen);
841       args--;
842     }
843
844   return oplen;
845 }
846
847 /* Sets *OPLENP to the length of the operator whose (last) index is 
848    ENDPOS - 1 in EXPR, and sets *ARGSP to the number of arguments that
849    operator takes.  */
850
851 void
852 operator_length (const struct expression *expr, int endpos, int *oplenp,
853                  int *argsp)
854 {
855   expr->language_defn->la_exp_desc->operator_length (expr, endpos,
856                                                      oplenp, argsp);
857 }
858
859 /* Default value for operator_length in exp_descriptor vectors.  */
860
861 void
862 operator_length_standard (const struct expression *expr, int endpos,
863                           int *oplenp, int *argsp)
864 {
865   int oplen = 1;
866   int args = 0;
867   enum f90_range_type range_type;
868   int i;
869
870   if (endpos < 1)
871     error (_("?error in operator_length_standard"));
872
873   i = (int) expr->elts[endpos - 1].opcode;
874
875   switch (i)
876     {
877       /* C++  */
878     case OP_SCOPE:
879       oplen = longest_to_int (expr->elts[endpos - 2].longconst);
880       oplen = 5 + BYTES_TO_EXP_ELEM (oplen + 1);
881       break;
882
883     case OP_LONG:
884     case OP_DOUBLE:
885     case OP_DECFLOAT:
886     case OP_VAR_VALUE:
887       oplen = 4;
888       break;
889
890     case OP_TYPE:
891     case OP_BOOL:
892     case OP_LAST:
893     case OP_INTERNALVAR:
894     case OP_VAR_ENTRY_VALUE:
895       oplen = 3;
896       break;
897
898     case OP_COMPLEX:
899       oplen = 3;
900       args = 2;
901       break;
902
903     case OP_FUNCALL:
904     case OP_F77_UNDETERMINED_ARGLIST:
905       oplen = 3;
906       args = 1 + longest_to_int (expr->elts[endpos - 2].longconst);
907       break;
908
909     case TYPE_INSTANCE:
910       oplen = 4 + longest_to_int (expr->elts[endpos - 2].longconst);
911       args = 1;
912       break;
913
914     case OP_OBJC_MSGCALL:       /* Objective C message (method) call.  */
915       oplen = 4;
916       args = 1 + longest_to_int (expr->elts[endpos - 2].longconst);
917       break;
918
919     case UNOP_MAX:
920     case UNOP_MIN:
921       oplen = 3;
922       break;
923
924     case UNOP_CAST_TYPE:
925     case UNOP_DYNAMIC_CAST:
926     case UNOP_REINTERPRET_CAST:
927     case UNOP_MEMVAL_TYPE:
928       oplen = 1;
929       args = 2;
930       break;
931
932     case BINOP_VAL:
933     case UNOP_CAST:
934     case UNOP_MEMVAL:
935       oplen = 3;
936       args = 1;
937       break;
938
939     case UNOP_MEMVAL_TLS:
940       oplen = 4;
941       args = 1;
942       break;
943
944     case UNOP_ABS:
945     case UNOP_CAP:
946     case UNOP_CHR:
947     case UNOP_FLOAT:
948     case UNOP_HIGH:
949     case UNOP_ODD:
950     case UNOP_ORD:
951     case UNOP_TRUNC:
952     case OP_TYPEOF:
953     case OP_DECLTYPE:
954     case OP_TYPEID:
955       oplen = 1;
956       args = 1;
957       break;
958
959     case OP_ADL_FUNC:
960       oplen = longest_to_int (expr->elts[endpos - 2].longconst);
961       oplen = 4 + BYTES_TO_EXP_ELEM (oplen + 1);
962       oplen++;
963       oplen++;
964       break;
965
966     case STRUCTOP_STRUCT:
967     case STRUCTOP_PTR:
968       args = 1;
969       /* fall through */
970     case OP_REGISTER:
971     case OP_M2_STRING:
972     case OP_STRING:
973     case OP_OBJC_NSSTRING:      /* Objective C Foundation Class
974                                    NSString constant.  */
975     case OP_OBJC_SELECTOR:      /* Objective C "@selector" pseudo-op.  */
976     case OP_NAME:
977       oplen = longest_to_int (expr->elts[endpos - 2].longconst);
978       oplen = 4 + BYTES_TO_EXP_ELEM (oplen + 1);
979       break;
980
981     case OP_ARRAY:
982       oplen = 4;
983       args = longest_to_int (expr->elts[endpos - 2].longconst);
984       args -= longest_to_int (expr->elts[endpos - 3].longconst);
985       args += 1;
986       break;
987
988     case TERNOP_COND:
989     case TERNOP_SLICE:
990       args = 3;
991       break;
992
993       /* Modula-2 */
994     case MULTI_SUBSCRIPT:
995       oplen = 3;
996       args = 1 + longest_to_int (expr->elts[endpos - 2].longconst);
997       break;
998
999     case BINOP_ASSIGN_MODIFY:
1000       oplen = 3;
1001       args = 2;
1002       break;
1003
1004       /* C++ */
1005     case OP_THIS:
1006       oplen = 2;
1007       break;
1008
1009     case OP_F90_RANGE:
1010       oplen = 3;
1011
1012       range_type = longest_to_int (expr->elts[endpos - 2].longconst);
1013       switch (range_type)
1014         {
1015         case LOW_BOUND_DEFAULT:
1016         case HIGH_BOUND_DEFAULT:
1017           args = 1;
1018           break;
1019         case BOTH_BOUND_DEFAULT:
1020           args = 0;
1021           break;
1022         case NONE_BOUND_DEFAULT:
1023           args = 2;
1024           break;
1025         }
1026
1027       break;
1028
1029     default:
1030       args = 1 + (i < (int) BINOP_END);
1031     }
1032
1033   *oplenp = oplen;
1034   *argsp = args;
1035 }
1036
1037 /* Copy the subexpression ending just before index INEND in INEXPR
1038    into OUTEXPR, starting at index OUTBEG.
1039    In the process, convert it from suffix to prefix form.
1040    If EXPOUT_LAST_STRUCT is -1, then this function always returns -1.
1041    Otherwise, it returns the index of the subexpression which is the
1042    left-hand-side of the expression at EXPOUT_LAST_STRUCT.  */
1043
1044 static int
1045 prefixify_subexp (struct expression *inexpr,
1046                   struct expression *outexpr, int inend, int outbeg)
1047 {
1048   int oplen;
1049   int args;
1050   int i;
1051   int *arglens;
1052   int result = -1;
1053
1054   operator_length (inexpr, inend, &oplen, &args);
1055
1056   /* Copy the final operator itself, from the end of the input
1057      to the beginning of the output.  */
1058   inend -= oplen;
1059   memcpy (&outexpr->elts[outbeg], &inexpr->elts[inend],
1060           EXP_ELEM_TO_BYTES (oplen));
1061   outbeg += oplen;
1062
1063   if (expout_last_struct == inend)
1064     result = outbeg - oplen;
1065
1066   /* Find the lengths of the arg subexpressions.  */
1067   arglens = (int *) alloca (args * sizeof (int));
1068   for (i = args - 1; i >= 0; i--)
1069     {
1070       oplen = length_of_subexp (inexpr, inend);
1071       arglens[i] = oplen;
1072       inend -= oplen;
1073     }
1074
1075   /* Now copy each subexpression, preserving the order of
1076      the subexpressions, but prefixifying each one.
1077      In this loop, inend starts at the beginning of
1078      the expression this level is working on
1079      and marches forward over the arguments.
1080      outbeg does similarly in the output.  */
1081   for (i = 0; i < args; i++)
1082     {
1083       int r;
1084
1085       oplen = arglens[i];
1086       inend += oplen;
1087       r = prefixify_subexp (inexpr, outexpr, inend, outbeg);
1088       if (r != -1)
1089         {
1090           /* Return immediately.  We probably have only parsed a
1091              partial expression, so we don't want to try to reverse
1092              the other operands.  */
1093           return r;
1094         }
1095       outbeg += oplen;
1096     }
1097
1098   return result;
1099 }
1100 \f
1101 /* Read an expression from the string *STRINGPTR points to,
1102    parse it, and return a pointer to a struct expression that we malloc.
1103    Use block BLOCK as the lexical context for variable names;
1104    if BLOCK is zero, use the block of the selected stack frame.
1105    Meanwhile, advance *STRINGPTR to point after the expression,
1106    at the first nonwhite character that is not part of the expression
1107    (possibly a null character).
1108
1109    If COMMA is nonzero, stop if a comma is reached.  */
1110
1111 struct expression *
1112 parse_exp_1 (const char **stringptr, CORE_ADDR pc, const struct block *block,
1113              int comma)
1114 {
1115   return parse_exp_in_context (stringptr, pc, block, comma, 0, NULL);
1116 }
1117
1118 static struct expression *
1119 parse_exp_in_context (const char **stringptr, CORE_ADDR pc,
1120                       const struct block *block,
1121                       int comma, int void_context_p, int *out_subexp)
1122 {
1123   return parse_exp_in_context_1 (stringptr, pc, block, comma,
1124                                  void_context_p, out_subexp);
1125 }
1126
1127 /* As for parse_exp_1, except that if VOID_CONTEXT_P, then
1128    no value is expected from the expression.
1129    OUT_SUBEXP is set when attempting to complete a field name; in this
1130    case it is set to the index of the subexpression on the
1131    left-hand-side of the struct op.  If not doing such completion, it
1132    is left untouched.  */
1133
1134 static struct expression *
1135 parse_exp_in_context_1 (const char **stringptr, CORE_ADDR pc,
1136                         const struct block *block,
1137                         int comma, int void_context_p, int *out_subexp)
1138 {
1139   volatile struct gdb_exception except;
1140   struct cleanup *old_chain, *inner_chain;
1141   const struct language_defn *lang = NULL;
1142   struct parser_state ps;
1143   int subexp;
1144
1145   lexptr = *stringptr;
1146   prev_lexptr = NULL;
1147
1148   paren_depth = 0;
1149   type_stack.depth = 0;
1150   expout_last_struct = -1;
1151   expout_tag_completion_type = TYPE_CODE_UNDEF;
1152   xfree (expout_completion_name);
1153   expout_completion_name = NULL;
1154
1155   comma_terminates = comma;
1156
1157   if (lexptr == 0 || *lexptr == 0)
1158     error_no_arg (_("expression to compute"));
1159
1160   old_chain = make_cleanup (free_funcalls, 0 /*ignore*/);
1161   funcall_chain = 0;
1162
1163   expression_context_block = block;
1164
1165   /* If no context specified, try using the current frame, if any.  */
1166   if (!expression_context_block)
1167     expression_context_block = get_selected_block (&expression_context_pc);
1168   else if (pc == 0)
1169     expression_context_pc = BLOCK_START (expression_context_block);
1170   else
1171     expression_context_pc = pc;
1172
1173   /* Fall back to using the current source static context, if any.  */
1174
1175   if (!expression_context_block)
1176     {
1177       struct symtab_and_line cursal = get_current_source_symtab_and_line ();
1178       if (cursal.symtab)
1179         expression_context_block
1180           = BLOCKVECTOR_BLOCK (BLOCKVECTOR (cursal.symtab), STATIC_BLOCK);
1181       if (expression_context_block)
1182         expression_context_pc = BLOCK_START (expression_context_block);
1183     }
1184
1185   if (language_mode == language_mode_auto && block != NULL)
1186     {
1187       /* Find the language associated to the given context block.
1188          Default to the current language if it can not be determined.
1189
1190          Note that using the language corresponding to the current frame
1191          can sometimes give unexpected results.  For instance, this
1192          routine is often called several times during the inferior
1193          startup phase to re-parse breakpoint expressions after
1194          a new shared library has been loaded.  The language associated
1195          to the current frame at this moment is not relevant for
1196          the breakpoint.  Using it would therefore be silly, so it seems
1197          better to rely on the current language rather than relying on
1198          the current frame language to parse the expression.  That's why
1199          we do the following language detection only if the context block
1200          has been specifically provided.  */
1201       struct symbol *func = block_linkage_function (block);
1202
1203       if (func != NULL)
1204         lang = language_def (SYMBOL_LANGUAGE (func));
1205       if (lang == NULL || lang->la_language == language_unknown)
1206         lang = current_language;
1207     }
1208   else
1209     lang = current_language;
1210
1211   /* get_current_arch may reset CURRENT_LANGUAGE via select_frame.
1212      While we need CURRENT_LANGUAGE to be set to LANG (for lookup_symbol
1213      and others called from *.y) ensure CURRENT_LANGUAGE gets restored
1214      to the value matching SELECTED_FRAME as set by get_current_arch.  */
1215
1216   initialize_expout (&ps, 10, lang, get_current_arch ());
1217   inner_chain = make_cleanup_restore_current_language ();
1218   set_language (lang->la_language);
1219
1220   TRY_CATCH (except, RETURN_MASK_ALL)
1221     {
1222       if (lang->la_parser (&ps))
1223         lang->la_error (NULL);
1224     }
1225   if (except.reason < 0)
1226     {
1227       if (! parse_completion)
1228         {
1229           xfree (ps.expout);
1230           throw_exception (except);
1231         }
1232     }
1233
1234   reallocate_expout (&ps);
1235
1236   /* Convert expression from postfix form as generated by yacc
1237      parser, to a prefix form.  */
1238
1239   if (expressiondebug)
1240     dump_raw_expression (ps.expout, gdb_stdlog,
1241                          "before conversion to prefix form");
1242
1243   subexp = prefixify_expression (ps.expout);
1244   if (out_subexp)
1245     *out_subexp = subexp;
1246
1247   lang->la_post_parser (&ps.expout, void_context_p);
1248
1249   if (expressiondebug)
1250     dump_prefix_expression (ps.expout, gdb_stdlog);
1251
1252   do_cleanups (inner_chain);
1253   discard_cleanups (old_chain);
1254
1255   *stringptr = lexptr;
1256   return ps.expout;
1257 }
1258
1259 /* Parse STRING as an expression, and complain if this fails
1260    to use up all of the contents of STRING.  */
1261
1262 struct expression *
1263 parse_expression (const char *string)
1264 {
1265   struct expression *exp;
1266
1267   exp = parse_exp_1 (&string, 0, 0, 0);
1268   if (*string)
1269     error (_("Junk after end of expression."));
1270   return exp;
1271 }
1272
1273 /* Parse STRING as an expression.  If parsing ends in the middle of a
1274    field reference, return the type of the left-hand-side of the
1275    reference; furthermore, if the parsing ends in the field name,
1276    return the field name in *NAME.  If the parsing ends in the middle
1277    of a field reference, but the reference is somehow invalid, throw
1278    an exception.  In all other cases, return NULL.  Returned non-NULL
1279    *NAME must be freed by the caller.  */
1280
1281 struct type *
1282 parse_expression_for_completion (const char *string, char **name,
1283                                  enum type_code *code)
1284 {
1285   struct expression *exp = NULL;
1286   struct value *val;
1287   int subexp;
1288   volatile struct gdb_exception except;
1289
1290   TRY_CATCH (except, RETURN_MASK_ERROR)
1291     {
1292       parse_completion = 1;
1293       exp = parse_exp_in_context (&string, 0, 0, 0, 0, &subexp);
1294     }
1295   parse_completion = 0;
1296   if (except.reason < 0 || ! exp)
1297     return NULL;
1298
1299   if (expout_tag_completion_type != TYPE_CODE_UNDEF)
1300     {
1301       *code = expout_tag_completion_type;
1302       *name = expout_completion_name;
1303       expout_completion_name = NULL;
1304       return NULL;
1305     }
1306
1307   if (expout_last_struct == -1)
1308     {
1309       xfree (exp);
1310       return NULL;
1311     }
1312
1313   *name = extract_field_op (exp, &subexp);
1314   if (!*name)
1315     {
1316       xfree (exp);
1317       return NULL;
1318     }
1319
1320   /* This might throw an exception.  If so, we want to let it
1321      propagate.  */
1322   val = evaluate_subexpression_type (exp, subexp);
1323   /* (*NAME) is a part of the EXP memory block freed below.  */
1324   *name = xstrdup (*name);
1325   xfree (exp);
1326
1327   return value_type (val);
1328 }
1329
1330 /* A post-parser that does nothing.  */
1331
1332 void
1333 null_post_parser (struct expression **exp, int void_context_p)
1334 {
1335 }
1336
1337 /* Parse floating point value P of length LEN.
1338    Return 0 (false) if invalid, 1 (true) if valid.
1339    The successfully parsed number is stored in D.
1340    *SUFFIX points to the suffix of the number in P.
1341
1342    NOTE: This accepts the floating point syntax that sscanf accepts.  */
1343
1344 int
1345 parse_float (const char *p, int len, DOUBLEST *d, const char **suffix)
1346 {
1347   char *copy;
1348   int n, num;
1349
1350   copy = xmalloc (len + 1);
1351   memcpy (copy, p, len);
1352   copy[len] = 0;
1353
1354   num = sscanf (copy, "%" DOUBLEST_SCAN_FORMAT "%n", d, &n);
1355   xfree (copy);
1356
1357   /* The sscanf man page suggests not making any assumptions on the effect
1358      of %n on the result, so we don't.
1359      That is why we simply test num == 0.  */
1360   if (num == 0)
1361     return 0;
1362
1363   *suffix = p + n;
1364   return 1;
1365 }
1366
1367 /* Parse floating point value P of length LEN, using the C syntax for floats.
1368    Return 0 (false) if invalid, 1 (true) if valid.
1369    The successfully parsed number is stored in *D.
1370    Its type is taken from builtin_type (gdbarch) and is stored in *T.  */
1371
1372 int
1373 parse_c_float (struct gdbarch *gdbarch, const char *p, int len,
1374                DOUBLEST *d, struct type **t)
1375 {
1376   const char *suffix;
1377   int suffix_len;
1378   const struct builtin_type *builtin_types = builtin_type (gdbarch);
1379
1380   if (! parse_float (p, len, d, &suffix))
1381     return 0;
1382
1383   suffix_len = p + len - suffix;
1384
1385   if (suffix_len == 0)
1386     *t = builtin_types->builtin_double;
1387   else if (suffix_len == 1)
1388     {
1389       /* Handle suffixes: 'f' for float, 'l' for long double.  */
1390       if (tolower (*suffix) == 'f')
1391         *t = builtin_types->builtin_float;
1392       else if (tolower (*suffix) == 'l')
1393         *t = builtin_types->builtin_long_double;
1394       else
1395         return 0;
1396     }
1397   else
1398     return 0;
1399
1400   return 1;
1401 }
1402 \f
1403 /* Stuff for maintaining a stack of types.  Currently just used by C, but
1404    probably useful for any language which declares its types "backwards".  */
1405
1406 /* Ensure that there are HOWMUCH open slots on the type stack STACK.  */
1407
1408 static void
1409 type_stack_reserve (struct type_stack *stack, int howmuch)
1410 {
1411   if (stack->depth + howmuch >= stack->size)
1412     {
1413       stack->size *= 2;
1414       if (stack->size < howmuch)
1415         stack->size = howmuch;
1416       stack->elements = xrealloc (stack->elements,
1417                                   stack->size * sizeof (union type_stack_elt));
1418     }
1419 }
1420
1421 /* Ensure that there is a single open slot in the global type stack.  */
1422
1423 static void
1424 check_type_stack_depth (void)
1425 {
1426   type_stack_reserve (&type_stack, 1);
1427 }
1428
1429 /* A helper function for insert_type and insert_type_address_space.
1430    This does work of expanding the type stack and inserting the new
1431    element, ELEMENT, into the stack at location SLOT.  */
1432
1433 static void
1434 insert_into_type_stack (int slot, union type_stack_elt element)
1435 {
1436   check_type_stack_depth ();
1437
1438   if (slot < type_stack.depth)
1439     memmove (&type_stack.elements[slot + 1], &type_stack.elements[slot],
1440              (type_stack.depth - slot) * sizeof (union type_stack_elt));
1441   type_stack.elements[slot] = element;
1442   ++type_stack.depth;
1443 }
1444
1445 /* Insert a new type, TP, at the bottom of the type stack.  If TP is
1446    tp_pointer or tp_reference, it is inserted at the bottom.  If TP is
1447    a qualifier, it is inserted at slot 1 (just above a previous
1448    tp_pointer) if there is anything on the stack, or simply pushed if
1449    the stack is empty.  Other values for TP are invalid.  */
1450
1451 void
1452 insert_type (enum type_pieces tp)
1453 {
1454   union type_stack_elt element;
1455   int slot;
1456
1457   gdb_assert (tp == tp_pointer || tp == tp_reference
1458               || tp == tp_const || tp == tp_volatile);
1459
1460   /* If there is anything on the stack (we know it will be a
1461      tp_pointer), insert the qualifier above it.  Otherwise, simply
1462      push this on the top of the stack.  */
1463   if (type_stack.depth && (tp == tp_const || tp == tp_volatile))
1464     slot = 1;
1465   else
1466     slot = 0;
1467
1468   element.piece = tp;
1469   insert_into_type_stack (slot, element);
1470 }
1471
1472 void
1473 push_type (enum type_pieces tp)
1474 {
1475   check_type_stack_depth ();
1476   type_stack.elements[type_stack.depth++].piece = tp;
1477 }
1478
1479 void
1480 push_type_int (int n)
1481 {
1482   check_type_stack_depth ();
1483   type_stack.elements[type_stack.depth++].int_val = n;
1484 }
1485
1486 /* Insert a tp_space_identifier and the corresponding address space
1487    value into the stack.  STRING is the name of an address space, as
1488    recognized by address_space_name_to_int.  If the stack is empty,
1489    the new elements are simply pushed.  If the stack is not empty,
1490    this function assumes that the first item on the stack is a
1491    tp_pointer, and the new values are inserted above the first
1492    item.  */
1493
1494 void
1495 insert_type_address_space (struct parser_state *pstate, char *string)
1496 {
1497   union type_stack_elt element;
1498   int slot;
1499
1500   /* If there is anything on the stack (we know it will be a
1501      tp_pointer), insert the address space qualifier above it.
1502      Otherwise, simply push this on the top of the stack.  */
1503   if (type_stack.depth)
1504     slot = 1;
1505   else
1506     slot = 0;
1507
1508   element.piece = tp_space_identifier;
1509   insert_into_type_stack (slot, element);
1510   element.int_val = address_space_name_to_int (parse_gdbarch (pstate),
1511                                                string);
1512   insert_into_type_stack (slot, element);
1513 }
1514
1515 enum type_pieces
1516 pop_type (void)
1517 {
1518   if (type_stack.depth)
1519     return type_stack.elements[--type_stack.depth].piece;
1520   return tp_end;
1521 }
1522
1523 int
1524 pop_type_int (void)
1525 {
1526   if (type_stack.depth)
1527     return type_stack.elements[--type_stack.depth].int_val;
1528   /* "Can't happen".  */
1529   return 0;
1530 }
1531
1532 /* Pop a type list element from the global type stack.  */
1533
1534 static VEC (type_ptr) *
1535 pop_typelist (void)
1536 {
1537   gdb_assert (type_stack.depth);
1538   return type_stack.elements[--type_stack.depth].typelist_val;
1539 }
1540
1541 /* Pop a type_stack element from the global type stack.  */
1542
1543 static struct type_stack *
1544 pop_type_stack (void)
1545 {
1546   gdb_assert (type_stack.depth);
1547   return type_stack.elements[--type_stack.depth].stack_val;
1548 }
1549
1550 /* Append the elements of the type stack FROM to the type stack TO.
1551    Always returns TO.  */
1552
1553 struct type_stack *
1554 append_type_stack (struct type_stack *to, struct type_stack *from)
1555 {
1556   type_stack_reserve (to, from->depth);
1557
1558   memcpy (&to->elements[to->depth], &from->elements[0],
1559           from->depth * sizeof (union type_stack_elt));
1560   to->depth += from->depth;
1561
1562   return to;
1563 }
1564
1565 /* Push the type stack STACK as an element on the global type stack.  */
1566
1567 void
1568 push_type_stack (struct type_stack *stack)
1569 {
1570   check_type_stack_depth ();
1571   type_stack.elements[type_stack.depth++].stack_val = stack;
1572   push_type (tp_type_stack);
1573 }
1574
1575 /* Copy the global type stack into a newly allocated type stack and
1576    return it.  The global stack is cleared.  The returned type stack
1577    must be freed with type_stack_cleanup.  */
1578
1579 struct type_stack *
1580 get_type_stack (void)
1581 {
1582   struct type_stack *result = XNEW (struct type_stack);
1583
1584   *result = type_stack;
1585   type_stack.depth = 0;
1586   type_stack.size = 0;
1587   type_stack.elements = NULL;
1588
1589   return result;
1590 }
1591
1592 /* A cleanup function that destroys a single type stack.  */
1593
1594 void
1595 type_stack_cleanup (void *arg)
1596 {
1597   struct type_stack *stack = arg;
1598
1599   xfree (stack->elements);
1600   xfree (stack);
1601 }
1602
1603 /* Push a function type with arguments onto the global type stack.
1604    LIST holds the argument types.  If the final item in LIST is NULL,
1605    then the function will be varargs.  */
1606
1607 void
1608 push_typelist (VEC (type_ptr) *list)
1609 {
1610   check_type_stack_depth ();
1611   type_stack.elements[type_stack.depth++].typelist_val = list;
1612   push_type (tp_function_with_arguments);
1613 }
1614
1615 /* Pop the type stack and return the type which corresponds to FOLLOW_TYPE
1616    as modified by all the stuff on the stack.  */
1617 struct type *
1618 follow_types (struct type *follow_type)
1619 {
1620   int done = 0;
1621   int make_const = 0;
1622   int make_volatile = 0;
1623   int make_addr_space = 0;
1624   int array_size;
1625
1626   while (!done)
1627     switch (pop_type ())
1628       {
1629       case tp_end:
1630         done = 1;
1631         if (make_const)
1632           follow_type = make_cv_type (make_const, 
1633                                       TYPE_VOLATILE (follow_type), 
1634                                       follow_type, 0);
1635         if (make_volatile)
1636           follow_type = make_cv_type (TYPE_CONST (follow_type), 
1637                                       make_volatile, 
1638                                       follow_type, 0);
1639         if (make_addr_space)
1640           follow_type = make_type_with_address_space (follow_type, 
1641                                                       make_addr_space);
1642         make_const = make_volatile = 0;
1643         make_addr_space = 0;
1644         break;
1645       case tp_const:
1646         make_const = 1;
1647         break;
1648       case tp_volatile:
1649         make_volatile = 1;
1650         break;
1651       case tp_space_identifier:
1652         make_addr_space = pop_type_int ();
1653         break;
1654       case tp_pointer:
1655         follow_type = lookup_pointer_type (follow_type);
1656         if (make_const)
1657           follow_type = make_cv_type (make_const, 
1658                                       TYPE_VOLATILE (follow_type), 
1659                                       follow_type, 0);
1660         if (make_volatile)
1661           follow_type = make_cv_type (TYPE_CONST (follow_type), 
1662                                       make_volatile, 
1663                                       follow_type, 0);
1664         if (make_addr_space)
1665           follow_type = make_type_with_address_space (follow_type, 
1666                                                       make_addr_space);
1667         make_const = make_volatile = 0;
1668         make_addr_space = 0;
1669         break;
1670       case tp_reference:
1671         follow_type = lookup_reference_type (follow_type);
1672         if (make_const)
1673           follow_type = make_cv_type (make_const, 
1674                                       TYPE_VOLATILE (follow_type), 
1675                                       follow_type, 0);
1676         if (make_volatile)
1677           follow_type = make_cv_type (TYPE_CONST (follow_type), 
1678                                       make_volatile, 
1679                                       follow_type, 0);
1680         if (make_addr_space)
1681           follow_type = make_type_with_address_space (follow_type, 
1682                                                       make_addr_space);
1683         make_const = make_volatile = 0;
1684         make_addr_space = 0;
1685         break;
1686       case tp_array:
1687         array_size = pop_type_int ();
1688         /* FIXME-type-allocation: need a way to free this type when we are
1689            done with it.  */
1690         follow_type =
1691           lookup_array_range_type (follow_type,
1692                                    0, array_size >= 0 ? array_size - 1 : 0);
1693         if (array_size < 0)
1694           TYPE_HIGH_BOUND_KIND (TYPE_INDEX_TYPE (follow_type))
1695             = PROP_UNDEFINED;
1696         break;
1697       case tp_function:
1698         /* FIXME-type-allocation: need a way to free this type when we are
1699            done with it.  */
1700         follow_type = lookup_function_type (follow_type);
1701         break;
1702
1703       case tp_function_with_arguments:
1704         {
1705           VEC (type_ptr) *args = pop_typelist ();
1706
1707           follow_type
1708             = lookup_function_type_with_arguments (follow_type,
1709                                                    VEC_length (type_ptr, args),
1710                                                    VEC_address (type_ptr,
1711                                                                 args));
1712           VEC_free (type_ptr, args);
1713         }
1714         break;
1715
1716       case tp_type_stack:
1717         {
1718           struct type_stack *stack = pop_type_stack ();
1719           /* Sort of ugly, but not really much worse than the
1720              alternatives.  */
1721           struct type_stack save = type_stack;
1722
1723           type_stack = *stack;
1724           follow_type = follow_types (follow_type);
1725           gdb_assert (type_stack.depth == 0);
1726
1727           type_stack = save;
1728         }
1729         break;
1730       default:
1731         gdb_assert_not_reached ("unrecognized tp_ value in follow_types");
1732       }
1733   return follow_type;
1734 }
1735 \f
1736 /* This function avoids direct calls to fprintf 
1737    in the parser generated debug code.  */
1738 void
1739 parser_fprintf (FILE *x, const char *y, ...)
1740
1741   va_list args;
1742
1743   va_start (args, y);
1744   if (x == stderr)
1745     vfprintf_unfiltered (gdb_stderr, y, args); 
1746   else
1747     {
1748       fprintf_unfiltered (gdb_stderr, " Unknown FILE used.\n");
1749       vfprintf_unfiltered (gdb_stderr, y, args);
1750     }
1751   va_end (args);
1752 }
1753
1754 /* Implementation of the exp_descriptor method operator_check.  */
1755
1756 int
1757 operator_check_standard (struct expression *exp, int pos,
1758                          int (*objfile_func) (struct objfile *objfile,
1759                                               void *data),
1760                          void *data)
1761 {
1762   const union exp_element *const elts = exp->elts;
1763   struct type *type = NULL;
1764   struct objfile *objfile = NULL;
1765
1766   /* Extended operators should have been already handled by exp_descriptor
1767      iterate method of its specific language.  */
1768   gdb_assert (elts[pos].opcode < OP_EXTENDED0);
1769
1770   /* Track the callers of write_exp_elt_type for this table.  */
1771
1772   switch (elts[pos].opcode)
1773     {
1774     case BINOP_VAL:
1775     case OP_COMPLEX:
1776     case OP_DECFLOAT:
1777     case OP_DOUBLE:
1778     case OP_LONG:
1779     case OP_SCOPE:
1780     case OP_TYPE:
1781     case UNOP_CAST:
1782     case UNOP_MAX:
1783     case UNOP_MEMVAL:
1784     case UNOP_MIN:
1785       type = elts[pos + 1].type;
1786       break;
1787
1788     case TYPE_INSTANCE:
1789       {
1790         LONGEST arg, nargs = elts[pos + 1].longconst;
1791
1792         for (arg = 0; arg < nargs; arg++)
1793           {
1794             struct type *type = elts[pos + 2 + arg].type;
1795             struct objfile *objfile = TYPE_OBJFILE (type);
1796
1797             if (objfile && (*objfile_func) (objfile, data))
1798               return 1;
1799           }
1800       }
1801       break;
1802
1803     case UNOP_MEMVAL_TLS:
1804       objfile = elts[pos + 1].objfile;
1805       type = elts[pos + 2].type;
1806       break;
1807
1808     case OP_VAR_VALUE:
1809       {
1810         const struct block *const block = elts[pos + 1].block;
1811         const struct symbol *const symbol = elts[pos + 2].symbol;
1812
1813         /* Check objfile where the variable itself is placed.
1814            SYMBOL_OBJ_SECTION (symbol) may be NULL.  */
1815         if ((*objfile_func) (SYMBOL_SYMTAB (symbol)->objfile, data))
1816           return 1;
1817
1818         /* Check objfile where is placed the code touching the variable.  */
1819         objfile = lookup_objfile_from_block (block);
1820
1821         type = SYMBOL_TYPE (symbol);
1822       }
1823       break;
1824     }
1825
1826   /* Invoke callbacks for TYPE and OBJFILE if they were set as non-NULL.  */
1827
1828   if (type && TYPE_OBJFILE (type)
1829       && (*objfile_func) (TYPE_OBJFILE (type), data))
1830     return 1;
1831   if (objfile && (*objfile_func) (objfile, data))
1832     return 1;
1833
1834   return 0;
1835 }
1836
1837 /* Call OBJFILE_FUNC for any objfile found being referenced by EXP.
1838    OBJFILE_FUNC is never called with NULL OBJFILE.  OBJFILE_FUNC get
1839    passed an arbitrary caller supplied DATA pointer.  If OBJFILE_FUNC
1840    returns non-zero value then (any other) non-zero value is immediately
1841    returned to the caller.  Otherwise zero is returned after iterating
1842    through whole EXP.  */
1843
1844 static int
1845 exp_iterate (struct expression *exp,
1846              int (*objfile_func) (struct objfile *objfile, void *data),
1847              void *data)
1848 {
1849   int endpos;
1850
1851   for (endpos = exp->nelts; endpos > 0; )
1852     {
1853       int pos, args, oplen = 0;
1854
1855       operator_length (exp, endpos, &oplen, &args);
1856       gdb_assert (oplen > 0);
1857
1858       pos = endpos - oplen;
1859       if (exp->language_defn->la_exp_desc->operator_check (exp, pos,
1860                                                            objfile_func, data))
1861         return 1;
1862
1863       endpos = pos;
1864     }
1865
1866   return 0;
1867 }
1868
1869 /* Helper for exp_uses_objfile.  */
1870
1871 static int
1872 exp_uses_objfile_iter (struct objfile *exp_objfile, void *objfile_voidp)
1873 {
1874   struct objfile *objfile = objfile_voidp;
1875
1876   if (exp_objfile->separate_debug_objfile_backlink)
1877     exp_objfile = exp_objfile->separate_debug_objfile_backlink;
1878
1879   return exp_objfile == objfile;
1880 }
1881
1882 /* Return 1 if EXP uses OBJFILE (and will become dangling when OBJFILE
1883    is unloaded), otherwise return 0.  OBJFILE must not be a separate debug info
1884    file.  */
1885
1886 int
1887 exp_uses_objfile (struct expression *exp, struct objfile *objfile)
1888 {
1889   gdb_assert (objfile->separate_debug_objfile_backlink == NULL);
1890
1891   return exp_iterate (exp, exp_uses_objfile_iter, objfile);
1892 }
1893
1894 /* See definition in parser-defs.h.  */
1895
1896 void
1897 increase_expout_size (struct parser_state *ps, size_t lenelt)
1898 {
1899   if ((ps->expout_ptr + lenelt) >= ps->expout_size)
1900     {
1901       ps->expout_size = max (ps->expout_size * 2,
1902                              ps->expout_ptr + lenelt + 10);
1903       ps->expout = (struct expression *)
1904         xrealloc (ps->expout, (sizeof (struct expression)
1905                                + EXP_ELEM_TO_BYTES (ps->expout_size)));
1906     }
1907 }
1908
1909 void
1910 _initialize_parse (void)
1911 {
1912   type_stack.size = 0;
1913   type_stack.depth = 0;
1914   type_stack.elements = NULL;
1915
1916   add_setshow_zuinteger_cmd ("expression", class_maintenance,
1917                              &expressiondebug,
1918                              _("Set expression debugging."),
1919                              _("Show expression debugging."),
1920                              _("When non-zero, the internal representation "
1921                                "of expressions will be printed."),
1922                              NULL,
1923                              show_expressiondebug,
1924                              &setdebuglist, &showdebuglist);
1925   add_setshow_boolean_cmd ("parser", class_maintenance,
1926                             &parser_debug,
1927                            _("Set parser debugging."),
1928                            _("Show parser debugging."),
1929                            _("When non-zero, expression parser "
1930                              "tracing will be enabled."),
1931                             NULL,
1932                             show_parserdebug,
1933                             &setdebuglist, &showdebuglist);
1934 }