gdb/c-lang.h

   1 /* C language support definitions for GDB, the GNU debugger.
   2
   3    Copyright (C) 1992-2018 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20
  21 #if !defined (C_LANG_H)
  22 #define C_LANG_H 1
  23
  24 struct ui_file;
  25 struct language_arch_info;
  26 struct type_print_options;
  27 struct parser_state;
  28
  29 #include "value.h"
  30 #include "macroexp.h"
  31 #include "parser-defs.h"
  32 #include "common/enum-flags.h"
  33
  34
  35 /* The various kinds of C string and character.  Note that these
  36    values are chosen so that they may be or'd together in certain
  37    ways.  */
  38 enum c_string_type_values
  39   {
  40     /* An ordinary string: "value".  */
  41     C_STRING = 0,
  42     /* A wide string: L"value".  */
  43     C_WIDE_STRING = 1,
  44     /* A 16-bit Unicode string: u"value".  */
  45     C_STRING_16 = 2,
  46     /* A 32-bit Unicode string: U"value".  */
  47     C_STRING_32 = 3,
  48     /* An ordinary char: 'v'.  This can also be or'd with one of the
  49        above to form the corresponding CHAR value from a STRING
  50        value.  */
  51     C_CHAR = 4,
  52     /* A wide char: L'v'.  */
  53     C_WIDE_CHAR = 5,
  54     /* A 16-bit Unicode char: u'v'.  */
  55     C_CHAR_16 = 6,
  56     /* A 32-bit Unicode char: U'v'.  */
  57     C_CHAR_32 = 7
  58   };
  59
  60 DEF_ENUM_FLAGS_TYPE (enum c_string_type_values, c_string_type);
  61
  62 /* Defined in c-exp.y.  */
  63
  64 extern int c_parse (struct parser_state *);
  65
  66 extern void c_yyerror (const char *);
  67
  68 extern int c_parse_escape (const char **, struct obstack *);
  69
  70 /* Defined in c-typeprint.c */
  71 extern void c_print_type (struct type *, const char *,
  72                           struct ui_file *, int, int,
  73                           const struct type_print_options *);
  74
  75 extern void c_print_typedef (struct type *,
  76                              struct symbol *,
  77                              struct ui_file *);
  78
  79 extern void c_val_print (struct type *,
  80                          int, CORE_ADDR,
  81                          struct ui_file *, int,
  82                          struct value *,
  83                          const struct value_print_options *);
  84
  85 extern void c_value_print (struct value *, struct ui_file *,
  86                            const struct value_print_options *);
  87
  88 /* These are in c-lang.c: */
  89
  90 extern struct value *evaluate_subexp_c (struct type *expect_type,
  91                                         struct expression *exp,
  92                                         int *pos,
  93                                         enum noside noside);
  94
  95 extern void c_printchar (int, struct type *, struct ui_file *);
  96
  97 extern void c_printstr (struct ui_file * stream,
  98                         struct type *elttype,
  99                         const gdb_byte *string,
 100                         unsigned int length,
 101                         const char *user_encoding,
 102                         int force_ellipses,
 103                         const struct value_print_options *options);
 104
 105 extern void c_language_arch_info (struct gdbarch *gdbarch,
 106                                   struct language_arch_info *lai);
 107
 108 extern const struct exp_descriptor exp_descriptor_c;
 109
 110 extern void c_emit_char (int c, struct type *type,
 111                          struct ui_file *stream, int quoter);
 112
 113 extern const struct op_print c_op_print_tab[];
 114
 115 extern gdb::unique_xmalloc_ptr<char> c_watch_location_expression
 116      (struct type *type, CORE_ADDR addr);
 117
 118 /* These are in c-typeprint.c: */
 119
 120 extern void c_type_print_base (struct type *, struct ui_file *,
 121                                int, int, const struct type_print_options *);
 122
 123 /* These are in cp-valprint.c */
 124
 125 extern void cp_print_class_member (const gdb_byte *, struct type *,
 126                                    struct ui_file *, const char *);
 127
 128 extern void cp_print_value_fields (struct type *, struct type *,
 129                                    LONGEST, CORE_ADDR,
 130                                    struct ui_file *, int,
 131                                    struct value *,
 132                                    const struct value_print_options *,
 133                                    struct type **, int);
 134
 135 extern void cp_print_value_fields_rtti (struct type *,
 136                                         const gdb_byte *, LONGEST, CORE_ADDR,
 137                                         struct ui_file *, int,
 138                                         struct value *,
 139                                         const struct value_print_options *,
 140                                         struct type **, int);
 141
 142 extern int cp_is_vtbl_ptr_type (struct type *);
 143
 144 extern int cp_is_vtbl_member (struct type *);
 145
 146 /* These are in c-valprint.c.  */
 147
 148 extern int c_textual_element_type (struct type *, char);
 149
 150 /* Create a new instance of the C compiler and return it.  The new
 151    compiler is owned by the caller and must be freed using the destroy
 152    method.  This function never returns NULL, but rather throws an
 153    exception on failure.  This is suitable for use as the
 154    la_get_compile_instance language method.  */
 155
 156 extern struct compile_instance *c_get_compile_context (void);
 157
 158 /* This takes the user-supplied text and returns a new bit of code to
 159    compile.
 160
 161    This is used as the la_compute_program language method; see that
 162    for a description of the arguments.  */
 163
 164 extern std::string c_compute_program (struct compile_instance *inst,
 165                                       const char *input,
 166                                       struct gdbarch *gdbarch,
 167                                       const struct block *expr_block,
 168                                       CORE_ADDR expr_pc);
 169
 170 #endif /* !defined (C_LANG_H) */