gdb/cp-support.h

   1 /* Helper routines for C++ support in GDB.
   2    Copyright (C) 2002, 2003, 2004, 2005, 2007, 2008, 2009, 2010, 2011
   3    Free Software Foundation, Inc.
   4
   5    Contributed by MontaVista Software.
   6    Namespace support contributed by David Carlton.
   7
   8    This file is part of GDB.
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 3 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  22
  23 #ifndef CP_SUPPORT_H
  24 #define CP_SUPPORT_H
  25
  26 /* We need this for 'domain_enum', alas...  */
  27
  28 #include "symtab.h"
  29 #include "vec.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
  40 /* A string representing the name of the anonymous namespace used in GDB.  */
  41
  42 #define CP_ANONYMOUS_NAMESPACE_STR "(anonymous namespace)"
  43
  44 /* The length of the string representing the anonymous namespace.  */
  45
  46 #define CP_ANONYMOUS_NAMESPACE_LEN 21
  47
  48 /* The result of parsing a name.  */
  49
  50 struct demangle_parse_info
  51 {
  52   /* The memory used during the parse.  */
  53   struct demangle_info *info;
  54
  55   /* The result of the parse.  */
  56   struct demangle_component *tree;
  57
  58   /* Any temporary memory used during typedef replacement.  */
  59   struct obstack obstack;
  60 };
  61
  62 /* This struct is designed to store data from using directives.  It
  63    says that names from namespace IMPORT_SRC should be visible within
  64    namespace IMPORT_DEST.  These form a linked list; NEXT is the next
  65    element of the list.  If the imported namespace or declaration has
  66    been aliased within the IMPORT_DEST namespace, ALIAS is set to a
  67    string representing the alias.  Otherwise, ALIAS is NULL.
  68    DECLARATION is the name of the imported declaration, if this import
  69    statement represents one.  Otherwise DECLARATION is NULL and this
  70    import statement represents a namespace.
  71
  72    C++:      using namespace A;
  73    Fortran:  use A
  74    import_src = "A"
  75    import_dest = local scope of the import statement even such as ""
  76    alias = NULL
  77    declaration = NULL
  78    excludes = NULL
  79
  80    C++:      using A::x;
  81    Fortran:  use A, only: x
  82    import_src = "A"
  83    import_dest = local scope of the import statement even such as ""
  84    alias = NULL
  85    declaration = "x"
  86    excludes = NULL
  87    The declaration will get imported as import_dest::x.
  88
  89    C++ has no way to import all names except those listed ones.
  90    Fortran:  use A, localname => x
  91    import_src = "A"
  92    import_dest = local scope of the import statement even such as ""
  93    alias = "localname"
  94    declaration = "x"
  95    excludes = NULL
  96    +
  97    import_src = "A"
  98    import_dest = local scope of the import statement even such as ""
  99    alias = NULL
 100    declaration = NULL
 101    excludes = ["x"]
 102    All the entries of A get imported except of "x".  "x" gets imported as
 103    "localname".  "x" is not defined as a local name by this statement.
 104
 105    C++:      namespace LOCALNS = A;
 106    Fortran has no way to address non-local namespace/module.
 107    import_src = "A"
 108    import_dest = local scope of the import statement even such as ""
 109    alias = "LOCALNS"
 110    declaration = NULL
 111    excludes = NULL
 112    The namespace will get imported as the import_dest::LOCALNS
 113    namespace.
 114
 115    C++ cannot express it, it would be something like: using localname
 116    = A::x;
 117    Fortran:  use A, only localname => x
 118    import_src = "A"
 119    import_dest = local scope of the import statement even such as ""
 120    alias = "localname"
 121    declaration = "x"
 122    excludes = NULL
 123    The declaration will get imported as localname or
 124    `import_dest`localname.  */
 125
 126 struct using_direct
 127 {
 128   char *import_src;
 129   char *import_dest;
 130
 131   char *alias;
 132   char *declaration;
 133
 134   struct using_direct *next;
 135
 136   /* Used during import search to temporarily mark this node as
 137      searched.  */
 138   int searched;
 139
 140   /* USING_DIRECT has variable allocation size according to the number of
 141      EXCLUDES entries, the last entry is NULL.  */
 142   const char *excludes[1];
 143 };
 144
 145
 146 /* Functions from cp-support.c.  */
 147
 148 extern char *cp_canonicalize_string (const char *string);
 149
 150 extern char *cp_canonicalize_string_no_typedefs (const char *string);
 151
 152 extern char *cp_class_name_from_physname (const char *physname);
 153
 154 extern char *method_name_from_physname (const char *physname);
 155
 156 extern unsigned int cp_find_first_component (const char *name);
 157
 158 extern unsigned int cp_entire_prefix_len (const char *name);
 159
 160 extern char *cp_func_name (const char *full_name);
 161
 162 extern char *cp_remove_params (const char *demangled_name);
 163
 164 extern struct symbol **make_symbol_overload_list (const char *,
 165                                                   const char *);
 166
 167 extern struct symbol **make_symbol_overload_list_adl (struct type **arg_types,
 168                                                       int nargs,
 169                                                       const char *func_name);
 170
 171 extern struct type *cp_lookup_rtti_type (const char *name,
 172                                          struct block *block);
 173
 174 extern int cp_validate_operator (const char *input);
 175
 176 /* Functions/variables from cp-namespace.c.  */
 177
 178 extern int cp_is_anonymous (const char *namespace);
 179
 180 DEF_VEC_P (const_char_ptr);
 181
 182 extern void cp_add_using_directive (const char *dest,
 183                                     const char *src,
 184                                     const char *alias,
 185                                     const char *declaration,
 186                                     VEC (const_char_ptr) *excludes,
 187                                     struct obstack *obstack);
 188
 189 extern void cp_initialize_namespace (void);
 190
 191 extern void cp_finalize_namespace (struct block *static_block,
 192                                    struct obstack *obstack);
 193
 194 extern void cp_set_block_scope (const struct symbol *symbol,
 195                                 struct block *block,
 196                                 struct obstack *obstack,
 197                                 const char *processing_current_prefix,
 198                                 int processing_has_namespace_info);
 199
 200 extern void cp_scan_for_anonymous_namespaces (const struct symbol *symbol,
 201                                               struct objfile *objfile);
 202
 203 extern struct symbol *cp_lookup_symbol_nonlocal (const char *name,
 204                                                  const struct block *block,
 205                                                  const domain_enum domain);
 206
 207 extern struct symbol *cp_lookup_symbol_namespace (const char *namespace,
 208                                                   const char *name,
 209                                                   const struct block *block,
 210                                                   const domain_enum domain);
 211
 212 extern struct symbol *cp_lookup_symbol_imports (const char *scope,
 213                                                 const char *name,
 214                                                 const struct block *block,
 215                                                 const domain_enum domain,
 216                                                 const int declaration_only,
 217                                                 const int search_parents);
 218
 219 extern struct symbol *cp_lookup_symbol_imports_or_template
 220      (const char *scope,
 221       const char *name,
 222       const struct block *block,
 223       const domain_enum domain);
 224
 225 extern struct type *cp_lookup_nested_type (struct type *parent_type,
 226                                            const char *nested_name,
 227                                            const struct block *block);
 228
 229 struct type *cp_lookup_transparent_type (const char *name);
 230
 231 /* Functions from cp-name-parser.y.  */
 232
 233 extern struct demangle_parse_info *cp_demangled_name_to_comp
 234      (const char *demangled_name, const char **errmsg);
 235
 236 extern char *cp_comp_to_string (struct demangle_component *result,
 237                                 int estimated_len);
 238
 239 extern void cp_demangled_name_parse_free (struct demangle_parse_info *);
 240 extern struct cleanup *make_cleanup_cp_demangled_name_parse_free
 241      (struct demangle_parse_info *);
 242 extern void cp_merge_demangle_parse_infos (struct demangle_parse_info *,
 243                                            struct demangle_component *,
 244                                            struct demangle_parse_info *);
 245
 246 extern struct demangle_parse_info *cp_new_demangle_parse_info (void);
 247
 248 /* The list of "maint cplus" commands.  */
 249
 250 extern struct cmd_list_element *maint_cplus_cmd_list;
 251
 252 #endif /* CP_SUPPORT_H */