GDB (xrefs)
/tmp/gdb-7.10/gdb/cp-support.h
Go to the documentation of this file.
1 /* Helper routines for C++ support in GDB.
2  Copyright (C) 2002-2015 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 
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 
51 {
52  /* The memory used during the parse. */
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 
127 {
128  const char *import_src;
129  const char *import_dest;
130 
131  const char *alias;
132  const char *declaration;
133 
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 typedef const char *(canonicalization_ftype) (struct type *, void *);
153 
154 extern char *cp_canonicalize_string_full (const char *string,
155  canonicalization_ftype *finder,
156  void *data);
157 
158 extern char *cp_class_name_from_physname (const char *physname);
159 
160 extern char *method_name_from_physname (const char *physname);
161 
162 extern unsigned int cp_find_first_component (const char *name);
163 
164 extern unsigned int cp_entire_prefix_len (const char *name);
165 
166 extern char *cp_func_name (const char *full_name);
167 
168 extern char *cp_remove_params (const char *demangled_name);
169 
170 extern struct symbol **make_symbol_overload_list (const char *,
171  const char *);
172 
173 extern struct symbol **make_symbol_overload_list_adl (struct type **arg_types,
174  int nargs,
175  const char *func_name);
176 
177 extern struct type *cp_lookup_rtti_type (const char *name,
178  struct block *block);
179 
180 /* Functions/variables from cp-namespace.c. */
181 
182 extern int cp_is_in_anonymous (const char *symbol_name);
183 
184 extern void cp_add_using_directive (const char *dest,
185  const char *src,
186  const char *alias,
187  const char *declaration,
188  VEC (const_char_ptr) *excludes,
189  int copy_names,
190  struct obstack *obstack);
191 
192 extern void cp_scan_for_anonymous_namespaces (const struct symbol *symbol,
193  struct objfile *objfile);
194 
195 extern struct symbol *cp_lookup_symbol_nonlocal
196  (const struct language_defn *langdef,
197  const char *name,
198  const struct block *block,
199  const domain_enum domain);
200 
201 extern struct symbol *cp_lookup_symbol_namespace (const char *the_namespace,
202  const char *name,
203  const struct block *block,
204  const domain_enum domain);
205 
207  (const char *scope,
208  const char *name,
209  const struct block *block,
210  const domain_enum domain);
211 
212 extern struct symbol *cp_lookup_nested_symbol (struct type *parent_type,
213  const char *nested_name,
214  const struct block *block,
215  const domain_enum domain);
216 
217 struct type *cp_lookup_transparent_type (const char *name);
218 
219 /* See description in cp-namespace.c. */
220 
221 struct type *cp_find_type_baseclass_by_name (struct type *parent_type,
222  const char *name);
223 
224 /* Functions from cp-name-parser.y. */
225 
227  (const char *demangled_name, const char **errmsg);
228 
229 extern char *cp_comp_to_string (struct demangle_component *result,
230  int estimated_len);
231 
234  (struct demangle_parse_info *);
236  struct demangle_component *,
237  struct demangle_parse_info *);
238 
239 extern struct demangle_parse_info *cp_new_demangle_parse_info (void);
240 
241 /* The list of "maint cplus" commands. */
242 
244 
245 /* A wrapper for bfd_demangle. */
246 
247 char *gdb_demangle (const char *name, int options);
248 
249 #endif /* CP_SUPPORT_H */
char * cp_remove_params(const char *demangled_name)
Definition: cp-support.c:880
char * cp_comp_to_string(struct demangle_component *result, int estimated_len)
unsigned int cp_find_first_component(const char *name)
Definition: cp-support.c:964
const char * import_dest
Definition: cp-support.h:129
const char * alias
Definition: cp-support.h:131
const char * import_src
Definition: cp-support.h:128
enum domain_enum_tag domain_enum
char * cp_canonicalize_string(const char *string)
Definition: cp-support.c:587
struct type * cp_lookup_rtti_type(const char *name, struct block *block)
Definition: cp-support.c:1451
struct demangle_component * tree
Definition: cp-support.h:56
#define VEC(T)
Definition: vec.h:398
char * method_name_from_physname(const char *physname)
Definition: cp-support.c:822
struct type * cp_find_type_baseclass_by_name(struct type *parent_type, const char *name)
Definition: cp-namespace.c:881
char * cp_func_name(const char *full_name)
Definition: cp-support.c:855
void cp_demangled_name_parse_free(struct demangle_parse_info *)
struct demangle_info * info
Definition: cp-support.h:53
const char *const name
Definition: aarch64-tdep.c:68
char * cp_canonicalize_string_full(const char *string, canonicalization_ftype *finder, void *data)
Definition: cp-support.c:538
struct symbol ** make_symbol_overload_list(const char *, const char *)
Definition: cp-support.c:1186
const char * excludes[1]
Definition: cp-support.h:142
const char * const_char_ptr
Definition: gdb_vecs.h:26
void cp_scan_for_anonymous_namespaces(const struct symbol *symbol, struct objfile *objfile)
Definition: cp-namespace.c:51
Definition: gdbtypes.h:749
struct obstack obstack
Definition: cp-support.h:59
int cp_is_in_anonymous(const char *symbol_name)
Definition: cp-namespace.c:206
struct symbol ** make_symbol_overload_list_adl(struct type **arg_types, int nargs, const char *func_name)
Definition: cp-support.c:1322
char * cp_canonicalize_string_no_typedefs(const char *string)
Definition: cp-support.c:577
struct demangle_parse_info * cp_new_demangle_parse_info(void)
struct symbol * cp_lookup_symbol_namespace(const char *the_namespace, const char *name, const struct block *block, const domain_enum domain)
Definition: cp-namespace.c:739
void cp_merge_demangle_parse_infos(struct demangle_parse_info *, struct demangle_component *, struct demangle_parse_info *)
Definition: block.h:60
struct using_direct * next
Definition: cp-support.h:134
struct symbol * cp_lookup_symbol_nonlocal(const struct language_defn *langdef, const char *name, const struct block *block, const domain_enum domain)
Definition: cp-namespace.c:843
const char *( canonicalization_ftype)(struct type *, void *)
Definition: cp-support.h:152
struct demangle_parse_info * cp_demangled_name_to_comp(const char *demangled_name, const char **errmsg)
static char errmsg[128]
Definition: procfs.c:415
char * cp_class_name_from_physname(const char *physname)
Definition: cp-support.c:673
struct symbol * cp_lookup_nested_symbol(struct type *parent_type, const char *nested_name, const struct block *block, const domain_enum domain)
Definition: symtab.h:703
struct cmd_list_element * maint_cplus_cmd_list
Definition: cp-support.c:65
const char * declaration
Definition: cp-support.h:132
char * gdb_demangle(const char *name, int options)
Definition: cp-support.c:1529
struct symbol * cp_lookup_symbol_imports_or_template(const char *scope, const char *name, const struct block *block, const domain_enum domain)
Definition: cp-namespace.c:608
__extension__ enum domain_enum_tag domain
Definition: symtab.h:730
unsigned int cp_entire_prefix_len(const char *name)
Definition: cp-support.c:1114
struct type * cp_lookup_transparent_type(const char *name)
struct cleanup * make_cleanup_cp_demangled_name_parse_free(struct demangle_parse_info *)
Definition: cp-support.c:110
void cp_add_using_directive(const char *dest, const char *src, const char *alias, const char *declaration, VEC(const_char_ptr)*excludes, int copy_names, struct obstack *obstack)
Definition: cp-namespace.c:121