]>
Commit | Line | Data |
---|---|---|
de17c821 | 1 | /* Helper routines for C++ support in GDB. |
1d506c26 | 2 | Copyright (C) 2002-2024 Free Software Foundation, Inc. |
de17c821 DJ |
3 | |
4 | Contributed by MontaVista Software. | |
9219021c | 5 | Namespace support contributed by David Carlton. |
de17c821 DJ |
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 | |
a9762ec7 | 11 | the Free Software Foundation; either version 3 of the License, or |
de17c821 DJ |
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 | |
a9762ec7 | 20 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
de17c821 | 21 | |
9219021c DC |
22 | #ifndef CP_SUPPORT_H |
23 | #define CP_SUPPORT_H | |
24 | ||
1fcb5155 | 25 | #include "symtab.h" |
268a13a5 | 26 | #include "gdbsupport/gdb_vecs.h" |
bf31fd38 | 27 | #include "gdbsupport/gdb_obstack.h" |
268a13a5 | 28 | #include "gdbsupport/array-view.h" |
0891c3cc | 29 | #include <vector> |
32019081 | 30 | |
9219021c DC |
31 | /* Opaque declarations. */ |
32 | ||
b59661bd | 33 | struct symbol; |
9219021c | 34 | struct block; |
80e649fc | 35 | struct buildsym_compunit; |
4a4b3fed | 36 | struct objfile; |
362ff856 | 37 | struct type; |
fb4c6eba | 38 | struct demangle_component; |
22cee43f | 39 | struct using_direct; |
9219021c | 40 | |
2b1dbab0 KS |
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 | ||
8090b426 PA |
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 | ||
3a93a0c2 KS |
57 | /* The result of parsing a name. */ |
58 | ||
59 | struct demangle_parse_info | |
60 | { | |
c8b23b3f TT |
61 | demangle_parse_info (); |
62 | ||
63 | ~demangle_parse_info (); | |
64 | ||
3a93a0c2 KS |
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 | ||
9219021c DC |
75 | |
76 | /* Functions from cp-support.c. */ | |
77 | ||
596dc4ad TT |
78 | extern gdb::unique_xmalloc_ptr<char> cp_canonicalize_string |
79 | (const char *string); | |
fb4c6eba | 80 | |
596dc4ad TT |
81 | extern gdb::unique_xmalloc_ptr<char> cp_canonicalize_string_no_typedefs |
82 | (const char *string); | |
3a93a0c2 | 83 | |
2621e0fd TT |
84 | typedef const char *(canonicalization_ftype) (struct type *, void *); |
85 | ||
596dc4ad TT |
86 | extern gdb::unique_xmalloc_ptr<char> cp_canonicalize_string_full |
87 | (const char *string, canonicalization_ftype *finder, void *data); | |
2621e0fd | 88 | |
31c27f77 | 89 | extern char *cp_class_name_from_physname (const char *physname); |
de17c821 DJ |
90 | |
91 | extern char *method_name_from_physname (const char *physname); | |
9219021c DC |
92 | |
93 | extern unsigned int cp_find_first_component (const char *name); | |
94 | ||
95 | extern unsigned int cp_entire_prefix_len (const char *name); | |
96 | ||
06d3e5b0 | 97 | extern gdb::unique_xmalloc_ptr<char> cp_func_name (const char *full_name); |
8d577d32 | 98 | |
109483d9 | 99 | extern gdb::unique_xmalloc_ptr<char> cp_remove_params |
33b5899f | 100 | (const char *demangled_name); |
3567439c | 101 | |
c62446b1 PA |
102 | /* DEMANGLED_NAME is the name of a function, (optionally) including |
103 | parameters and (optionally) a return type. Return the name of the | |
104 | function without parameters or return type, or NULL if we can not | |
105 | parse the name. If COMPLETION_MODE is true, then tolerate a | |
106 | non-existing or unbalanced parameter list. */ | |
107 | extern gdb::unique_xmalloc_ptr<char> cp_remove_params_if_any | |
108 | (const char *demangled_name, bool completion_mode); | |
109 | ||
0891c3cc PA |
110 | extern std::vector<symbol *> make_symbol_overload_list (const char *, |
111 | const char *); | |
9219021c | 112 | |
0891c3cc PA |
113 | extern void add_symbol_overload_list_adl |
114 | (gdb::array_view<type *> arg_types, | |
115 | const char *func_name, | |
116 | std::vector<symbol *> *overload_list); | |
7322dca9 | 117 | |
362ff856 | 118 | extern struct type *cp_lookup_rtti_type (const char *name, |
582942f4 | 119 | const struct block *block); |
362ff856 | 120 | |
a20714ff PA |
121 | /* Produce an unsigned hash value from SEARCH_NAME that is compatible |
122 | with cp_symbol_name_matches. Only the last component in | |
123 | "foo::bar::function()" is considered for hashing purposes (i.e., | |
124 | the entire prefix is skipped), so that later on looking up for | |
125 | "function" or "bar::function" in all namespaces is possible. */ | |
126 | extern unsigned int cp_search_name_hash (const char *search_name); | |
127 | ||
c9debfb9 | 128 | /* Implement the "get_symbol_name_matcher" language_defn method for C++. */ |
b5ec771e PA |
129 | extern symbol_name_matcher_ftype *cp_get_symbol_name_matcher |
130 | (const lookup_name_info &lookup_name); | |
131 | ||
9219021c DC |
132 | /* Functions/variables from cp-namespace.c. */ |
133 | ||
59da4d04 | 134 | extern int cp_is_in_anonymous (const char *symbol_name); |
9219021c | 135 | |
80e649fc TT |
136 | extern void cp_scan_for_anonymous_namespaces (struct buildsym_compunit *, |
137 | const struct symbol *symbol, | |
a10964d1 | 138 | struct objfile *objfile); |
9219021c | 139 | |
d12307c1 | 140 | extern struct block_symbol cp_lookup_symbol_nonlocal |
f606139a DE |
141 | (const struct language_defn *langdef, |
142 | const char *name, | |
143 | const struct block *block, | |
144 | const domain_enum domain); | |
1fcb5155 | 145 | |
d12307c1 PMR |
146 | extern struct block_symbol |
147 | cp_lookup_symbol_namespace (const char *the_namespace, | |
148 | const char *name, | |
149 | const struct block *block, | |
150 | const domain_enum domain); | |
13387711 | 151 | |
d12307c1 | 152 | extern struct block_symbol cp_lookup_symbol_imports_or_template |
34eaf542 TT |
153 | (const char *scope, |
154 | const char *name, | |
155 | const struct block *block, | |
156 | const domain_enum domain); | |
157 | ||
d12307c1 PMR |
158 | extern struct block_symbol |
159 | cp_lookup_nested_symbol (struct type *parent_type, | |
160 | const char *nested_name, | |
161 | const struct block *block, | |
162 | const domain_enum domain); | |
79c2c32d | 163 | |
b368761e DC |
164 | struct type *cp_lookup_transparent_type (const char *name); |
165 | ||
f7e3ecae KS |
166 | /* See description in cp-namespace.c. */ |
167 | ||
a07e3e18 DE |
168 | struct type *cp_find_type_baseclass_by_name (struct type *parent_type, |
169 | const char *name); | |
f7e3ecae | 170 | |
f88e9fd3 | 171 | /* Functions from cp-name-parser.y. */ |
fb4c6eba | 172 | |
c8b23b3f | 173 | extern std::unique_ptr<demangle_parse_info> cp_demangled_name_to_comp |
3513a6bb | 174 | (const char *demangled_name, std::string *errmsg); |
fb4c6eba | 175 | |
cb2cd8cb PA |
176 | /* Convert RESULT to a string. ESTIMATED_LEN is used only as a guide |
177 | to the length of the result. */ | |
178 | ||
29592bde PA |
179 | extern gdb::unique_xmalloc_ptr<char> cp_comp_to_string |
180 | (struct demangle_component *result, int estimated_len); | |
fb4c6eba | 181 | |
3a93a0c2 KS |
182 | extern void cp_merge_demangle_parse_infos (struct demangle_parse_info *, |
183 | struct demangle_component *, | |
184 | struct demangle_parse_info *); | |
185 | ||
5c4e30ca DC |
186 | /* The list of "maint cplus" commands. */ |
187 | ||
188 | extern struct cmd_list_element *maint_cplus_cmd_list; | |
189 | ||
cb2cd8cb PA |
190 | /* Wrappers for bfd and libiberty demangling entry points. Note they |
191 | all force DMGL_VERBOSE so that callers don't need to. This is so | |
192 | that GDB consistently uses DMGL_VERBOSE throughout -- we want | |
193 | libiberty's demangler to expand standard substitutions to their | |
194 | full template name. */ | |
195 | ||
8de20a37 TT |
196 | /* A wrapper for bfd_demangle. */ |
197 | ||
3456e70c | 198 | gdb::unique_xmalloc_ptr<char> gdb_demangle (const char *name, int options); |
8de20a37 | 199 | |
cb2cd8cb PA |
200 | /* A wrapper for cplus_demangle_print. */ |
201 | ||
202 | extern char *gdb_cplus_demangle_print (int options, | |
203 | struct demangle_component *tree, | |
204 | int estimated_length, | |
205 | size_t *p_allocated_size); | |
206 | ||
2f2c677e KS |
207 | /* Find an instance of the character C in the string S that is outside |
208 | of all parenthesis pairs, single-quoted strings, and double-quoted | |
209 | strings. Also, ignore the char within a template name, like a ',' | |
210 | within foo<int, int>. */ | |
211 | ||
212 | extern const char *find_toplevel_char (const char *s, char c); | |
213 | ||
9219021c | 214 | #endif /* CP_SUPPORT_H */ |