*** empty log message ***
[deliverable/binutils-gdb.git] / gdb / parser-defs.h
CommitLineData
c906108c 1/* Parser definitions for GDB.
96cb11df 2
6aba47ca 3 Copyright (C) 1986, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997,
7b6bb8da 4 1998, 1999, 2000, 2002, 2007, 2008, 2009, 2010, 2011
4c38e0a4 5 Free Software Foundation, Inc.
96cb11df 6
c906108c
SS
7 Modified from expread.y by the Department of Computer Science at the
8 State University of New York at Buffalo.
9
c5aa993b 10 This file is part of GDB.
c906108c 11
c5aa993b
JM
12 This program is free software; you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
a9762ec7 14 the Free Software Foundation; either version 3 of the License, or
c5aa993b 15 (at your option) any later version.
c906108c 16
c5aa993b
JM
17 This program is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
c906108c 21
c5aa993b 22 You should have received a copy of the GNU General Public License
a9762ec7 23 along with this program. If not, see <http://www.gnu.org/licenses/>. */
c906108c
SS
24
25#if !defined (PARSER_DEFS_H)
26#define PARSER_DEFS_H 1
27
d16aafd8
AC
28#include "doublest.h"
29
fe898f56
DC
30struct block;
31
92981e24
TT
32extern int parser_debug;
33
c906108c
SS
34extern struct expression *expout;
35extern int expout_size;
36extern int expout_ptr;
37
3e79cecf
UW
38#define parse_gdbarch (expout->gdbarch)
39#define parse_language (expout->language_defn)
40
c906108c
SS
41/* If this is nonzero, this block is used as the lexical context
42 for symbol names. */
43
44extern struct block *expression_context_block;
45
84f0252a
JB
46/* If expression_context_block is non-zero, then this is the PC within
47 the block that we want to evaluate expressions at. When debugging
48 C or C++ code, we use this to find the exact line we're at, and
49 then look up the macro definitions active at that point. */
f7321c06 50extern CORE_ADDR expression_context_pc;
84f0252a 51
c906108c 52/* The innermost context required by the stack and register variables
0df8b418 53 we've encountered so far. */
c906108c
SS
54extern struct block *innermost_block;
55
56/* The block in which the most recently discovered symbol was found.
57 FIXME: Should be declared along with lookup_symbol in symtab.h; is not
58 related specifically to parsing. */
59extern struct block *block_found;
60
61/* Number of arguments seen so far in innermost function call. */
62extern int arglist_len;
63
64/* A string token, either a char-string or bit-string. Char-strings are
0df8b418 65 used, for example, for the names of symbols. */
c906108c
SS
66
67struct stoken
68 {
0df8b418 69 /* Pointer to first byte of char-string or first bit of bit-string. */
c906108c 70 char *ptr;
0df8b418 71 /* Length of string in bytes for char-string or bits for bit-string. */
c906108c
SS
72 int length;
73 };
74
6c7a06a3
TT
75struct typed_stoken
76 {
77 /* A language-specific type field. */
78 int type;
0df8b418 79 /* Pointer to first byte of char-string or first bit of bit-string. */
6c7a06a3 80 char *ptr;
0df8b418 81 /* Length of string in bytes for char-string or bits for bit-string. */
6c7a06a3
TT
82 int length;
83 };
84
85struct stoken_vector
86 {
87 int len;
88 struct typed_stoken *tokens;
89 };
90
c906108c
SS
91struct ttype
92 {
93 struct stoken stoken;
94 struct type *type;
95 };
96
97struct symtoken
98 {
99 struct stoken stoken;
100 struct symbol *sym;
101 int is_a_field_of_this;
102 };
103
379b85df
AF
104struct objc_class_str
105 {
106 struct stoken stoken;
107 struct type *type;
108 int class;
109 };
110
111
c906108c
SS
112/* For parsing of complicated types.
113 An array should be preceded in the list by the size of the array. */
114enum type_pieces
c5aa993b 115 {
2e2394a0
MS
116 tp_end = -1,
117 tp_pointer,
118 tp_reference,
119 tp_array,
120 tp_function,
121 tp_const,
47663de5
MS
122 tp_volatile,
123 tp_space_identifier
c5aa993b 124 };
c906108c 125/* The stack can contain either an enum type_pieces or an int. */
c5aa993b
JM
126union type_stack_elt
127 {
128 enum type_pieces piece;
129 int int_val;
130 };
c906108c
SS
131extern union type_stack_elt *type_stack;
132extern int type_stack_depth, type_stack_size;
133
a14ed312 134extern void write_exp_elt_opcode (enum exp_opcode);
c906108c 135
a14ed312 136extern void write_exp_elt_sym (struct symbol *);
c906108c 137
a14ed312 138extern void write_exp_elt_longcst (LONGEST);
c906108c 139
a14ed312 140extern void write_exp_elt_dblcst (DOUBLEST);
c906108c 141
27bc4d80
TJB
142extern void write_exp_elt_decfloatcst (gdb_byte *);
143
a14ed312 144extern void write_exp_elt_type (struct type *);
c906108c 145
a14ed312 146extern void write_exp_elt_intern (struct internalvar *);
c906108c 147
a14ed312 148extern void write_exp_string (struct stoken);
c906108c 149
6c7a06a3
TT
150void write_exp_string_vector (int type, struct stoken_vector *vec);
151
a14ed312 152extern void write_exp_bitstring (struct stoken);
c906108c 153
a14ed312 154extern void write_exp_elt_block (struct block *);
c906108c 155
9e35dae4
DJ
156extern void write_exp_elt_objfile (struct objfile *objfile);
157
c841afd5 158extern void write_exp_msymbol (struct minimal_symbol *);
c906108c 159
a14ed312 160extern void write_dollar_variable (struct stoken str);
c906108c 161
65d12d83
TT
162extern void mark_struct_expression (void);
163
a14ed312 164extern char *find_template_name_end (char *);
c906108c 165
a14ed312 166extern void start_arglist (void);
c906108c 167
a14ed312 168extern int end_arglist (void);
c906108c 169
a14ed312 170extern char *copy_name (struct stoken);
c906108c 171
a14ed312 172extern void push_type (enum type_pieces);
c906108c 173
a14ed312 174extern void push_type_int (int);
c906108c 175
47663de5
MS
176extern void push_type_address_space (char *);
177
a14ed312 178extern enum type_pieces pop_type (void);
c906108c 179
a14ed312 180extern int pop_type_int (void);
c906108c 181
a14ed312 182extern int length_of_subexp (struct expression *, int);
c906108c 183
5f9769d1
PH
184extern int dump_subexp (struct expression *, struct ui_file *, int);
185
186extern int dump_subexp_body_standard (struct expression *,
187 struct ui_file *, int);
188
554794dc 189extern void operator_length (const struct expression *, int, int *, int *);
24daaebc 190
554794dc
SDJ
191extern void operator_length_standard (const struct expression *, int, int *,
192 int *);
5f9769d1 193
c0201579
JK
194extern int operator_check_standard (struct expression *exp, int pos,
195 int (*objfile_func)
196 (struct objfile *objfile, void *data),
197 void *data);
198
5f9769d1
PH
199extern char *op_name_standard (enum exp_opcode);
200
a14ed312 201extern struct type *follow_types (struct type *);
c906108c 202
e85c3284
PH
203extern void null_post_parser (struct expression **, int);
204
d30f5e1f
DE
205extern int parse_float (const char *p, int len, DOUBLEST *d,
206 const char **suffix);
207
208extern int parse_c_float (struct gdbarch *gdbarch, const char *p, int len,
209 DOUBLEST *d, struct type **t);
210
c906108c
SS
211/* During parsing of a C expression, the pointer to the next character
212 is in this variable. */
213
214extern char *lexptr;
215
0df8b418 216/* After a token has been recognized, this variable points to it.
665132f9
MS
217 Currently used only for error reporting. */
218extern char *prev_lexptr;
219
c906108c
SS
220/* Tokens that refer to names do so with explicit pointer and length,
221 so they can share the storage that lexptr is parsing.
222
223 When it is necessary to pass a name to a function that expects
224 a null-terminated string, the substring is copied out
225 into a block of storage that namecopy points to.
226
227 namecopy is allocated once, guaranteed big enough, for each parsing. */
228
229extern char *namecopy;
230
231/* Current depth in parentheses within the expression. */
232
233extern int paren_depth;
234
235/* Nonzero means stop parsing on first comma (if not within parentheses). */
236
237extern int comma_terminates;
238\f
239/* These codes indicate operator precedences for expression printing,
240 least tightly binding first. */
241/* Adding 1 to a precedence value is done for binary operators,
242 on the operand which is more tightly bound, so that operators
243 of equal precedence within that operand will get parentheses. */
244/* PREC_HYPER and PREC_ABOVE_COMMA are not the precedence of any operator;
245 they are used as the "surrounding precedence" to force
246 various kinds of things to be parenthesized. */
247enum precedence
c5aa993b
JM
248 {
249 PREC_NULL, PREC_COMMA, PREC_ABOVE_COMMA, PREC_ASSIGN, PREC_LOGICAL_OR,
250 PREC_LOGICAL_AND, PREC_BITWISE_IOR, PREC_BITWISE_AND, PREC_BITWISE_XOR,
251 PREC_EQUAL, PREC_ORDER, PREC_SHIFT, PREC_ADD, PREC_MUL, PREC_REPEAT,
252 PREC_HYPER, PREC_PREFIX, PREC_SUFFIX, PREC_BUILTIN_FUNCTION
253 };
c906108c
SS
254
255/* Table mapping opcodes into strings for printing operators
256 and precedences of the operators. */
257
258struct op_print
c5aa993b
JM
259 {
260 char *string;
261 enum exp_opcode opcode;
262 /* Precedence of operator. These values are used only by comparisons. */
263 enum precedence precedence;
264
265 /* For a binary operator: 1 iff right associate.
0df8b418 266 For a unary operator: 1 iff postfix. */
c5aa993b
JM
267 int right_assoc;
268 };
c906108c 269
5f9769d1
PH
270/* Information needed to print, prefixify, and evaluate expressions for
271 a given language. */
272
273struct exp_descriptor
274 {
275 /* Print subexpression. */
276 void (*print_subexp) (struct expression *, int *, struct ui_file *,
277 enum precedence);
278
279 /* Returns number of exp_elements needed to represent an operator and
280 the number of subexpressions it takes. */
554794dc 281 void (*operator_length) (const struct expression*, int, int*, int *);
5f9769d1 282
c0201579
JK
283 /* Call TYPE_FUNC and OBJFILE_FUNC for any TYPE and OBJFILE found being
284 referenced by the single operator of EXP at position POS. Operator
285 parameters are located at positive (POS + number) offsets in EXP.
286 The functions should never be called with NULL TYPE or NULL OBJFILE.
287 Functions should get passed an arbitrary caller supplied DATA pointer.
288 If any of the functions returns non-zero value then (any other) non-zero
289 value should be immediately returned to the caller. Otherwise zero
290 should be returned. */
291 int (*operator_check) (struct expression *exp, int pos,
292 int (*objfile_func) (struct objfile *objfile,
293 void *data),
294 void *data);
295
5f9769d1
PH
296 /* Name of this operator for dumping purposes. */
297 char *(*op_name) (enum exp_opcode);
298
299 /* Dump the rest of this (prefix) expression after the operator
300 itself has been printed. See dump_subexp_body_standard in
301 (expprint.c). */
302 int (*dump_subexp_body) (struct expression *, struct ui_file *, int);
303
304 /* Evaluate an expression. */
305 struct value *(*evaluate_exp) (struct type *, struct expression *,
306 int *, enum noside);
307 };
308
309
310/* Default descriptor containing standard definitions of all
311 elements. */
312extern const struct exp_descriptor exp_descriptor_standard;
313
314/* Functions used by language-specific extended operators to (recursively)
315 print/dump subexpressions. */
316
317extern void print_subexp (struct expression *, int *, struct ui_file *,
318 enum precedence);
319
320extern void print_subexp_standard (struct expression *, int *,
321 struct ui_file *, enum precedence);
322
f461f5cf
PM
323/* Function used to avoid direct calls to fprintf
324 in the code generated by the bison parser. */
325
a0b31db1 326extern void parser_fprintf (FILE *, const char *, ...) ATTRIBUTE_PRINTF (2, 3);
f461f5cf 327
c0201579
JK
328extern int exp_uses_objfile (struct expression *exp, struct objfile *objfile);
329
c5aa993b 330#endif /* PARSER_DEFS_H */
This page took 0.973543 seconds and 4 git commands to generate.