gdb/cp-support.h

   1 /* Helper routines for C++ support in GDB.
   2    Copyright (C) 2002-2005, 2007-2012 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_obstack.h"
  30
  31 /* Opaque declarations.  */
  32
  33 struct symbol;
  34 struct block;
  35 struct objfile;
  36 struct type;
  37 struct demangle_component;
  38
  39 /* A string representing the name of the anonymous namespace used in GDB.  */
  40
  41 #define CP_ANONYMOUS_NAMESPACE_STR "(anonymous namespace)"
  42
  43 /* The length of the string representing the anonymous namespace.  */
  44
  45 #define CP_ANONYMOUS_NAMESPACE_LEN 21
  46
  47 /* The result of parsing a name.  */
  48
  49 struct demangle_parse_info
  50 {
  51   /* The memory used during the parse.  */
  52   struct demangle_info *info;
  53
  54   /* The result of the parse.  */
  55   struct demangle_component *tree;
  56
  57   /* Any temporary memory used during typedef replacement.  */
  58   struct obstack obstack;
  59 };
  60
  61 /* This struct is designed to store data from using directives.  It
  62    says that names from namespace IMPORT_SRC should be visible within
  63    namespace IMPORT_DEST.  These form a linked list; NEXT is the next
  64    element of the list.  If the imported namespace or declaration has
  65    been aliased within the IMPORT_DEST namespace, ALIAS is set to a
  66    string representing the alias.  Otherwise, ALIAS is NULL.
  67    DECLARATION is the name of the imported declaration, if this import
  68    statement represents one.  Otherwise DECLARATION is NULL and this
  69    import statement represents a namespace.
  70
  71    C++:      using namespace A;
  72    Fortran:  use A
  73    import_src = "A"
  74    import_dest = local scope of the import statement even such as ""
  75    alias = NULL
  76    declaration = NULL
  77    excludes = NULL
  78
  79    C++:      using A::x;
  80    Fortran:  use A, only: x
  81    import_src = "A"
  82    import_dest = local scope of the import statement even such as ""
  83    alias = NULL
  84    declaration = "x"
  85    excludes = NULL
  86    The declaration will get imported as import_dest::x.
  87
  88    C++ has no way to import all names except those listed ones.
  89    Fortran:  use A, localname => x
  90    import_src = "A"
  91    import_dest = local scope of the import statement even such as ""
  92    alias = "localname"
  93    declaration = "x"
  94    excludes = NULL
  95    +
  96    import_src = "A"
  97    import_dest = local scope of the import statement even such as ""
  98    alias = NULL
  99    declaration = NULL
 100    excludes = ["x"]
 101    All the entries of A get imported except of "x".  "x" gets imported as
 102    "localname".  "x" is not defined as a local name by this statement.
 103
 104    C++:      namespace LOCALNS = A;
 105    Fortran has no way to address non-local namespace/module.
 106    import_src = "A"
 107    import_dest = local scope of the import statement even such as ""
 108    alias = "LOCALNS"
 109    declaration = NULL
 110    excludes = NULL
 111    The namespace will get imported as the import_dest::LOCALNS
 112    namespace.
 113
 114    C++ cannot express it, it would be something like: using localname
 115    = A::x;
 116    Fortran:  use A, only localname => x
 117    import_src = "A"
 118    import_dest = local scope of the import statement even such as ""
 119    alias = "localname"
 120    declaration = "x"
 121    excludes = NULL
 122    The declaration will get imported as localname or
 123    `import_dest`localname.  */
 124
 125 struct using_direct
 126 {
 127   char *import_src;
 128   char *import_dest;
 129
 130   char *alias;
 131   char *declaration;
 132
 133   struct using_direct *next;
 134
 135   /* Used during import search to temporarily mark this node as
 136      searched.  */
 137   int searched;
 138
 139   /* USING_DIRECT has variable allocation size according to the number of
 140      EXCLUDES entries, the last entry is NULL.  */
 141   const char *excludes[1];
 142 };
 143
 144
 145 /* Functions from cp-support.c.  */
 146
 147 extern char *cp_canonicalize_string (const char *string);
 148
 149 extern char *cp_canonicalize_string_no_typedefs (const char *string);
 150
 151 extern char *cp_class_name_from_physname (const char *physname);
 152
 153 extern char *method_name_from_physname (const char *physname);
 154
 155 extern unsigned int cp_find_first_component (const char *name);
 156
 157 extern unsigned int cp_entire_prefix_len (const char *name);
 158
 159 extern char *cp_func_name (const char *full_name);
 160
 161 extern char *cp_remove_params (const char *demangled_name);
 162
 163 extern struct symbol **make_symbol_overload_list (const char *,
 164                                                   const char *);
 165
 166 extern struct symbol **make_symbol_overload_list_adl (struct type **arg_types,
 167                                                       int nargs,
 168                                                       const char *func_name);
 169
 170 extern struct type *cp_lookup_rtti_type (const char *name,
 171                                          struct block *block);
 172
 173 extern int cp_validate_operator (const char *input);
 174
 175 /* Functions/variables from cp-namespace.c.  */
 176
 177 extern int cp_is_anonymous (const char *namespace);
 178
 179 DEF_VEC_P (const_char_ptr);
 180
 181 extern void cp_add_using_directive (const char *dest,
 182                                     const char *src,
 183                                     const char *alias,
 184                                     const char *declaration,
 185                                     VEC (const_char_ptr) *excludes,
 186                                     struct obstack *obstack);
 187
 188 extern void cp_initialize_namespace (void);
 189
 190 extern void cp_finalize_namespace (struct block *static_block,
 191                                    struct obstack *obstack);
 192
 193 extern void cp_set_block_scope (const struct symbol *symbol,
 194                                 struct block *block,
 195                                 struct obstack *obstack,
 196                                 const char *processing_current_prefix,
 197                                 int processing_has_namespace_info);
 198
 199 extern void cp_scan_for_anonymous_namespaces (const struct symbol *symbol,
 200                                               struct objfile *objfile);
 201
 202 extern struct symbol *cp_lookup_symbol_nonlocal (const char *name,
 203                                                  const struct block *block,
 204                                                  const domain_enum domain);
 205
 206 extern struct symbol *cp_lookup_symbol_namespace (const char *namespace,
 207                                                   const char *name,
 208                                                   const struct block *block,
 209                                                   const domain_enum domain);
 210
 211 extern struct symbol *cp_lookup_symbol_imports (const char *scope,
 212                                                 const char *name,
 213                                                 const struct block *block,
 214                                                 const domain_enum domain,
 215                                                 const int declaration_only,
 216                                                 const int search_parents);
 217
 218 extern struct symbol *cp_lookup_symbol_imports_or_template
 219      (const char *scope,
 220       const char *name,
 221       const struct block *block,
 222       const domain_enum domain);
 223
 224 extern struct type *cp_lookup_nested_type (struct type *parent_type,
 225                                            const char *nested_name,
 226                                            const struct block *block);
 227
 228 struct type *cp_lookup_transparent_type (const char *name);
 229
 230 /* Functions from cp-name-parser.y.  */
 231
 232 extern struct demangle_parse_info *cp_demangled_name_to_comp
 233      (const char *demangled_name, const char **errmsg);
 234
 235 extern char *cp_comp_to_string (struct demangle_component *result,
 236                                 int estimated_len);
 237
 238 extern void cp_demangled_name_parse_free (struct demangle_parse_info *);
 239 extern struct cleanup *make_cleanup_cp_demangled_name_parse_free
 240      (struct demangle_parse_info *);
 241 extern void cp_merge_demangle_parse_infos (struct demangle_parse_info *,
 242                                            struct demangle_component *,
 243                                            struct demangle_parse_info *);
 244
 245 extern struct demangle_parse_info *cp_new_demangle_parse_info (void);
 246
 247 /* The list of "maint cplus" commands.  */
 248
 249 extern struct cmd_list_element *maint_cplus_cmd_list;
 250
 251 #endif /* CP_SUPPORT_H */