1 |
707 |
jeremybenn |
/* Various declarations for the C and C++ pretty-printers.
|
2 |
|
|
Copyright (C) 2002, 2003, 2004, 2007, 2009, 2010
|
3 |
|
|
Free Software Foundation, Inc.
|
4 |
|
|
Contributed by Gabriel Dos Reis <gdr@integrable-solutions.net>
|
5 |
|
|
|
6 |
|
|
This file is part of GCC.
|
7 |
|
|
|
8 |
|
|
GCC is free software; you can redistribute it and/or modify it under
|
9 |
|
|
the terms of the GNU General Public License as published by the Free
|
10 |
|
|
Software Foundation; either version 3, or (at your option) any later
|
11 |
|
|
version.
|
12 |
|
|
|
13 |
|
|
GCC is distributed in the hope that it will be useful, but WITHOUT ANY
|
14 |
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
15 |
|
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
16 |
|
|
for more details.
|
17 |
|
|
|
18 |
|
|
You should have received a copy of the GNU General Public License
|
19 |
|
|
along with GCC; see the file COPYING3. If not see
|
20 |
|
|
<http://www.gnu.org/licenses/>. */
|
21 |
|
|
|
22 |
|
|
#ifndef GCC_C_PRETTY_PRINTER
|
23 |
|
|
#define GCC_C_PRETTY_PRINTER
|
24 |
|
|
|
25 |
|
|
#include "tree.h"
|
26 |
|
|
#include "c-family/c-common.h"
|
27 |
|
|
#include "pretty-print.h"
|
28 |
|
|
|
29 |
|
|
|
30 |
|
|
typedef enum
|
31 |
|
|
{
|
32 |
|
|
pp_c_flag_abstract = 1 << 1,
|
33 |
|
|
pp_c_flag_last_bit = 2
|
34 |
|
|
} pp_c_pretty_print_flags;
|
35 |
|
|
|
36 |
|
|
|
37 |
|
|
/* The data type used to bundle information necessary for pretty-printing
|
38 |
|
|
a C or C++ entity. */
|
39 |
|
|
typedef struct c_pretty_print_info c_pretty_printer;
|
40 |
|
|
|
41 |
|
|
/* The type of a C pretty-printer 'member' function. */
|
42 |
|
|
typedef void (*c_pretty_print_fn) (c_pretty_printer *, tree);
|
43 |
|
|
|
44 |
|
|
/* The datatype that contains information necessary for pretty-printing
|
45 |
|
|
a tree that represents a C construct. Any pretty-printer for a
|
46 |
|
|
language using C/c++ syntax can derive from this datatype and reuse
|
47 |
|
|
facilities provided here. It can do so by having a subobject of type
|
48 |
|
|
c_pretty_printer and override the macro pp_c_base to return a pointer
|
49 |
|
|
to that subobject. Such a pretty-printer has the responsibility to
|
50 |
|
|
initialize the pp_base() part, then call pp_c_pretty_printer_init
|
51 |
|
|
to set up the components that are specific to the C pretty-printer.
|
52 |
|
|
A derived pretty-printer can override any function listed in the
|
53 |
|
|
vtable below. See cp/cxx-pretty-print.h and cp/cxx-pretty-print.c
|
54 |
|
|
for an example of derivation. */
|
55 |
|
|
struct c_pretty_print_info
|
56 |
|
|
{
|
57 |
|
|
pretty_printer base;
|
58 |
|
|
/* Points to the first element of an array of offset-list.
|
59 |
|
|
Not used yet. */
|
60 |
|
|
int *offset_list;
|
61 |
|
|
|
62 |
|
|
pp_flags flags;
|
63 |
|
|
|
64 |
|
|
/* These must be overridden by each of the C and C++ front-end to
|
65 |
|
|
reflect their understanding of syntactic productions when they differ. */
|
66 |
|
|
c_pretty_print_fn declaration;
|
67 |
|
|
c_pretty_print_fn declaration_specifiers;
|
68 |
|
|
c_pretty_print_fn declarator;
|
69 |
|
|
c_pretty_print_fn abstract_declarator;
|
70 |
|
|
c_pretty_print_fn direct_abstract_declarator;
|
71 |
|
|
c_pretty_print_fn type_specifier_seq;
|
72 |
|
|
c_pretty_print_fn direct_declarator;
|
73 |
|
|
c_pretty_print_fn ptr_operator;
|
74 |
|
|
c_pretty_print_fn parameter_list;
|
75 |
|
|
c_pretty_print_fn type_id;
|
76 |
|
|
c_pretty_print_fn simple_type_specifier;
|
77 |
|
|
c_pretty_print_fn function_specifier;
|
78 |
|
|
c_pretty_print_fn storage_class_specifier;
|
79 |
|
|
c_pretty_print_fn initializer;
|
80 |
|
|
|
81 |
|
|
c_pretty_print_fn statement;
|
82 |
|
|
|
83 |
|
|
c_pretty_print_fn constant;
|
84 |
|
|
c_pretty_print_fn id_expression;
|
85 |
|
|
c_pretty_print_fn primary_expression;
|
86 |
|
|
c_pretty_print_fn postfix_expression;
|
87 |
|
|
c_pretty_print_fn unary_expression;
|
88 |
|
|
c_pretty_print_fn multiplicative_expression;
|
89 |
|
|
c_pretty_print_fn conditional_expression;
|
90 |
|
|
c_pretty_print_fn assignment_expression;
|
91 |
|
|
c_pretty_print_fn expression;
|
92 |
|
|
};
|
93 |
|
|
|
94 |
|
|
/* Override the pp_base macro. Derived pretty-printers should not
|
95 |
|
|
touch this macro. Instead they should override pp_c_base instead. */
|
96 |
|
|
#undef pp_base
|
97 |
|
|
#define pp_base(PP) (&pp_c_base (PP)->base)
|
98 |
|
|
|
99 |
|
|
|
100 |
|
|
#define pp_c_tree_identifier(PPI, ID) \
|
101 |
|
|
pp_c_identifier (PPI, IDENTIFIER_POINTER (ID))
|
102 |
|
|
|
103 |
|
|
#define pp_declaration(PPI, T) \
|
104 |
|
|
pp_c_base (PPI)->declaration (pp_c_base (PPI), T)
|
105 |
|
|
#define pp_declaration_specifiers(PPI, D) \
|
106 |
|
|
pp_c_base (PPI)->declaration_specifiers (pp_c_base (PPI), D)
|
107 |
|
|
#define pp_abstract_declarator(PP, D) \
|
108 |
|
|
pp_c_base (PP)->abstract_declarator (pp_c_base (PP), D)
|
109 |
|
|
#define pp_type_specifier_seq(PPI, D) \
|
110 |
|
|
pp_c_base (PPI)->type_specifier_seq (pp_c_base (PPI), D)
|
111 |
|
|
#define pp_declarator(PPI, D) \
|
112 |
|
|
pp_c_base (PPI)->declarator (pp_c_base (PPI), D)
|
113 |
|
|
#define pp_direct_declarator(PPI, D) \
|
114 |
|
|
pp_c_base (PPI)->direct_declarator (pp_c_base (PPI), D)
|
115 |
|
|
#define pp_direct_abstract_declarator(PP, D) \
|
116 |
|
|
pp_c_base (PP)->direct_abstract_declarator (pp_c_base (PP), D)
|
117 |
|
|
#define pp_ptr_operator(PP, D) \
|
118 |
|
|
pp_c_base (PP)->ptr_operator (pp_c_base (PP), D)
|
119 |
|
|
#define pp_parameter_list(PPI, T) \
|
120 |
|
|
pp_c_base (PPI)->parameter_list (pp_c_base (PPI), T)
|
121 |
|
|
#define pp_type_id(PPI, D) \
|
122 |
|
|
pp_c_base (PPI)->type_id (pp_c_base (PPI), D)
|
123 |
|
|
#define pp_simple_type_specifier(PP, T) \
|
124 |
|
|
pp_c_base (PP)->simple_type_specifier (pp_c_base (PP), T)
|
125 |
|
|
#define pp_function_specifier(PP, D) \
|
126 |
|
|
pp_c_base (PP)->function_specifier (pp_c_base (PP), D)
|
127 |
|
|
#define pp_storage_class_specifier(PP, D) \
|
128 |
|
|
pp_c_base (PP)->storage_class_specifier (pp_c_base (PP), D);
|
129 |
|
|
|
130 |
|
|
#define pp_statement(PPI, S) \
|
131 |
|
|
pp_c_base (PPI)->statement (pp_c_base (PPI), S)
|
132 |
|
|
|
133 |
|
|
#define pp_constant(PP, E) \
|
134 |
|
|
pp_c_base (PP)->constant (pp_c_base (PP), E)
|
135 |
|
|
#define pp_id_expression(PP, E) \
|
136 |
|
|
pp_c_base (PP)->id_expression (pp_c_base (PP), E)
|
137 |
|
|
#define pp_primary_expression(PPI, E) \
|
138 |
|
|
pp_c_base (PPI)->primary_expression (pp_c_base (PPI), E)
|
139 |
|
|
#define pp_postfix_expression(PPI, E) \
|
140 |
|
|
pp_c_base (PPI)->postfix_expression (pp_c_base (PPI), E)
|
141 |
|
|
#define pp_unary_expression(PPI, E) \
|
142 |
|
|
pp_c_base (PPI)->unary_expression (pp_c_base (PPI), E)
|
143 |
|
|
#define pp_initializer(PPI, E) \
|
144 |
|
|
pp_c_base (PPI)->initializer (pp_c_base (PPI), E)
|
145 |
|
|
#define pp_multiplicative_expression(PPI, E) \
|
146 |
|
|
pp_c_base (PPI)->multiplicative_expression (pp_c_base (PPI), E)
|
147 |
|
|
#define pp_conditional_expression(PPI, E) \
|
148 |
|
|
pp_c_base (PPI)->conditional_expression (pp_c_base (PPI), E)
|
149 |
|
|
#define pp_assignment_expression(PPI, E) \
|
150 |
|
|
pp_c_base (PPI)->assignment_expression (pp_c_base (PPI), E)
|
151 |
|
|
#define pp_expression(PP, E) \
|
152 |
|
|
pp_c_base (PP)->expression (pp_c_base (PP), E)
|
153 |
|
|
|
154 |
|
|
|
155 |
|
|
/* Returns the c_pretty_printer base object of PRETTY-PRINTER. This
|
156 |
|
|
macro must be overridden by any subclass of c_pretty_print_info. */
|
157 |
|
|
#define pp_c_base(PP) (PP)
|
158 |
|
|
|
159 |
|
|
extern void pp_c_pretty_printer_init (c_pretty_printer *);
|
160 |
|
|
void pp_c_whitespace (c_pretty_printer *);
|
161 |
|
|
void pp_c_left_paren (c_pretty_printer *);
|
162 |
|
|
void pp_c_right_paren (c_pretty_printer *);
|
163 |
|
|
void pp_c_left_brace (c_pretty_printer *);
|
164 |
|
|
void pp_c_right_brace (c_pretty_printer *);
|
165 |
|
|
void pp_c_left_bracket (c_pretty_printer *);
|
166 |
|
|
void pp_c_right_bracket (c_pretty_printer *);
|
167 |
|
|
void pp_c_dot (c_pretty_printer *);
|
168 |
|
|
void pp_c_ampersand (c_pretty_printer *);
|
169 |
|
|
void pp_c_star (c_pretty_printer *);
|
170 |
|
|
void pp_c_arrow (c_pretty_printer *);
|
171 |
|
|
void pp_c_semicolon (c_pretty_printer *);
|
172 |
|
|
void pp_c_complement (c_pretty_printer *);
|
173 |
|
|
void pp_c_exclamation (c_pretty_printer *);
|
174 |
|
|
void pp_c_space_for_pointer_operator (c_pretty_printer *, tree);
|
175 |
|
|
|
176 |
|
|
/* Declarations. */
|
177 |
|
|
void pp_c_tree_decl_identifier (c_pretty_printer *, tree);
|
178 |
|
|
void pp_c_function_definition (c_pretty_printer *, tree);
|
179 |
|
|
void pp_c_attributes (c_pretty_printer *, tree);
|
180 |
|
|
void pp_c_attributes_display (c_pretty_printer *, tree);
|
181 |
|
|
void pp_c_cv_qualifiers (c_pretty_printer *pp, int qualifiers, bool func_type);
|
182 |
|
|
void pp_c_type_qualifier_list (c_pretty_printer *, tree);
|
183 |
|
|
void pp_c_parameter_type_list (c_pretty_printer *, tree);
|
184 |
|
|
void pp_c_declaration (c_pretty_printer *, tree);
|
185 |
|
|
void pp_c_declaration_specifiers (c_pretty_printer *, tree);
|
186 |
|
|
void pp_c_declarator (c_pretty_printer *, tree);
|
187 |
|
|
void pp_c_direct_declarator (c_pretty_printer *, tree);
|
188 |
|
|
void pp_c_specifier_qualifier_list (c_pretty_printer *, tree);
|
189 |
|
|
void pp_c_function_specifier (c_pretty_printer *, tree);
|
190 |
|
|
void pp_c_type_id (c_pretty_printer *, tree);
|
191 |
|
|
void pp_c_direct_abstract_declarator (c_pretty_printer *, tree);
|
192 |
|
|
void pp_c_type_specifier (c_pretty_printer *, tree);
|
193 |
|
|
void pp_c_storage_class_specifier (c_pretty_printer *, tree);
|
194 |
|
|
/* Statements. */
|
195 |
|
|
void pp_c_statement (c_pretty_printer *, tree);
|
196 |
|
|
/* Expressions. */
|
197 |
|
|
void pp_c_expression (c_pretty_printer *, tree);
|
198 |
|
|
void pp_c_logical_or_expression (c_pretty_printer *, tree);
|
199 |
|
|
void pp_c_expression_list (c_pretty_printer *, tree);
|
200 |
|
|
void pp_c_constructor_elts (c_pretty_printer *, VEC(constructor_elt,gc) *);
|
201 |
|
|
void pp_c_call_argument_list (c_pretty_printer *, tree);
|
202 |
|
|
void pp_c_unary_expression (c_pretty_printer *, tree);
|
203 |
|
|
void pp_c_cast_expression (c_pretty_printer *, tree);
|
204 |
|
|
void pp_c_postfix_expression (c_pretty_printer *, tree);
|
205 |
|
|
void pp_c_primary_expression (c_pretty_printer *, tree);
|
206 |
|
|
void pp_c_init_declarator (c_pretty_printer *, tree);
|
207 |
|
|
void pp_c_constant (c_pretty_printer *, tree);
|
208 |
|
|
void pp_c_id_expression (c_pretty_printer *, tree);
|
209 |
|
|
void pp_c_ws_string (c_pretty_printer *, const char *);
|
210 |
|
|
void pp_c_identifier (c_pretty_printer *, const char *);
|
211 |
|
|
void pp_c_string_literal (c_pretty_printer *, tree);
|
212 |
|
|
|
213 |
|
|
void print_c_tree (FILE *file, tree t);
|
214 |
|
|
|
215 |
|
|
#endif /* GCC_C_PRETTY_PRINTER */
|