1 /* Helper routines for C++ support in GDB.
2 Copyright (C) 2002-2018 Free Software Foundation, Inc.
4 Contributed by MontaVista Software.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 #include "cp-support.h"
25 #include "dictionary.h"
30 #include "complaints.h"
32 #include "expression.h"
35 #include "namespace.h"
37 #include "gdb_setjmp.h"
38 #include "safe-ctype.h"
41 #define d_left(dc) (dc)->u.s_binary.left
42 #define d_right(dc) (dc)->u.s_binary.right
44 /* Functions related to demangled name parsing. */
46 static unsigned int cp_find_first_component_aux (const char *name,
49 static void demangled_name_complaint (const char *name);
51 /* Functions/variables related to overload resolution. */
53 static int sym_return_val_size = -1;
54 static int sym_return_val_index;
55 static struct symbol **sym_return_val;
57 static void overload_list_add_symbol (struct symbol *sym,
58 const char *oload_name);
60 static void make_symbol_overload_list_using (const char *func_name,
61 const char *the_namespace);
63 static void make_symbol_overload_list_qualified (const char *func_name);
65 /* The list of "maint cplus" commands. */
67 struct cmd_list_element *maint_cplus_cmd_list = NULL;
69 /* A list of typedefs which should not be substituted by replace_typedefs. */
70 static const char * const ignore_typedefs[] =
72 "std::istream", "std::iostream", "std::ostream", "std::string"
76 replace_typedefs (struct demangle_parse_info *info,
77 struct demangle_component *ret_comp,
78 canonicalization_ftype *finder,
81 /* A convenience function to copy STRING into OBSTACK, returning a pointer
82 to the newly allocated string and saving the number of bytes saved in LEN.
84 It does not copy the terminating '\0' byte! */
87 copy_string_to_obstack (struct obstack *obstack, const char *string,
90 *len = strlen (string);
91 return (char *) obstack_copy (obstack, string, *len);
94 /* Return 1 if STRING is clearly already in canonical form. This
95 function is conservative; things which it does not recognize are
96 assumed to be non-canonical, and the parser will sort them out
97 afterwards. This speeds up the critical path for alphanumeric
101 cp_already_canonical (const char *string)
103 /* Identifier start character [a-zA-Z_]. */
104 if (!ISIDST (string[0]))
107 /* These are the only two identifiers which canonicalize to other
108 than themselves or an error: unsigned -> unsigned int and
110 if (string[0] == 'u' && strcmp (&string[1], "nsigned") == 0)
112 else if (string[0] == 's' && strcmp (&string[1], "igned") == 0)
115 /* Identifier character [a-zA-Z0-9_]. */
116 while (ISIDNUM (string[1]))
119 if (string[1] == '\0')
125 /* Inspect the given RET_COMP for its type. If it is a typedef,
126 replace the node with the typedef's tree.
128 Returns 1 if any typedef substitutions were made, 0 otherwise. */
131 inspect_type (struct demangle_parse_info *info,
132 struct demangle_component *ret_comp,
133 canonicalization_ftype *finder,
140 /* Copy the symbol's name from RET_COMP and look it up
141 in the symbol table. */
142 name = (char *) alloca (ret_comp->u.s_name.len + 1);
143 memcpy (name, ret_comp->u.s_name.s, ret_comp->u.s_name.len);
144 name[ret_comp->u.s_name.len] = '\0';
146 /* Ignore any typedefs that should not be substituted. */
147 for (i = 0; i < ARRAY_SIZE (ignore_typedefs); ++i)
149 if (strcmp (name, ignore_typedefs[i]) == 0)
157 sym = lookup_symbol (name, 0, VAR_DOMAIN, 0).symbol;
159 CATCH (except, RETURN_MASK_ALL)
167 struct type *otype = SYMBOL_TYPE (sym);
171 const char *new_name = (*finder) (otype, data);
173 if (new_name != NULL)
175 ret_comp->u.s_name.s = new_name;
176 ret_comp->u.s_name.len = strlen (new_name);
183 /* If the type is a typedef or namespace alias, replace it. */
184 if (TYPE_CODE (otype) == TYPE_CODE_TYPEDEF
185 || TYPE_CODE (otype) == TYPE_CODE_NAMESPACE)
190 std::unique_ptr<demangle_parse_info> i;
192 /* Get the real type of the typedef. */
193 type = check_typedef (otype);
195 /* If the symbol is a namespace and its type name is no different
196 than the name we looked up, this symbol is not a namespace
197 alias and does not need to be substituted. */
198 if (TYPE_CODE (otype) == TYPE_CODE_NAMESPACE
199 && strcmp (TYPE_NAME (type), name) == 0)
202 is_anon = (TYPE_NAME (type) == NULL
203 && (TYPE_CODE (type) == TYPE_CODE_ENUM
204 || TYPE_CODE (type) == TYPE_CODE_STRUCT
205 || TYPE_CODE (type) == TYPE_CODE_UNION));
208 struct type *last = otype;
210 /* Find the last typedef for the type. */
211 while (TYPE_TARGET_TYPE (last) != NULL
212 && (TYPE_CODE (TYPE_TARGET_TYPE (last))
213 == TYPE_CODE_TYPEDEF))
214 last = TYPE_TARGET_TYPE (last);
216 /* If there is only one typedef for this anonymous type,
217 do not substitute it. */
221 /* Use the last typedef seen as the type for this
229 type_print (type, "", &buf, -1);
231 /* If type_print threw an exception, there is little point
232 in continuing, so just bow out gracefully. */
233 CATCH (except, RETURN_MASK_ERROR)
240 name = (char *) obstack_copy0 (&info->obstack, buf.c_str (), len);
242 /* Turn the result into a new tree. Note that this
243 tree will contain pointers into NAME, so NAME cannot
244 be free'd until all typedef conversion is done and
245 the final result is converted into a string. */
246 i = cp_demangled_name_to_comp (name, NULL);
249 /* Merge the two trees. */
250 cp_merge_demangle_parse_infos (info, ret_comp, i.get ());
252 /* Replace any newly introduced typedefs -- but not
253 if the type is anonymous (that would lead to infinite
256 replace_typedefs (info, ret_comp, finder, data);
260 /* This shouldn't happen unless the type printer has
261 output something that the name parser cannot grok.
262 Nonetheless, an ounce of prevention...
264 Canonicalize the name again, and store it in the
265 current node (RET_COMP). */
266 std::string canon = cp_canonicalize_string_no_typedefs (name);
270 /* Copy the canonicalization into the obstack. */
271 name = copy_string_to_obstack (&info->obstack, canon.c_str (), &len);
274 ret_comp->u.s_name.s = name;
275 ret_comp->u.s_name.len = len;
285 /* Replace any typedefs appearing in the qualified name
286 (DEMANGLE_COMPONENT_QUAL_NAME) represented in RET_COMP for the name parse
290 replace_typedefs_qualified_name (struct demangle_parse_info *info,
291 struct demangle_component *ret_comp,
292 canonicalization_ftype *finder,
296 struct demangle_component *comp = ret_comp;
298 /* Walk each node of the qualified name, reconstructing the name of
299 this element. With every node, check for any typedef substitutions.
300 If a substitution has occurred, replace the qualified name node
301 with a DEMANGLE_COMPONENT_NAME node representing the new, typedef-
303 while (comp->type == DEMANGLE_COMPONENT_QUAL_NAME)
305 if (d_left (comp)->type == DEMANGLE_COMPONENT_NAME)
307 struct demangle_component newobj;
309 buf.write (d_left (comp)->u.s_name.s, d_left (comp)->u.s_name.len);
310 newobj.type = DEMANGLE_COMPONENT_NAME;
312 = (char *) obstack_copy0 (&info->obstack,
313 buf.c_str (), buf.size ());
314 newobj.u.s_name.len = buf.size ();
315 if (inspect_type (info, &newobj, finder, data))
320 /* A typedef was substituted in NEW. Convert it to a
321 string and replace the top DEMANGLE_COMPONENT_QUAL_NAME
325 gdb::unique_xmalloc_ptr<char> n
326 = cp_comp_to_string (&newobj, 100);
329 /* If something went astray, abort typedef substitutions. */
333 s = copy_string_to_obstack (&info->obstack, n.get (), &slen);
335 d_left (ret_comp)->type = DEMANGLE_COMPONENT_NAME;
336 d_left (ret_comp)->u.s_name.s = s;
337 d_left (ret_comp)->u.s_name.len = slen;
338 d_right (ret_comp) = d_right (comp);
345 /* The current node is not a name, so simply replace any
346 typedefs in it. Then print it to the stream to continue
347 checking for more typedefs in the tree. */
348 replace_typedefs (info, d_left (comp), finder, data);
349 gdb::unique_xmalloc_ptr<char> name
350 = cp_comp_to_string (d_left (comp), 100);
353 /* If something went astray, abort typedef substitutions. */
356 buf.puts (name.get ());
360 comp = d_right (comp);
363 /* If the next component is DEMANGLE_COMPONENT_NAME, save the qualified
364 name assembled above and append the name given by COMP. Then use this
365 reassembled name to check for a typedef. */
367 if (comp->type == DEMANGLE_COMPONENT_NAME)
369 buf.write (comp->u.s_name.s, comp->u.s_name.len);
371 /* Replace the top (DEMANGLE_COMPONENT_QUAL_NAME) node
372 with a DEMANGLE_COMPONENT_NAME node containing the whole
374 ret_comp->type = DEMANGLE_COMPONENT_NAME;
376 = (char *) obstack_copy0 (&info->obstack,
377 buf.c_str (), buf.size ());
378 ret_comp->u.s_name.len = buf.size ();
379 inspect_type (info, ret_comp, finder, data);
382 replace_typedefs (info, comp, finder, data);
386 /* A function to check const and volatile qualifiers for argument types.
388 "Parameter declarations that differ only in the presence
389 or absence of `const' and/or `volatile' are equivalent."
390 C++ Standard N3290, clause 13.1.3 #4. */
393 check_cv_qualifiers (struct demangle_component *ret_comp)
395 while (d_left (ret_comp) != NULL
396 && (d_left (ret_comp)->type == DEMANGLE_COMPONENT_CONST
397 || d_left (ret_comp)->type == DEMANGLE_COMPONENT_VOLATILE))
399 d_left (ret_comp) = d_left (d_left (ret_comp));
403 /* Walk the parse tree given by RET_COMP, replacing any typedefs with
404 their basic types. */
407 replace_typedefs (struct demangle_parse_info *info,
408 struct demangle_component *ret_comp,
409 canonicalization_ftype *finder,
415 && (ret_comp->type == DEMANGLE_COMPONENT_NAME
416 || ret_comp->type == DEMANGLE_COMPONENT_QUAL_NAME
417 || ret_comp->type == DEMANGLE_COMPONENT_TEMPLATE
418 || ret_comp->type == DEMANGLE_COMPONENT_BUILTIN_TYPE))
420 gdb::unique_xmalloc_ptr<char> local_name
421 = cp_comp_to_string (ret_comp, 10);
423 if (local_name != NULL)
425 struct symbol *sym = NULL;
430 sym = lookup_symbol (local_name.get (), 0,
431 VAR_DOMAIN, 0).symbol;
433 CATCH (except, RETURN_MASK_ALL)
440 struct type *otype = SYMBOL_TYPE (sym);
441 const char *new_name = (*finder) (otype, data);
443 if (new_name != NULL)
445 ret_comp->type = DEMANGLE_COMPONENT_NAME;
446 ret_comp->u.s_name.s = new_name;
447 ret_comp->u.s_name.len = strlen (new_name);
454 switch (ret_comp->type)
456 case DEMANGLE_COMPONENT_ARGLIST:
457 check_cv_qualifiers (ret_comp);
460 case DEMANGLE_COMPONENT_FUNCTION_TYPE:
461 case DEMANGLE_COMPONENT_TEMPLATE:
462 case DEMANGLE_COMPONENT_TEMPLATE_ARGLIST:
463 case DEMANGLE_COMPONENT_TYPED_NAME:
464 replace_typedefs (info, d_left (ret_comp), finder, data);
465 replace_typedefs (info, d_right (ret_comp), finder, data);
468 case DEMANGLE_COMPONENT_NAME:
469 inspect_type (info, ret_comp, finder, data);
472 case DEMANGLE_COMPONENT_QUAL_NAME:
473 replace_typedefs_qualified_name (info, ret_comp, finder, data);
476 case DEMANGLE_COMPONENT_LOCAL_NAME:
477 case DEMANGLE_COMPONENT_CTOR:
478 case DEMANGLE_COMPONENT_ARRAY_TYPE:
479 case DEMANGLE_COMPONENT_PTRMEM_TYPE:
480 replace_typedefs (info, d_right (ret_comp), finder, data);
483 case DEMANGLE_COMPONENT_CONST:
484 case DEMANGLE_COMPONENT_RESTRICT:
485 case DEMANGLE_COMPONENT_VOLATILE:
486 case DEMANGLE_COMPONENT_VOLATILE_THIS:
487 case DEMANGLE_COMPONENT_CONST_THIS:
488 case DEMANGLE_COMPONENT_RESTRICT_THIS:
489 case DEMANGLE_COMPONENT_POINTER:
490 case DEMANGLE_COMPONENT_REFERENCE:
491 case DEMANGLE_COMPONENT_RVALUE_REFERENCE:
492 replace_typedefs (info, d_left (ret_comp), finder, data);
501 /* Parse STRING and convert it to canonical form, resolving any
502 typedefs. If parsing fails, or if STRING is already canonical,
503 return the empty string. Otherwise return the canonical form. If
504 FINDER is not NULL, then type components are passed to FINDER to be
505 looked up. DATA is passed verbatim to FINDER. */
508 cp_canonicalize_string_full (const char *string,
509 canonicalization_ftype *finder,
513 unsigned int estimated_len;
514 std::unique_ptr<demangle_parse_info> info;
516 estimated_len = strlen (string) * 2;
517 info = cp_demangled_name_to_comp (string, NULL);
520 /* Replace all the typedefs in the tree. */
521 replace_typedefs (info.get (), info->tree, finder, data);
523 /* Convert the tree back into a string. */
524 gdb::unique_xmalloc_ptr<char> us = cp_comp_to_string (info->tree,
529 /* Finally, compare the original string with the computed
530 name, returning NULL if they are the same. */
532 return std::string ();
538 /* Like cp_canonicalize_string_full, but always passes NULL for
542 cp_canonicalize_string_no_typedefs (const char *string)
544 return cp_canonicalize_string_full (string, NULL, NULL);
547 /* Parse STRING and convert it to canonical form. If parsing fails,
548 or if STRING is already canonical, return the empty string.
549 Otherwise return the canonical form. */
552 cp_canonicalize_string (const char *string)
554 std::unique_ptr<demangle_parse_info> info;
555 unsigned int estimated_len;
557 if (cp_already_canonical (string))
558 return std::string ();
560 info = cp_demangled_name_to_comp (string, NULL);
562 return std::string ();
564 estimated_len = strlen (string) * 2;
565 gdb::unique_xmalloc_ptr<char> us (cp_comp_to_string (info->tree,
570 warning (_("internal error: string \"%s\" failed to be canonicalized"),
572 return std::string ();
575 std::string ret (us.get ());
578 return std::string ();
583 /* Convert a mangled name to a demangle_component tree. *MEMORY is
584 set to the block of used memory that should be freed when finished
585 with the tree. DEMANGLED_P is set to the char * that should be
586 freed when finished with the tree, or NULL if none was needed.
587 OPTIONS will be passed to the demangler. */
589 static std::unique_ptr<demangle_parse_info>
590 mangled_name_to_comp (const char *mangled_name, int options,
591 void **memory, char **demangled_p)
593 char *demangled_name;
595 /* If it looks like a v3 mangled name, then try to go directly
597 if (mangled_name[0] == '_' && mangled_name[1] == 'Z')
599 struct demangle_component *ret;
601 ret = cplus_demangle_v3_components (mangled_name,
605 std::unique_ptr<demangle_parse_info> info (new demangle_parse_info);
612 /* If it doesn't, or if that failed, then try to demangle the
614 demangled_name = gdb_demangle (mangled_name, options);
615 if (demangled_name == NULL)
618 /* If we could demangle the name, parse it to build the component
620 std::unique_ptr<demangle_parse_info> info
621 = cp_demangled_name_to_comp (demangled_name, NULL);
625 xfree (demangled_name);
629 *demangled_p = demangled_name;
633 /* Return the name of the class containing method PHYSNAME. */
636 cp_class_name_from_physname (const char *physname)
638 void *storage = NULL;
639 char *demangled_name = NULL;
640 gdb::unique_xmalloc_ptr<char> ret;
641 struct demangle_component *ret_comp, *prev_comp, *cur_comp;
642 std::unique_ptr<demangle_parse_info> info;
645 info = mangled_name_to_comp (physname, DMGL_ANSI,
646 &storage, &demangled_name);
651 ret_comp = info->tree;
653 /* First strip off any qualifiers, if we have a function or
656 switch (ret_comp->type)
658 case DEMANGLE_COMPONENT_CONST:
659 case DEMANGLE_COMPONENT_RESTRICT:
660 case DEMANGLE_COMPONENT_VOLATILE:
661 case DEMANGLE_COMPONENT_CONST_THIS:
662 case DEMANGLE_COMPONENT_RESTRICT_THIS:
663 case DEMANGLE_COMPONENT_VOLATILE_THIS:
664 case DEMANGLE_COMPONENT_VENDOR_TYPE_QUAL:
665 ret_comp = d_left (ret_comp);
672 /* If what we have now is a function, discard the argument list. */
673 if (ret_comp->type == DEMANGLE_COMPONENT_TYPED_NAME)
674 ret_comp = d_left (ret_comp);
676 /* If what we have now is a template, strip off the template
677 arguments. The left subtree may be a qualified name. */
678 if (ret_comp->type == DEMANGLE_COMPONENT_TEMPLATE)
679 ret_comp = d_left (ret_comp);
681 /* What we have now should be a name, possibly qualified.
682 Additional qualifiers could live in the left subtree or the right
683 subtree. Find the last piece. */
688 switch (cur_comp->type)
690 case DEMANGLE_COMPONENT_QUAL_NAME:
691 case DEMANGLE_COMPONENT_LOCAL_NAME:
692 prev_comp = cur_comp;
693 cur_comp = d_right (cur_comp);
695 case DEMANGLE_COMPONENT_TEMPLATE:
696 case DEMANGLE_COMPONENT_NAME:
697 case DEMANGLE_COMPONENT_CTOR:
698 case DEMANGLE_COMPONENT_DTOR:
699 case DEMANGLE_COMPONENT_OPERATOR:
700 case DEMANGLE_COMPONENT_EXTENDED_OPERATOR:
709 if (cur_comp != NULL && prev_comp != NULL)
711 /* We want to discard the rightmost child of PREV_COMP. */
712 *prev_comp = *d_left (prev_comp);
713 /* The ten is completely arbitrary; we don't have a good
715 ret = cp_comp_to_string (ret_comp, 10);
719 xfree (demangled_name);
720 return ret.release ();
723 /* Return the child of COMP which is the basename of a method,
724 variable, et cetera. All scope qualifiers are discarded, but
725 template arguments will be included. The component tree may be
728 static struct demangle_component *
729 unqualified_name_from_comp (struct demangle_component *comp)
731 struct demangle_component *ret_comp = comp, *last_template;
735 last_template = NULL;
737 switch (ret_comp->type)
739 case DEMANGLE_COMPONENT_QUAL_NAME:
740 case DEMANGLE_COMPONENT_LOCAL_NAME:
741 ret_comp = d_right (ret_comp);
743 case DEMANGLE_COMPONENT_TYPED_NAME:
744 ret_comp = d_left (ret_comp);
746 case DEMANGLE_COMPONENT_TEMPLATE:
747 gdb_assert (last_template == NULL);
748 last_template = ret_comp;
749 ret_comp = d_left (ret_comp);
751 case DEMANGLE_COMPONENT_CONST:
752 case DEMANGLE_COMPONENT_RESTRICT:
753 case DEMANGLE_COMPONENT_VOLATILE:
754 case DEMANGLE_COMPONENT_CONST_THIS:
755 case DEMANGLE_COMPONENT_RESTRICT_THIS:
756 case DEMANGLE_COMPONENT_VOLATILE_THIS:
757 case DEMANGLE_COMPONENT_VENDOR_TYPE_QUAL:
758 ret_comp = d_left (ret_comp);
760 case DEMANGLE_COMPONENT_NAME:
761 case DEMANGLE_COMPONENT_CTOR:
762 case DEMANGLE_COMPONENT_DTOR:
763 case DEMANGLE_COMPONENT_OPERATOR:
764 case DEMANGLE_COMPONENT_EXTENDED_OPERATOR:
774 d_left (last_template) = ret_comp;
775 return last_template;
781 /* Return the name of the method whose linkage name is PHYSNAME. */
784 method_name_from_physname (const char *physname)
786 void *storage = NULL;
787 char *demangled_name = NULL;
788 gdb::unique_xmalloc_ptr<char> ret;
789 struct demangle_component *ret_comp;
790 std::unique_ptr<demangle_parse_info> info;
792 info = mangled_name_to_comp (physname, DMGL_ANSI,
793 &storage, &demangled_name);
797 ret_comp = unqualified_name_from_comp (info->tree);
799 if (ret_comp != NULL)
800 /* The ten is completely arbitrary; we don't have a good
802 ret = cp_comp_to_string (ret_comp, 10);
805 xfree (demangled_name);
806 return ret.release ();
809 /* If FULL_NAME is the demangled name of a C++ function (including an
810 arg list, possibly including namespace/class qualifications),
811 return a new string containing only the function name (without the
812 arg list/class qualifications). Otherwise, return NULL. The
813 caller is responsible for freeing the memory in question. */
816 cp_func_name (const char *full_name)
818 gdb::unique_xmalloc_ptr<char> ret;
819 struct demangle_component *ret_comp;
820 std::unique_ptr<demangle_parse_info> info;
822 info = cp_demangled_name_to_comp (full_name, NULL);
826 ret_comp = unqualified_name_from_comp (info->tree);
828 if (ret_comp != NULL)
829 ret = cp_comp_to_string (ret_comp, 10);
831 return ret.release ();
834 /* Helper for cp_remove_params. DEMANGLED_NAME is the name of a
835 function, including parameters and (optionally) a return type.
836 Return the name of the function without parameters or return type,
837 or NULL if we can not parse the name. If REQUIRE_PARAMS is false,
838 then tolerate a non-existing or unbalanced parameter list. */
840 static gdb::unique_xmalloc_ptr<char>
841 cp_remove_params_1 (const char *demangled_name, bool require_params)
844 struct demangle_component *ret_comp;
845 std::unique_ptr<demangle_parse_info> info;
846 gdb::unique_xmalloc_ptr<char> ret;
848 if (demangled_name == NULL)
851 info = cp_demangled_name_to_comp (demangled_name, NULL);
855 /* First strip off any qualifiers, if we have a function or method. */
856 ret_comp = info->tree;
858 switch (ret_comp->type)
860 case DEMANGLE_COMPONENT_CONST:
861 case DEMANGLE_COMPONENT_RESTRICT:
862 case DEMANGLE_COMPONENT_VOLATILE:
863 case DEMANGLE_COMPONENT_CONST_THIS:
864 case DEMANGLE_COMPONENT_RESTRICT_THIS:
865 case DEMANGLE_COMPONENT_VOLATILE_THIS:
866 case DEMANGLE_COMPONENT_VENDOR_TYPE_QUAL:
867 ret_comp = d_left (ret_comp);
874 /* What we have now should be a function. Return its name. */
875 if (ret_comp->type == DEMANGLE_COMPONENT_TYPED_NAME)
876 ret = cp_comp_to_string (d_left (ret_comp), 10);
877 else if (!require_params
878 && (ret_comp->type == DEMANGLE_COMPONENT_NAME
879 || ret_comp->type == DEMANGLE_COMPONENT_QUAL_NAME
880 || ret_comp->type == DEMANGLE_COMPONENT_TEMPLATE))
881 ret = cp_comp_to_string (ret_comp, 10);
886 /* DEMANGLED_NAME is the name of a function, including parameters and
887 (optionally) a return type. Return the name of the function
888 without parameters or return type, or NULL if we can not parse the
891 gdb::unique_xmalloc_ptr<char>
892 cp_remove_params (const char *demangled_name)
894 return cp_remove_params_1 (demangled_name, true);
897 /* See cp-support.h. */
899 gdb::unique_xmalloc_ptr<char>
900 cp_remove_params_if_any (const char *demangled_name, bool completion_mode)
902 /* Trying to remove parameters from the empty string fails. If
903 we're completing / matching everything, avoid returning NULL
904 which would make callers interpret the result as an error. */
905 if (demangled_name[0] == '\0' && completion_mode)
906 return gdb::unique_xmalloc_ptr<char> (xstrdup (""));
908 gdb::unique_xmalloc_ptr<char> without_params
909 = cp_remove_params_1 (demangled_name, false);
911 if (without_params == NULL && completion_mode)
913 std::string copy = demangled_name;
915 while (!copy.empty ())
918 without_params = cp_remove_params_1 (copy.c_str (), false);
919 if (without_params != NULL)
924 return without_params;
927 /* Here are some random pieces of trivia to keep in mind while trying
928 to take apart demangled names:
930 - Names can contain function arguments or templates, so the process
931 has to be, to some extent recursive: maybe keep track of your
932 depth based on encountering <> and ().
934 - Parentheses don't just have to happen at the end of a name: they
935 can occur even if the name in question isn't a function, because
936 a template argument might be a type that's a function.
938 - Conversely, even if you're trying to deal with a function, its
939 demangled name might not end with ')': it could be a const or
940 volatile class method, in which case it ends with "const" or
943 - Parentheses are also used in anonymous namespaces: a variable
944 'foo' in an anonymous namespace gets demangled as "(anonymous
947 - And operator names can contain parentheses or angle brackets. */
949 /* FIXME: carlton/2003-03-13: We have several functions here with
950 overlapping functionality; can we combine them? Also, do they
951 handle all the above considerations correctly? */
954 /* This returns the length of first component of NAME, which should be
955 the demangled name of a C++ variable/function/method/etc.
956 Specifically, it returns the index of the first colon forming the
957 boundary of the first component: so, given 'A::foo' or 'A::B::foo'
958 it returns the 1, and given 'foo', it returns 0. */
960 /* The character in NAME indexed by the return value is guaranteed to
961 always be either ':' or '\0'. */
963 /* NOTE: carlton/2003-03-13: This function is currently only intended
964 for internal use: it's probably not entirely safe when called on
965 user-generated input, because some of the 'index += 2' lines in
966 cp_find_first_component_aux might go past the end of malformed
970 cp_find_first_component (const char *name)
972 return cp_find_first_component_aux (name, 0);
975 /* Helper function for cp_find_first_component. Like that function,
976 it returns the length of the first component of NAME, but to make
977 the recursion easier, it also stops if it reaches an unexpected ')'
978 or '>' if the value of PERMISSIVE is nonzero. */
981 cp_find_first_component_aux (const char *name, int permissive)
983 unsigned int index = 0;
984 /* Operator names can show up in unexpected places. Since these can
985 contain parentheses or angle brackets, they can screw up the
986 recursion. But not every string 'operator' is part of an
987 operater name: e.g. you could have a variable 'cooperator'. So
988 this variable tells us whether or not we should treat the string
989 'operator' as starting an operator. */
990 int operator_possible = 1;
997 /* Template; eat it up. The calls to cp_first_component
998 should only return (I hope!) when they reach the '>'
999 terminating the component or a '::' between two
1000 components. (Hence the '+ 2'.) */
1002 for (index += cp_find_first_component_aux (name + index, 1);
1004 index += cp_find_first_component_aux (name + index, 1))
1006 if (name[index] != ':')
1008 demangled_name_complaint (name);
1009 return strlen (name);
1013 operator_possible = 1;
1016 /* Similar comment as to '<'. */
1018 for (index += cp_find_first_component_aux (name + index, 1);
1020 index += cp_find_first_component_aux (name + index, 1))
1022 if (name[index] != ':')
1024 demangled_name_complaint (name);
1025 return strlen (name);
1029 operator_possible = 1;
1037 demangled_name_complaint (name);
1038 return strlen (name);
1043 /* ':' marks a component iff the next character is also a ':'.
1044 Otherwise it is probably malformed input. */
1045 if (name[index + 1] == ':')
1049 /* Operator names can screw up the recursion. */
1050 if (operator_possible
1051 && startswith (name + index, CP_OPERATOR_STR))
1053 index += CP_OPERATOR_LEN;
1054 while (ISSPACE(name[index]))
1056 switch (name[index])
1060 /* Skip over one less than the appropriate number of
1061 characters: the for loop will skip over the last
1064 if (name[index + 1] == '<')
1071 if (name[index + 1] == '>')
1084 operator_possible = 0;
1091 /* NOTE: carlton/2003-04-18: I'm not sure what the precise
1092 set of relevant characters are here: it's necessary to
1093 include any character that can show up before 'operator'
1094 in a demangled name, and it's safe to include any
1095 character that can't be part of an identifier's name. */
1096 operator_possible = 1;
1099 operator_possible = 0;
1105 /* Complain about a demangled name that we don't know how to parse.
1106 NAME is the demangled name in question. */
1109 demangled_name_complaint (const char *name)
1111 complaint ("unexpected demangled name '%s'", name);
1114 /* If NAME is the fully-qualified name of a C++
1115 function/variable/method/etc., this returns the length of its
1116 entire prefix: all of the namespaces and classes that make up its
1117 name. Given 'A::foo', it returns 1, given 'A::B::foo', it returns
1118 4, given 'foo', it returns 0. */
1121 cp_entire_prefix_len (const char *name)
1123 unsigned int current_len = cp_find_first_component (name);
1124 unsigned int previous_len = 0;
1126 while (name[current_len] != '\0')
1128 gdb_assert (name[current_len] == ':');
1129 previous_len = current_len;
1130 /* Skip the '::'. */
1132 current_len += cp_find_first_component (name + current_len);
1135 return previous_len;
1138 /* Overload resolution functions. */
1140 /* Test to see if SYM is a symbol that we haven't seen corresponding
1141 to a function named OLOAD_NAME. If so, add it to the current
1145 overload_list_add_symbol (struct symbol *sym,
1146 const char *oload_name)
1150 gdb::unique_xmalloc_ptr<char> sym_name;
1152 /* If there is no type information, we can't do anything, so
1154 if (SYMBOL_TYPE (sym) == NULL)
1157 /* skip any symbols that we've already considered. */
1158 for (i = 0; i < sym_return_val_index; ++i)
1159 if (strcmp (SYMBOL_LINKAGE_NAME (sym),
1160 SYMBOL_LINKAGE_NAME (sym_return_val[i])) == 0)
1163 /* Get the demangled name without parameters */
1164 sym_name = cp_remove_params (SYMBOL_NATURAL_NAME (sym));
1168 /* skip symbols that cannot match */
1169 if (strcmp (sym_name.get (), oload_name) != 0)
1172 /* We have a match for an overload instance, so add SYM to the
1173 current list of overload instances */
1174 if (sym_return_val_index + 3 > sym_return_val_size)
1176 newsize = (sym_return_val_size *= 2) * sizeof (struct symbol *);
1177 sym_return_val = (struct symbol **)
1178 xrealloc ((char *) sym_return_val, newsize);
1180 sym_return_val[sym_return_val_index++] = sym;
1181 sym_return_val[sym_return_val_index] = NULL;
1184 /* Return a null-terminated list of pointers to function symbols that
1185 are named FUNC_NAME and are visible within NAMESPACE. */
1188 make_symbol_overload_list (const char *func_name,
1189 const char *the_namespace)
1191 struct cleanup *old_cleanups;
1194 sym_return_val_size = 100;
1195 sym_return_val_index = 0;
1196 sym_return_val = XNEWVEC (struct symbol *, sym_return_val_size + 1);
1197 sym_return_val[0] = NULL;
1199 old_cleanups = make_cleanup (xfree, sym_return_val);
1201 make_symbol_overload_list_using (func_name, the_namespace);
1203 if (the_namespace[0] == '\0')
1207 char *concatenated_name
1208 = (char *) alloca (strlen (the_namespace) + 2 + strlen (func_name) + 1);
1209 strcpy (concatenated_name, the_namespace);
1210 strcat (concatenated_name, "::");
1211 strcat (concatenated_name, func_name);
1212 name = concatenated_name;
1215 make_symbol_overload_list_qualified (name);
1217 discard_cleanups (old_cleanups);
1219 return sym_return_val;
1222 /* Add all symbols with a name matching NAME in BLOCK to the overload
1226 make_symbol_overload_list_block (const char *name,
1227 const struct block *block)
1229 struct block_iterator iter;
1232 lookup_name_info lookup_name (name, symbol_name_match_type::FULL);
1234 ALL_BLOCK_SYMBOLS_WITH_NAME (block, lookup_name, iter, sym)
1235 overload_list_add_symbol (sym, name);
1238 /* Adds the function FUNC_NAME from NAMESPACE to the overload set. */
1241 make_symbol_overload_list_namespace (const char *func_name,
1242 const char *the_namespace)
1245 const struct block *block = NULL;
1247 if (the_namespace[0] == '\0')
1251 char *concatenated_name
1252 = (char *) alloca (strlen (the_namespace) + 2 + strlen (func_name) + 1);
1254 strcpy (concatenated_name, the_namespace);
1255 strcat (concatenated_name, "::");
1256 strcat (concatenated_name, func_name);
1257 name = concatenated_name;
1260 /* Look in the static block. */
1261 block = block_static_block (get_selected_block (0));
1263 make_symbol_overload_list_block (name, block);
1265 /* Look in the global block. */
1266 block = block_global_block (block);
1268 make_symbol_overload_list_block (name, block);
1272 /* Search the namespace of the given type and namespace of and public
1276 make_symbol_overload_list_adl_namespace (struct type *type,
1277 const char *func_name)
1279 char *the_namespace;
1280 const char *type_name;
1283 while (TYPE_CODE (type) == TYPE_CODE_PTR
1284 || TYPE_IS_REFERENCE (type)
1285 || TYPE_CODE (type) == TYPE_CODE_ARRAY
1286 || TYPE_CODE (type) == TYPE_CODE_TYPEDEF)
1288 if (TYPE_CODE (type) == TYPE_CODE_TYPEDEF)
1289 type = check_typedef(type);
1291 type = TYPE_TARGET_TYPE (type);
1294 type_name = TYPE_NAME (type);
1296 if (type_name == NULL)
1299 prefix_len = cp_entire_prefix_len (type_name);
1301 if (prefix_len != 0)
1303 the_namespace = (char *) alloca (prefix_len + 1);
1304 strncpy (the_namespace, type_name, prefix_len);
1305 the_namespace[prefix_len] = '\0';
1307 make_symbol_overload_list_namespace (func_name, the_namespace);
1310 /* Check public base type */
1311 if (TYPE_CODE (type) == TYPE_CODE_STRUCT)
1312 for (i = 0; i < TYPE_N_BASECLASSES (type); i++)
1314 if (BASETYPE_VIA_PUBLIC (type, i))
1315 make_symbol_overload_list_adl_namespace (TYPE_BASECLASS (type,
1321 /* Adds the overload list overload candidates for FUNC_NAME found
1322 through argument dependent lookup. */
1325 make_symbol_overload_list_adl (struct type **arg_types, int nargs,
1326 const char *func_name)
1330 gdb_assert (sym_return_val_size != -1);
1332 for (i = 1; i <= nargs; i++)
1333 make_symbol_overload_list_adl_namespace (arg_types[i - 1],
1336 return sym_return_val;
1339 /* This applies the using directives to add namespaces to search in,
1340 and then searches for overloads in all of those namespaces. It
1341 adds the symbols found to sym_return_val. Arguments are as in
1342 make_symbol_overload_list. */
1345 make_symbol_overload_list_using (const char *func_name,
1346 const char *the_namespace)
1348 struct using_direct *current;
1349 const struct block *block;
1351 /* First, go through the using directives. If any of them apply,
1352 look in the appropriate namespaces for new functions to match
1355 for (block = get_selected_block (0);
1357 block = BLOCK_SUPERBLOCK (block))
1358 for (current = block_using (block);
1360 current = current->next)
1362 /* Prevent recursive calls. */
1363 if (current->searched)
1366 /* If this is a namespace alias or imported declaration ignore
1368 if (current->alias != NULL || current->declaration != NULL)
1371 if (strcmp (the_namespace, current->import_dest) == 0)
1373 /* Mark this import as searched so that the recursive call
1374 does not search it again. */
1375 scoped_restore reset_directive_searched
1376 = make_scoped_restore (¤t->searched, 1);
1378 make_symbol_overload_list_using (func_name,
1379 current->import_src);
1383 /* Now, add names for this namespace. */
1384 make_symbol_overload_list_namespace (func_name, the_namespace);
1387 /* This does the bulk of the work of finding overloaded symbols.
1388 FUNC_NAME is the name of the overloaded function we're looking for
1389 (possibly including namespace info). */
1392 make_symbol_overload_list_qualified (const char *func_name)
1394 struct compunit_symtab *cust;
1395 struct objfile *objfile;
1396 const struct block *b, *surrounding_static_block = 0;
1398 /* Look through the partial symtabs for all symbols which begin by
1399 matching FUNC_NAME. Make sure we read that symbol table in. */
1401 ALL_OBJFILES (objfile)
1404 objfile->sf->qf->expand_symtabs_for_function (objfile, func_name);
1407 /* Search upwards from currently selected frame (so that we can
1408 complete on local vars. */
1410 for (b = get_selected_block (0); b != NULL; b = BLOCK_SUPERBLOCK (b))
1411 make_symbol_overload_list_block (func_name, b);
1413 surrounding_static_block = block_static_block (get_selected_block (0));
1415 /* Go through the symtabs and check the externs and statics for
1416 symbols which match. */
1418 ALL_COMPUNITS (objfile, cust)
1421 b = BLOCKVECTOR_BLOCK (COMPUNIT_BLOCKVECTOR (cust), GLOBAL_BLOCK);
1422 make_symbol_overload_list_block (func_name, b);
1425 ALL_COMPUNITS (objfile, cust)
1428 b = BLOCKVECTOR_BLOCK (COMPUNIT_BLOCKVECTOR (cust), STATIC_BLOCK);
1429 /* Don't do this block twice. */
1430 if (b == surrounding_static_block)
1432 make_symbol_overload_list_block (func_name, b);
1436 /* Lookup the rtti type for a class name. */
1439 cp_lookup_rtti_type (const char *name, struct block *block)
1441 struct symbol * rtti_sym;
1442 struct type * rtti_type;
1444 /* Use VAR_DOMAIN here as NAME may be a typedef. PR 18141, 18417.
1445 Classes "live" in both STRUCT_DOMAIN and VAR_DOMAIN. */
1446 rtti_sym = lookup_symbol (name, block, VAR_DOMAIN, NULL).symbol;
1448 if (rtti_sym == NULL)
1450 warning (_("RTTI symbol not found for class '%s'"), name);
1454 if (SYMBOL_CLASS (rtti_sym) != LOC_TYPEDEF)
1456 warning (_("RTTI symbol for class '%s' is not a type"), name);
1460 rtti_type = check_typedef (SYMBOL_TYPE (rtti_sym));
1462 switch (TYPE_CODE (rtti_type))
1464 case TYPE_CODE_STRUCT:
1466 case TYPE_CODE_NAMESPACE:
1467 /* chastain/2003-11-26: the symbol tables often contain fake
1468 symbols for namespaces with the same name as the struct.
1469 This warning is an indication of a bug in the lookup order
1470 or a bug in the way that the symbol tables are populated. */
1471 warning (_("RTTI symbol for class '%s' is a namespace"), name);
1474 warning (_("RTTI symbol for class '%s' has bad type"), name);
1481 #ifdef HAVE_WORKING_FORK
1483 /* If nonzero, attempt to catch crashes in the demangler and print
1484 useful debugging information. */
1486 static int catch_demangler_crashes = 1;
1488 /* Stack context and environment for demangler crash recovery. */
1490 static SIGJMP_BUF gdb_demangle_jmp_buf;
1492 /* If nonzero, attempt to dump core from the signal handler. */
1494 static int gdb_demangle_attempt_core_dump = 1;
1496 /* Signal handler for gdb_demangle. */
1499 gdb_demangle_signal_handler (int signo)
1501 if (gdb_demangle_attempt_core_dump)
1506 gdb_demangle_attempt_core_dump = 0;
1509 SIGLONGJMP (gdb_demangle_jmp_buf, signo);
1514 /* A wrapper for bfd_demangle. */
1517 gdb_demangle (const char *name, int options)
1519 char *result = NULL;
1520 int crash_signal = 0;
1522 #ifdef HAVE_WORKING_FORK
1523 #if defined (HAVE_SIGACTION) && defined (SA_RESTART)
1524 struct sigaction sa, old_sa;
1528 static int core_dump_allowed = -1;
1530 if (core_dump_allowed == -1)
1532 core_dump_allowed = can_dump_core (LIMIT_CUR);
1534 if (!core_dump_allowed)
1535 gdb_demangle_attempt_core_dump = 0;
1538 if (catch_demangler_crashes)
1540 #if defined (HAVE_SIGACTION) && defined (SA_RESTART)
1541 sa.sa_handler = gdb_demangle_signal_handler;
1542 sigemptyset (&sa.sa_mask);
1543 #ifdef HAVE_SIGALTSTACK
1544 sa.sa_flags = SA_ONSTACK;
1548 sigaction (SIGSEGV, &sa, &old_sa);
1550 ofunc = signal (SIGSEGV, gdb_demangle_signal_handler);
1553 crash_signal = SIGSETJMP (gdb_demangle_jmp_buf);
1557 if (crash_signal == 0)
1558 result = bfd_demangle (NULL, name, options);
1560 #ifdef HAVE_WORKING_FORK
1561 if (catch_demangler_crashes)
1563 #if defined (HAVE_SIGACTION) && defined (SA_RESTART)
1564 sigaction (SIGSEGV, &old_sa, NULL);
1566 signal (SIGSEGV, ofunc);
1569 if (crash_signal != 0)
1571 static int error_reported = 0;
1573 if (!error_reported)
1575 std::string short_msg
1576 = string_printf (_("unable to demangle '%s' "
1577 "(demangler failed with signal %d)"),
1578 name, crash_signal);
1580 std::string long_msg
1581 = string_printf ("%s:%d: %s: %s", __FILE__, __LINE__,
1582 "demangler-warning", short_msg.c_str ());
1584 target_terminal::scoped_restore_terminal_state term_state;
1585 target_terminal::ours_for_output ();
1588 if (core_dump_allowed)
1589 fprintf_unfiltered (gdb_stderr,
1590 _("%s\nAttempting to dump core.\n"),
1593 warn_cant_dump_core (long_msg.c_str ());
1595 demangler_warning (__FILE__, __LINE__, "%s", short_msg.c_str ());
1608 /* See cp-support.h. */
1611 gdb_sniff_from_mangled_name (const char *mangled, char **demangled)
1613 *demangled = gdb_demangle (mangled, DMGL_PARAMS | DMGL_ANSI);
1614 return *demangled != NULL;
1617 /* See cp-support.h. */
1620 cp_search_name_hash (const char *search_name)
1622 /* cp_entire_prefix_len assumes a fully-qualified name with no
1624 if (startswith (search_name, "::"))
1627 unsigned int prefix_len = cp_entire_prefix_len (search_name);
1628 if (prefix_len != 0)
1629 search_name += prefix_len + 2;
1631 unsigned int hash = 0;
1632 for (const char *string = search_name; *string != '\0'; ++string)
1634 string = skip_spaces (string);
1639 /* Ignore ABI tags such as "[abi:cxx11]. */
1641 && startswith (string + 1, "abi:")
1642 && string[5] != ':')
1645 hash = SYMBOL_HASH_NEXT (hash, *string);
1650 /* Helper for cp_symbol_name_matches (i.e., symbol_name_matcher_ftype
1651 implementation for symbol_name_match_type::WILD matching). Split
1652 to a separate function for unit-testing convenience.
1654 If SYMBOL_SEARCH_NAME has more scopes than LOOKUP_NAME, we try to
1655 match ignoring the extra leading scopes of SYMBOL_SEARCH_NAME.
1656 This allows conveniently setting breakpoints on functions/methods
1657 inside any namespace/class without specifying the fully-qualified
1662 [symbol search name] [lookup name]
1663 foo::bar::func foo::bar::func
1664 foo::bar::func bar::func
1669 [symbol search name] [lookup name]
1670 foo::zbar::func bar::func
1671 foo::bar::func foo::func
1673 See more examples in the test_cp_symbol_name_matches selftest
1676 See symbol_name_matcher_ftype for description of SYMBOL_SEARCH_NAME
1679 LOOKUP_NAME/LOOKUP_NAME_LEN is the name we're looking up.
1681 See strncmp_iw_with_mode for description of MODE.
1685 cp_symbol_name_matches_1 (const char *symbol_search_name,
1686 const char *lookup_name,
1687 size_t lookup_name_len,
1688 strncmp_iw_mode mode,
1689 completion_match_result *comp_match_res)
1691 const char *sname = symbol_search_name;
1692 completion_match_for_lcd *match_for_lcd
1693 = (comp_match_res != NULL ? &comp_match_res->match_for_lcd : NULL);
1697 if (strncmp_iw_with_mode (sname, lookup_name, lookup_name_len,
1698 mode, language_cplus, match_for_lcd) == 0)
1700 if (comp_match_res != NULL)
1702 /* Note here we set different MATCH and MATCH_FOR_LCD
1703 strings. This is because with
1705 (gdb) b push_bac[TAB]
1707 we want the completion matches to list
1709 std::vector<int>::push_back(...)
1710 std::vector<char>::push_back(...)
1712 etc., which are SYMBOL_SEARCH_NAMEs, while we want
1713 the input line to auto-complete to
1715 (gdb) push_back(...)
1717 which is SNAME, not to
1721 which would be the regular common prefix between all
1722 the matches otherwise. */
1723 comp_match_res->set_match (symbol_search_name, sname);
1728 unsigned int len = cp_find_first_component (sname);
1730 if (sname[len] == '\0')
1733 gdb_assert (sname[len] == ':');
1734 /* Skip the '::'. */
1739 /* C++ symbol_name_matcher_ftype implementation. */
1742 cp_fq_symbol_name_matches (const char *symbol_search_name,
1743 const lookup_name_info &lookup_name,
1744 completion_match_result *comp_match_res)
1746 /* Get the demangled name. */
1747 const std::string &name = lookup_name.cplus ().lookup_name ();
1748 completion_match_for_lcd *match_for_lcd
1749 = (comp_match_res != NULL ? &comp_match_res->match_for_lcd : NULL);
1750 strncmp_iw_mode mode = (lookup_name.completion_mode ()
1751 ? strncmp_iw_mode::NORMAL
1752 : strncmp_iw_mode::MATCH_PARAMS);
1754 if (strncmp_iw_with_mode (symbol_search_name,
1755 name.c_str (), name.size (),
1756 mode, language_cplus, match_for_lcd) == 0)
1758 if (comp_match_res != NULL)
1759 comp_match_res->set_match (symbol_search_name);
1766 /* C++ symbol_name_matcher_ftype implementation for wild matches.
1767 Defers work to cp_symbol_name_matches_1. */
1770 cp_symbol_name_matches (const char *symbol_search_name,
1771 const lookup_name_info &lookup_name,
1772 completion_match_result *comp_match_res)
1774 /* Get the demangled name. */
1775 const std::string &name = lookup_name.cplus ().lookup_name ();
1777 strncmp_iw_mode mode = (lookup_name.completion_mode ()
1778 ? strncmp_iw_mode::NORMAL
1779 : strncmp_iw_mode::MATCH_PARAMS);
1781 return cp_symbol_name_matches_1 (symbol_search_name,
1782 name.c_str (), name.size (),
1783 mode, comp_match_res);
1786 /* See cp-support.h. */
1788 symbol_name_matcher_ftype *
1789 cp_get_symbol_name_matcher (const lookup_name_info &lookup_name)
1791 switch (lookup_name.match_type ())
1793 case symbol_name_match_type::FULL:
1794 case symbol_name_match_type::EXPRESSION:
1795 case symbol_name_match_type::SEARCH_NAME:
1796 return cp_fq_symbol_name_matches;
1797 case symbol_name_match_type::WILD:
1798 return cp_symbol_name_matches;
1801 gdb_assert_not_reached ("");
1806 namespace selftests {
1809 test_cp_symbol_name_matches ()
1811 #define CHECK_MATCH(SYMBOL, INPUT) \
1812 SELF_CHECK (cp_symbol_name_matches_1 (SYMBOL, \
1813 INPUT, sizeof (INPUT) - 1, \
1814 strncmp_iw_mode::MATCH_PARAMS, \
1817 #define CHECK_NOT_MATCH(SYMBOL, INPUT) \
1818 SELF_CHECK (!cp_symbol_name_matches_1 (SYMBOL, \
1819 INPUT, sizeof (INPUT) - 1, \
1820 strncmp_iw_mode::MATCH_PARAMS, \
1823 /* Like CHECK_MATCH, and also check that INPUT (and all substrings
1824 that start at index 0) completes to SYMBOL. */
1825 #define CHECK_MATCH_C(SYMBOL, INPUT) \
1828 CHECK_MATCH (SYMBOL, INPUT); \
1829 for (size_t i = 0; i < sizeof (INPUT) - 1; i++) \
1830 SELF_CHECK (cp_symbol_name_matches_1 (SYMBOL, INPUT, i, \
1831 strncmp_iw_mode::NORMAL, \
1835 /* Like CHECK_NOT_MATCH, and also check that INPUT does NOT complete
1837 #define CHECK_NOT_MATCH_C(SYMBOL, INPUT) \
1840 CHECK_NOT_MATCH (SYMBOL, INPUT); \
1841 SELF_CHECK (!cp_symbol_name_matches_1 (SYMBOL, INPUT, \
1842 sizeof (INPUT) - 1, \
1843 strncmp_iw_mode::NORMAL, \
1847 /* Lookup name without parens matches all overloads. */
1848 CHECK_MATCH_C ("function()", "function");
1849 CHECK_MATCH_C ("function(int)", "function");
1851 /* Check whitespace around parameters is ignored. */
1852 CHECK_MATCH_C ("function()", "function ()");
1853 CHECK_MATCH_C ("function ( )", "function()");
1854 CHECK_MATCH_C ("function ()", "function( )");
1855 CHECK_MATCH_C ("func(int)", "func( int )");
1856 CHECK_MATCH_C ("func(int)", "func ( int ) ");
1857 CHECK_MATCH_C ("func ( int )", "func( int )");
1858 CHECK_MATCH_C ("func ( int )", "func ( int ) ");
1860 /* Check symbol name prefixes aren't incorrectly matched. */
1861 CHECK_NOT_MATCH ("func", "function");
1862 CHECK_NOT_MATCH ("function", "func");
1863 CHECK_NOT_MATCH ("function()", "func");
1865 /* Check that if the lookup name includes parameters, only the right
1866 overload matches. */
1867 CHECK_MATCH_C ("function(int)", "function(int)");
1868 CHECK_NOT_MATCH_C ("function(int)", "function()");
1870 /* Check that whitespace within symbol names is not ignored. */
1871 CHECK_NOT_MATCH_C ("function", "func tion");
1872 CHECK_NOT_MATCH_C ("func__tion", "func_ _tion");
1873 CHECK_NOT_MATCH_C ("func11tion", "func1 1tion");
1875 /* Check the converse, which can happen with template function,
1876 where the return type is part of the demangled name. */
1877 CHECK_NOT_MATCH_C ("func tion", "function");
1878 CHECK_NOT_MATCH_C ("func1 1tion", "func11tion");
1879 CHECK_NOT_MATCH_C ("func_ _tion", "func__tion");
1881 /* Within parameters too. */
1882 CHECK_NOT_MATCH_C ("func(param)", "func(par am)");
1884 /* Check handling of whitespace around C++ operators. */
1885 CHECK_NOT_MATCH_C ("operator<<", "opera tor<<");
1886 CHECK_NOT_MATCH_C ("operator<<", "operator< <");
1887 CHECK_NOT_MATCH_C ("operator<<", "operator < <");
1888 CHECK_NOT_MATCH_C ("operator==", "operator= =");
1889 CHECK_NOT_MATCH_C ("operator==", "operator = =");
1890 CHECK_MATCH_C ("operator<<", "operator <<");
1891 CHECK_MATCH_C ("operator<<()", "operator <<");
1892 CHECK_NOT_MATCH_C ("operator<<()", "operator<<(int)");
1893 CHECK_NOT_MATCH_C ("operator<<(int)", "operator<<()");
1894 CHECK_MATCH_C ("operator==", "operator ==");
1895 CHECK_MATCH_C ("operator==()", "operator ==");
1896 CHECK_MATCH_C ("operator <<", "operator<<");
1897 CHECK_MATCH_C ("operator ==", "operator==");
1898 CHECK_MATCH_C ("operator bool", "operator bool");
1899 CHECK_MATCH_C ("operator bool ()", "operator bool");
1900 CHECK_MATCH_C ("operatorX<<", "operatorX < <");
1901 CHECK_MATCH_C ("Xoperator<<", "Xoperator < <");
1903 CHECK_MATCH_C ("operator()(int)", "operator()(int)");
1904 CHECK_MATCH_C ("operator()(int)", "operator ( ) ( int )");
1905 CHECK_MATCH_C ("operator()<long>(int)", "operator ( ) < long > ( int )");
1906 /* The first "()" is not the parameter list. */
1907 CHECK_NOT_MATCH ("operator()(int)", "operator");
1909 /* Misc user-defined operator tests. */
1911 CHECK_NOT_MATCH_C ("operator/=()", "operator ^=");
1912 /* Same length at end of input. */
1913 CHECK_NOT_MATCH_C ("operator>>", "operator[]");
1914 /* Same length but not at end of input. */
1915 CHECK_NOT_MATCH_C ("operator>>()", "operator[]()");
1917 CHECK_MATCH_C ("base::operator char*()", "base::operator char*()");
1918 CHECK_MATCH_C ("base::operator char*()", "base::operator char * ()");
1919 CHECK_MATCH_C ("base::operator char**()", "base::operator char * * ()");
1920 CHECK_MATCH ("base::operator char**()", "base::operator char * *");
1921 CHECK_MATCH_C ("base::operator*()", "base::operator*()");
1922 CHECK_NOT_MATCH_C ("base::operator char*()", "base::operatorc");
1923 CHECK_NOT_MATCH ("base::operator char*()", "base::operator char");
1924 CHECK_NOT_MATCH ("base::operator char*()", "base::operat");
1926 /* Check handling of whitespace around C++ scope operators. */
1927 CHECK_NOT_MATCH_C ("foo::bar", "foo: :bar");
1928 CHECK_MATCH_C ("foo::bar", "foo :: bar");
1929 CHECK_MATCH_C ("foo :: bar", "foo::bar");
1931 CHECK_MATCH_C ("abc::def::ghi()", "abc::def::ghi()");
1932 CHECK_MATCH_C ("abc::def::ghi ( )", "abc::def::ghi()");
1933 CHECK_MATCH_C ("abc::def::ghi()", "abc::def::ghi ( )");
1934 CHECK_MATCH_C ("function()", "function()");
1935 CHECK_MATCH_C ("bar::function()", "bar::function()");
1937 /* Wild matching tests follow. */
1939 /* Tests matching symbols in some scope. */
1940 CHECK_MATCH_C ("foo::function()", "function");
1941 CHECK_MATCH_C ("foo::function(int)", "function");
1942 CHECK_MATCH_C ("foo::bar::function()", "function");
1943 CHECK_MATCH_C ("bar::function()", "bar::function");
1944 CHECK_MATCH_C ("foo::bar::function()", "bar::function");
1945 CHECK_MATCH_C ("foo::bar::function(int)", "bar::function");
1947 /* Same, with parameters in the lookup name. */
1948 CHECK_MATCH_C ("foo::function()", "function()");
1949 CHECK_MATCH_C ("foo::bar::function()", "function()");
1950 CHECK_MATCH_C ("foo::function(int)", "function(int)");
1951 CHECK_MATCH_C ("foo::function()", "foo::function()");
1952 CHECK_MATCH_C ("foo::bar::function()", "bar::function()");
1953 CHECK_MATCH_C ("foo::bar::function(int)", "bar::function(int)");
1954 CHECK_MATCH_C ("bar::function()", "bar::function()");
1956 CHECK_NOT_MATCH_C ("foo::bar::function(int)", "bar::function()");
1958 CHECK_MATCH_C ("(anonymous namespace)::bar::function(int)",
1959 "bar::function(int)");
1960 CHECK_MATCH_C ("foo::(anonymous namespace)::bar::function(int)",
1963 /* Lookup scope wider than symbol scope, should not match. */
1964 CHECK_NOT_MATCH_C ("function()", "bar::function");
1965 CHECK_NOT_MATCH_C ("function()", "bar::function()");
1967 /* Explicit global scope doesn't match. */
1968 CHECK_NOT_MATCH_C ("foo::function()", "::function");
1969 CHECK_NOT_MATCH_C ("foo::function()", "::function()");
1970 CHECK_NOT_MATCH_C ("foo::function(int)", "::function()");
1971 CHECK_NOT_MATCH_C ("foo::function(int)", "::function(int)");
1973 /* Test ABI tag matching/ignoring. */
1975 /* If the symbol name has an ABI tag, but the lookup name doesn't,
1976 then the ABI tag in the symbol name is ignored. */
1977 CHECK_MATCH_C ("function[abi:foo]()", "function");
1978 CHECK_MATCH_C ("function[abi:foo](int)", "function");
1979 CHECK_MATCH_C ("function[abi:foo]()", "function ()");
1980 CHECK_NOT_MATCH_C ("function[abi:foo]()", "function (int)");
1982 CHECK_MATCH_C ("function[abi:foo]()", "function[abi:foo]");
1983 CHECK_MATCH_C ("function[abi:foo](int)", "function[abi:foo]");
1984 CHECK_MATCH_C ("function[abi:foo]()", "function[abi:foo] ()");
1985 CHECK_MATCH_C ("function[abi:foo][abi:bar]()", "function");
1986 CHECK_MATCH_C ("function[abi:foo][abi:bar](int)", "function");
1987 CHECK_MATCH_C ("function[abi:foo][abi:bar]()", "function[abi:foo]");
1988 CHECK_MATCH_C ("function[abi:foo][abi:bar](int)", "function[abi:foo]");
1989 CHECK_MATCH_C ("function[abi:foo][abi:bar]()", "function[abi:foo] ()");
1990 CHECK_NOT_MATCH_C ("function[abi:foo][abi:bar]()", "function[abi:foo] (int)");
1992 CHECK_MATCH_C ("function [abi:foo][abi:bar] ( )", "function [abi:foo]");
1994 /* If the symbol name does not have an ABI tag, while the lookup
1995 name has one, then there's no match. */
1996 CHECK_NOT_MATCH_C ("function()", "function[abi:foo]()");
1997 CHECK_NOT_MATCH_C ("function()", "function[abi:foo]");
2000 /* If non-NULL, return STR wrapped in quotes. Otherwise, return a
2001 "<null>" string (with no quotes). */
2004 quote (const char *str)
2007 return std::string (1, '\"') + str + '\"';
2012 /* Check that removing parameter info out of NAME produces EXPECTED.
2013 COMPLETION_MODE indicates whether we're testing normal and
2014 completion mode. FILE and LINE are used to provide better test
2015 location information in case ithe check fails. */
2018 check_remove_params (const char *file, int line,
2019 const char *name, const char *expected,
2020 bool completion_mode)
2022 gdb::unique_xmalloc_ptr<char> result
2023 = cp_remove_params_if_any (name, completion_mode);
2025 if ((expected == NULL) != (result == NULL)
2026 || (expected != NULL
2027 && strcmp (result.get (), expected) != 0))
2029 error (_("%s:%d: make-paramless self-test failed: (completion=%d) "
2030 "\"%s\" -> %s, expected %s"),
2031 file, line, completion_mode, name,
2032 quote (result.get ()).c_str (), quote (expected).c_str ());
2036 /* Entry point for cp_remove_params unit tests. */
2039 test_cp_remove_params ()
2041 /* Check that removing parameter info out of NAME produces EXPECTED.
2042 Checks both normal and completion modes. */
2043 #define CHECK(NAME, EXPECTED) \
2046 check_remove_params (__FILE__, __LINE__, NAME, EXPECTED, false); \
2047 check_remove_params (__FILE__, __LINE__, NAME, EXPECTED, true); \
2051 /* Similar, but used when NAME is incomplete -- i.e., is has
2052 unbalanced parentheses. In this case, looking for the exact name
2053 should fail / return empty. */
2054 #define CHECK_INCOMPL(NAME, EXPECTED) \
2057 check_remove_params (__FILE__, __LINE__, NAME, NULL, false); \
2058 check_remove_params (__FILE__, __LINE__, NAME, EXPECTED, true); \
2062 CHECK ("function()", "function");
2063 CHECK_INCOMPL ("function(", "function");
2064 CHECK ("function() const", "function");
2066 CHECK ("(anonymous namespace)::A::B::C",
2067 "(anonymous namespace)::A::B::C");
2069 CHECK ("A::(anonymous namespace)",
2070 "A::(anonymous namespace)");
2072 CHECK_INCOMPL ("A::(anonymou", "A");
2074 CHECK ("A::foo<int>()",
2077 CHECK_INCOMPL ("A::foo<int>(",
2080 CHECK ("A::foo<(anonymous namespace)::B>::func(int)",
2081 "A::foo<(anonymous namespace)::B>::func");
2083 CHECK_INCOMPL ("A::foo<(anonymous namespace)::B>::func(in",
2084 "A::foo<(anonymous namespace)::B>::func");
2086 CHECK_INCOMPL ("A::foo<(anonymous namespace)::B>::",
2087 "A::foo<(anonymous namespace)::B>");
2089 CHECK_INCOMPL ("A::foo<(anonymous namespace)::B>:",
2090 "A::foo<(anonymous namespace)::B>");
2092 CHECK ("A::foo<(anonymous namespace)::B>",
2093 "A::foo<(anonymous namespace)::B>");
2095 CHECK_INCOMPL ("A::foo<(anonymous namespace)::B",
2098 /* Shouldn't this parse? Looks like a bug in
2099 cp_demangled_name_to_comp. See PR c++/22411. */
2101 CHECK ("A::foo<void(int)>::func(int)",
2102 "A::foo<void(int)>::func");
2104 CHECK_INCOMPL ("A::foo<void(int)>::func(int)",
2108 CHECK_INCOMPL ("A::foo<void(int",
2112 #undef CHECK_INCOMPL
2115 } // namespace selftests
2117 #endif /* GDB_SELF_CHECK */
2119 /* Don't allow just "maintenance cplus". */
2122 maint_cplus_command (const char *arg, int from_tty)
2124 printf_unfiltered (_("\"maintenance cplus\" must be followed "
2125 "by the name of a command.\n"));
2126 help_list (maint_cplus_cmd_list,
2127 "maintenance cplus ",
2128 all_commands, gdb_stdout);
2131 /* This is a front end for cp_find_first_component, for unit testing.
2132 Be careful when using it: see the NOTE above
2133 cp_find_first_component. */
2136 first_component_command (const char *arg, int from_tty)
2144 len = cp_find_first_component (arg);
2145 prefix = (char *) alloca (len + 1);
2147 memcpy (prefix, arg, len);
2150 printf_unfiltered ("%s\n", prefix);
2153 /* Implement "info vtbl". */
2156 info_vtbl_command (const char *arg, int from_tty)
2158 struct value *value;
2160 value = parse_and_eval (arg);
2161 cplus_print_vtable (value);
2165 _initialize_cp_support (void)
2167 add_prefix_cmd ("cplus", class_maintenance,
2168 maint_cplus_command,
2169 _("C++ maintenance commands."),
2170 &maint_cplus_cmd_list,
2171 "maintenance cplus ",
2172 0, &maintenancelist);
2173 add_alias_cmd ("cp", "cplus",
2174 class_maintenance, 1,
2177 add_cmd ("first_component",
2179 first_component_command,
2180 _("Print the first class/namespace component of NAME."),
2181 &maint_cplus_cmd_list);
2183 add_info ("vtbl", info_vtbl_command,
2184 _("Show the virtual function table for a C++ object.\n\
2185 Usage: info vtbl EXPRESSION\n\
2186 Evaluate EXPRESSION and display the virtual function table for the\n\
2187 resulting object."));
2189 #ifdef HAVE_WORKING_FORK
2190 add_setshow_boolean_cmd ("catch-demangler-crashes", class_maintenance,
2191 &catch_demangler_crashes, _("\
2192 Set whether to attempt to catch demangler crashes."), _("\
2193 Show whether to attempt to catch demangler crashes."), _("\
2194 If enabled GDB will attempt to catch demangler crashes and\n\
2195 display the offending symbol."),
2198 &maintenance_set_cmdlist,
2199 &maintenance_show_cmdlist);
2203 selftests::register_test ("cp_symbol_name_matches",
2204 selftests::test_cp_symbol_name_matches);
2205 selftests::register_test ("cp_remove_params",
2206 selftests::test_cp_remove_params);