gdb/cp-support.h

   1 /* Helper routines for C++ support in GDB.
   2    Copyright (C) 2002-2017 Free Software Foundation, Inc.
   3
   4    Contributed by MontaVista Software.
   5    Namespace support contributed by David Carlton.
   6
   7    This file is part of GDB.
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 3 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  21
  22 #ifndef CP_SUPPORT_H
  23 #define CP_SUPPORT_H
  24
  25 /* We need this for 'domain_enum', alas...  */
  26
  27 #include "symtab.h"
  28 #include "vec.h"
  29 #include "gdb_vecs.h"
  30 #include "gdb_obstack.h"
  31
  32 /* Opaque declarations.  */
  33
  34 struct symbol;
  35 struct block;
  36 struct objfile;
  37 struct type;
  38 struct demangle_component;
  39 struct using_direct;
  40
  41 /* A string representing the name of the anonymous namespace used in GDB.  */
  42
  43 #define CP_ANONYMOUS_NAMESPACE_STR "(anonymous namespace)"
  44
  45 /* The length of the string representing the anonymous namespace.  */
  46
  47 #define CP_ANONYMOUS_NAMESPACE_LEN 21
  48
  49 /* A string representing the start of an operator name.  */
  50
  51 #define CP_OPERATOR_STR "operator"
  52
  53 /* The length of CP_OPERATOR_STR.  */
  54
  55 #define CP_OPERATOR_LEN 8
  56
  57 /* The result of parsing a name.  */
  58
  59 struct demangle_parse_info
  60 {
  61   demangle_parse_info ();
  62
  63   ~demangle_parse_info ();
  64
  65   /* The memory used during the parse.  */
  66   struct demangle_info *info;
  67
  68   /* The result of the parse.  */
  69   struct demangle_component *tree;
  70
  71   /* Any temporary memory used during typedef replacement.  */
  72   struct obstack obstack;
  73 };
  74
  75
  76 /* Functions from cp-support.c.  */
  77
  78 extern std::string cp_canonicalize_string (const char *string);
  79
  80 extern std::string cp_canonicalize_string_no_typedefs (const char *string);
  81
  82 typedef const char *(canonicalization_ftype) (struct type *, void *);
  83
  84 extern std::string cp_canonicalize_string_full (const char *string,
  85                                                 canonicalization_ftype *finder,
  86                                                 void *data);
  87
  88 extern char *cp_class_name_from_physname (const char *physname);
  89
  90 extern char *method_name_from_physname (const char *physname);
  91
  92 extern unsigned int cp_find_first_component (const char *name);
  93
  94 extern unsigned int cp_entire_prefix_len (const char *name);
  95
  96 extern char *cp_func_name (const char *full_name);
  97
  98 extern gdb::unique_xmalloc_ptr<char> cp_remove_params
  99   (const char *demanged_name);
 100
 101 extern struct symbol **make_symbol_overload_list (const char *,
 102                                                   const char *);
 103
 104 extern struct symbol **make_symbol_overload_list_adl (struct type **arg_types,
 105                                                       int nargs,
 106                                                       const char *func_name);
 107
 108 extern struct type *cp_lookup_rtti_type (const char *name,
 109                                          struct block *block);
 110
 111 /* Implement the "la_get_symbol_name_matcher" language_defn method for
 112    C++.  */
 113 extern symbol_name_matcher_ftype *cp_get_symbol_name_matcher
 114   (const lookup_name_info &lookup_name);
 115
 116 /* Functions/variables from cp-namespace.c.  */
 117
 118 extern int cp_is_in_anonymous (const char *symbol_name);
 119
 120 extern void cp_scan_for_anonymous_namespaces (const struct symbol *symbol,
 121                                               struct objfile *objfile);
 122
 123 extern struct block_symbol cp_lookup_symbol_nonlocal
 124      (const struct language_defn *langdef,
 125       const char *name,
 126       const struct block *block,
 127       const domain_enum domain);
 128
 129 extern struct block_symbol
 130   cp_lookup_symbol_namespace (const char *the_namespace,
 131                               const char *name,
 132                               const struct block *block,
 133                               const domain_enum domain);
 134
 135 extern struct block_symbol cp_lookup_symbol_imports_or_template
 136      (const char *scope,
 137       const char *name,
 138       const struct block *block,
 139       const domain_enum domain);
 140
 141 extern struct block_symbol
 142   cp_lookup_nested_symbol (struct type *parent_type,
 143                            const char *nested_name,
 144                            const struct block *block,
 145                            const domain_enum domain);
 146
 147 struct type *cp_lookup_transparent_type (const char *name);
 148
 149 /* See description in cp-namespace.c.  */
 150
 151 struct type *cp_find_type_baseclass_by_name (struct type *parent_type,
 152                                              const char *name);
 153
 154 /* Functions from cp-name-parser.y.  */
 155
 156 extern std::unique_ptr<demangle_parse_info> cp_demangled_name_to_comp
 157      (const char *demangled_name, const char **errmsg);
 158
 159 extern gdb::unique_xmalloc_ptr<char> cp_comp_to_string
 160   (struct demangle_component *result, int estimated_len);
 161
 162 extern void cp_merge_demangle_parse_infos (struct demangle_parse_info *,
 163                                            struct demangle_component *,
 164                                            struct demangle_parse_info *);
 165
 166 /* The list of "maint cplus" commands.  */
 167
 168 extern struct cmd_list_element *maint_cplus_cmd_list;
 169
 170 /* A wrapper for bfd_demangle.  */
 171
 172 char *gdb_demangle (const char *name, int options);
 173
 174 /* Like gdb_demangle, but suitable for use as la_sniff_from_mangled_name.  */
 175
 176 int gdb_sniff_from_mangled_name (const char *mangled, char **demangled);
 177
 178 #endif /* CP_SUPPORT_H */