gdb/c-lang.h

   1 /* C language support definitions for GDB, the GNU debugger.
   2
   3    Copyright (C) 1992-2022 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 "gdbsupport/enum-flags.h"
  32
  33
  34 /* The various kinds of C string and character.  Note that these
  35    values are chosen so that they may be or'd together in certain
  36    ways.  */
  37 enum c_string_type_values : unsigned
  38   {
  39     /* An ordinary string: "value".  */
  40     C_STRING = 0,
  41     /* A wide string: L"value".  */
  42     C_WIDE_STRING = 1,
  43     /* A 16-bit Unicode string: u"value".  */
  44     C_STRING_16 = 2,
  45     /* A 32-bit Unicode string: U"value".  */
  46     C_STRING_32 = 3,
  47     /* An ordinary char: 'v'.  This can also be or'd with one of the
  48        above to form the corresponding CHAR value from a STRING
  49        value.  */
  50     C_CHAR = 4,
  51     /* A wide char: L'v'.  */
  52     C_WIDE_CHAR = 5,
  53     /* A 16-bit Unicode char: u'v'.  */
  54     C_CHAR_16 = 6,
  55     /* A 32-bit Unicode char: U'v'.  */
  56     C_CHAR_32 = 7
  57   };
  58
  59 DEF_ENUM_FLAGS_TYPE (enum c_string_type_values, c_string_type);
  60
  61 /* Defined in c-exp.y.  */
  62
  63 extern int c_parse (struct parser_state *);
  64
  65 extern int c_parse_escape (const char **, struct obstack *);
  66
  67 /* Defined in c-typeprint.c */
  68
  69 /* Print TYPE to STREAM using syntax appropriate for LANGUAGE, a
  70    C-like language.  The other parameters are like
  71    type_language_defn::print_type's.  */
  72
  73 extern void c_print_type (struct type *type,
  74                           const char *varstring,
  75                           struct ui_file *stream,
  76                           int show, int level,
  77                           enum language language,
  78                           const struct type_print_options *flags);
  79
  80 extern void c_print_typedef (struct type *,
  81                              struct symbol *,
  82                              struct ui_file *);
  83
  84 /* Implement la_value_print_inner for the C family of languages.  */
  85
  86 extern void c_value_print_inner (struct value *, struct ui_file *, int,
  87                                  const struct value_print_options *);
  88
  89 extern void c_value_print (struct value *, struct ui_file *,
  90                            const struct value_print_options *);
  91
  92 /* These are in c-lang.c: */
  93
  94 extern void c_printchar (int, struct type *, struct ui_file *);
  95
  96 extern void c_printstr (struct ui_file * stream,
  97                         struct type *elttype,
  98                         const gdb_byte *string,
  99                         unsigned int length,
 100                         const char *user_encoding,
 101                         int force_ellipses,
 102                         const struct value_print_options *options);
 103
 104 extern void c_language_arch_info (struct gdbarch *gdbarch,
 105                                   struct language_arch_info *lai);
 106
 107 /* These are in c-typeprint.c: */
 108
 109 extern void c_type_print_base (struct type *, struct ui_file *,
 110                                int, int, const struct type_print_options *);
 111
 112 /* These are in cp-valprint.c */
 113
 114 extern void cp_print_class_member (const gdb_byte *, struct type *,
 115                                    struct ui_file *, const char *);
 116
 117 extern void cp_print_value_fields (struct value *,
 118                                    struct ui_file *, int,
 119                                    const struct value_print_options *,
 120                                    struct type **, int);
 121
 122 /* gcc-2.6 or later (when using -fvtable-thunks)
 123    emits a unique named type for a vtable entry.
 124    Some gdb code depends on that specific name.  */
 125
 126 extern const char vtbl_ptr_name[];
 127
 128 extern int cp_is_vtbl_ptr_type (struct type *);
 129
 130 extern int cp_is_vtbl_member (struct type *);
 131
 132 /* Return true if TYPE is a string type.  Unlike DEFAULT_IS_STRING_TYPE_P
 133    this will detect arrays of characters not just TYPE_CODE_STRING.  */
 134
 135 extern bool c_is_string_type_p (struct type *type);
 136
 137 /* These are in c-valprint.c.  */
 138
 139 extern int c_textual_element_type (struct type *, char);
 140
 141 /* Create a new instance of the C compiler and return it.  This
 142    function never returns NULL, but rather throws an exception on
 143    failure.  This is suitable for use as the
 144    language_defn::get_compile_instance method.  */
 145
 146 extern std::unique_ptr<compile_instance> c_get_compile_context ();
 147
 148 /* Create a new instance of the C++ compiler and return it.  This
 149    function never returns NULL, but rather throws an exception on
 150    failure.  This is suitable for use as the
 151    language_defn::get_compile_instance method.  */
 152
 153 extern std::unique_ptr<compile_instance> cplus_get_compile_context ();
 154
 155 /* This takes the user-supplied text and returns a new bit of code to
 156    compile.
 157
 158    This is used as the compute_program language method; see that
 159    for a description of the arguments.  */
 160
 161 extern std::string c_compute_program (compile_instance *inst,
 162                                       const char *input,
 163                                       struct gdbarch *gdbarch,
 164                                       const struct block *expr_block,
 165                                       CORE_ADDR expr_pc);
 166
 167 /* This takes the user-supplied text and returns a new bit of code to compile.
 168
 169    This is used as the compute_program language method; see that
 170    for a description of the arguments.  */
 171
 172 extern std::string cplus_compute_program (compile_instance *inst,
 173                                           const char *input,
 174                                           struct gdbarch *gdbarch,
 175                                           const struct block *expr_block,
 176                                           CORE_ADDR expr_pc);
 177
 178 #endif /* !defined (C_LANG_H) */