1 /* Helper routines for C++ support in GDB.
2 Copyright (C) 2002-2014 Free Software Foundation, Inc.
4 Contributed by MontaVista Software.
5 Namespace support contributed by David Carlton.
7 This file is part of GDB.
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.
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.
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/>. */
25 /* We need this for 'domain_enum', alas... */
30 #include "gdb_obstack.h"
32 /* Opaque declarations. */
38 struct demangle_component;
40 /* A string representing the name of the anonymous namespace used in GDB. */
42 #define CP_ANONYMOUS_NAMESPACE_STR "(anonymous namespace)"
44 /* The length of the string representing the anonymous namespace. */
46 #define CP_ANONYMOUS_NAMESPACE_LEN 21
48 /* The result of parsing a name. */
50 struct demangle_parse_info
52 /* The memory used during the parse. */
53 struct demangle_info *info;
55 /* The result of the parse. */
56 struct demangle_component *tree;
58 /* Any temporary memory used during typedef replacement. */
59 struct obstack obstack;
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.
72 C++: using namespace A;
75 import_dest = local scope of the import statement even such as ""
81 Fortran: use A, only: x
83 import_dest = local scope of the import statement even such as ""
87 The declaration will get imported as import_dest::x.
89 C++ has no way to import all names except those listed ones.
90 Fortran: use A, localname => x
92 import_dest = local scope of the import statement even such as ""
98 import_dest = local scope of the import statement even such as ""
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.
105 C++: namespace LOCALNS = A;
106 Fortran has no way to address non-local namespace/module.
108 import_dest = local scope of the import statement even such as ""
112 The namespace will get imported as the import_dest::LOCALNS
115 C++ cannot express it, it would be something like: using localname
117 Fortran: use A, only localname => x
119 import_dest = local scope of the import statement even such as ""
123 The declaration will get imported as localname or
124 `import_dest`localname. */
128 const char *import_src;
129 const char *import_dest;
132 const char *declaration;
134 struct using_direct *next;
136 /* Used during import search to temporarily mark this node as
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];
146 /* Functions from cp-support.c. */
148 extern char *cp_canonicalize_string (const char *string);
150 extern char *cp_canonicalize_string_no_typedefs (const char *string);
152 typedef const char *(canonicalization_ftype) (struct type *, void *);
154 extern char *cp_canonicalize_string_full (const char *string,
155 canonicalization_ftype *finder,
158 extern char *cp_class_name_from_physname (const char *physname);
160 extern char *method_name_from_physname (const char *physname);
162 extern unsigned int cp_find_first_component (const char *name);
164 extern unsigned int cp_entire_prefix_len (const char *name);
166 extern char *cp_func_name (const char *full_name);
168 extern char *cp_remove_params (const char *demangled_name);
170 extern struct symbol **make_symbol_overload_list (const char *,
173 extern struct symbol **make_symbol_overload_list_adl (struct type **arg_types,
175 const char *func_name);
177 extern struct type *cp_lookup_rtti_type (const char *name,
178 struct block *block);
180 /* Functions/variables from cp-namespace.c. */
182 extern int cp_is_in_anonymous (const char *symbol_name);
184 extern void cp_add_using_directive (const char *dest,
187 const char *declaration,
188 VEC (const_char_ptr) *excludes,
190 struct obstack *obstack);
192 extern void cp_scan_for_anonymous_namespaces (const struct symbol *symbol,
193 struct objfile *objfile);
195 extern struct symbol *cp_lookup_symbol_nonlocal
196 (const struct language_defn *langdef,
198 const struct block *block,
199 const domain_enum domain);
201 extern struct symbol *cp_lookup_symbol_namespace (const char *namespace,
203 const struct block *block,
204 const domain_enum domain);
206 extern struct symbol *cp_lookup_symbol_imports_or_template
209 const struct block *block,
210 const domain_enum domain);
212 extern struct symbol *cp_lookup_nested_symbol (struct type *parent_type,
213 const char *nested_name,
214 const struct block *block);
216 struct type *cp_lookup_transparent_type (const char *name);
218 /* See description in cp-namespace.c. */
220 struct type *cp_find_type_baseclass_by_name (struct type *parent_type,
223 /* Functions from cp-name-parser.y. */
225 extern struct demangle_parse_info *cp_demangled_name_to_comp
226 (const char *demangled_name, const char **errmsg);
228 extern char *cp_comp_to_string (struct demangle_component *result,
231 extern void cp_demangled_name_parse_free (struct demangle_parse_info *);
232 extern struct cleanup *make_cleanup_cp_demangled_name_parse_free
233 (struct demangle_parse_info *);
234 extern void cp_merge_demangle_parse_infos (struct demangle_parse_info *,
235 struct demangle_component *,
236 struct demangle_parse_info *);
238 extern struct demangle_parse_info *cp_new_demangle_parse_info (void);
240 /* The list of "maint cplus" commands. */
242 extern struct cmd_list_element *maint_cplus_cmd_list;
244 /* A wrapper for bfd_demangle. */
246 char *gdb_demangle (const char *name, int options);
248 #endif /* CP_SUPPORT_H */