1 /* Various declarations for the C and C++ pretty-printers. 2 Copyright (C) 2002-2018 Free Software Foundation, Inc. 3 Contributed by Gabriel Dos Reis <gdr@integrable-solutions.net> 4 5 This file is part of GCC. 6 7 GCC is free software; you can redistribute it and/or modify it under 8 the terms of the GNU General Public License as published by the Free 9 Software Foundation; either version 3, or (at your option) any later 10 version. 11 12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY 13 WARRANTY; without even the implied warranty of MERCHANTABILITY or 14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 15 for more details. 16 17 You should have received a copy of the GNU General Public License 18 along with GCC; see the file COPYING3. If not see 19 <http://www.gnu.org/licenses/>. */ 20 21 #ifndef GCC_C_PRETTY_PRINTER 22 #define GCC_C_PRETTY_PRINTER 23 24 #include "tree.h" 25 #include "c-family/c-common.h" 26 #include "pretty-print.h" 27 28 29 enum pp_c_pretty_print_flags 30 { 31 pp_c_flag_abstract = 1 << 1, 32 pp_c_flag_gnu_v3 = 1 << 2, 33 pp_c_flag_last_bit = 3 34 }; 35 36 37 /* The data type used to bundle information necessary for pretty-printing 38 a C or C++ entity. */ 39 struct 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 syntax can derive from this datatype and reuse 47 facilities provided here. A derived pretty-printer can override 48 any function listed in the vtable below. See cp/cxx-pretty-print.h 49 and cp/cxx-pretty-print.c for an example of derivation. */ 50 struct c_pretty_printer : pretty_printer 51 { 52 c_pretty_printer (); 53 54 // Format string, possibly translated. 55 void translate_string (const char *); 56 57 virtual void constant (tree); 58 virtual void id_expression (tree); 59 virtual void primary_expression (tree); 60 virtual void postfix_expression (tree); 61 virtual void unary_expression (tree); 62 virtual void multiplicative_expression (tree); 63 virtual void conditional_expression (tree); 64 virtual void assignment_expression (tree); 65 virtual void expression (tree); 66 67 virtual void type_id (tree); 68 virtual void statement (tree); 69 70 virtual void declaration (tree); 71 virtual void declaration_specifiers (tree); 72 virtual void simple_type_specifier (tree); 73 virtual void function_specifier (tree); 74 virtual void storage_class_specifier (tree); 75 virtual void declarator (tree); 76 virtual void direct_declarator (tree); 77 virtual void abstract_declarator (tree); 78 virtual void direct_abstract_declarator (tree); 79 80 virtual void initializer (tree); 81 /* Points to the first element of an array of offset-list. 82 Not used yet. */ 83 int *offset_list; 84 85 pp_flags flags; 86 87 /* These must be overridden by each of the C and C++ front-end to 88 reflect their understanding of syntactic productions when they differ. */ 89 c_pretty_print_fn type_specifier_seq; 90 c_pretty_print_fn ptr_operator; 91 c_pretty_print_fn parameter_list; 92 }; 93 94 #define pp_c_tree_identifier(PPI, ID) \ 95 pp_c_identifier (PPI, IDENTIFIER_POINTER (ID)) 96 97 #define pp_type_specifier_seq(PP, D) (PP)->type_specifier_seq (PP, D) 98 #define pp_ptr_operator(PP, D) (PP)->ptr_operator (PP, D) 99 #define pp_parameter_list(PP, T) (PP)->parameter_list (PP, T) 100 101 void pp_c_whitespace (c_pretty_printer *); 102 void pp_c_left_paren (c_pretty_printer *); 103 void pp_c_right_paren (c_pretty_printer *); 104 void pp_c_left_brace (c_pretty_printer *); 105 void pp_c_right_brace (c_pretty_printer *); 106 void pp_c_left_bracket (c_pretty_printer *); 107 void pp_c_right_bracket (c_pretty_printer *); 108 void pp_c_dot (c_pretty_printer *); 109 void pp_c_ampersand (c_pretty_printer *); 110 void pp_c_star (c_pretty_printer *); 111 void pp_c_arrow (c_pretty_printer *); 112 void pp_c_semicolon (c_pretty_printer *); 113 void pp_c_complement (c_pretty_printer *); 114 void pp_c_exclamation (c_pretty_printer *); 115 void pp_c_space_for_pointer_operator (c_pretty_printer *, tree); 116 117 /* Declarations. */ 118 void pp_c_tree_decl_identifier (c_pretty_printer *, tree); 119 void pp_c_function_definition (c_pretty_printer *, tree); 120 void pp_c_attributes (c_pretty_printer *, tree); 121 void pp_c_attributes_display (c_pretty_printer *, tree); 122 void pp_c_cv_qualifiers (c_pretty_printer *pp, int qualifiers, bool func_type); 123 void pp_c_type_qualifier_list (c_pretty_printer *, tree); 124 void pp_c_parameter_type_list (c_pretty_printer *, tree); 125 void pp_c_specifier_qualifier_list (c_pretty_printer *, tree); 126 /* Expressions. */ 127 void pp_c_logical_or_expression (c_pretty_printer *, tree); 128 void pp_c_expression_list (c_pretty_printer *, tree); 129 void pp_c_constructor_elts (c_pretty_printer *, vec<constructor_elt, va_gc> *); 130 void pp_c_call_argument_list (c_pretty_printer *, tree); 131 void pp_c_cast_expression (c_pretty_printer *, tree); 132 void pp_c_init_declarator (c_pretty_printer *, tree); 133 void pp_c_ws_string (c_pretty_printer *, const char *); 134 void pp_c_identifier (c_pretty_printer *, const char *); 135 void pp_c_string_literal (c_pretty_printer *, tree); 136 137 void print_c_tree (FILE *file, tree t); 138 139 #endif /* GCC_C_PRETTY_PRINTER */ 140