1/* Demangler component interface functions.
2   Copyright (C) 2004-2022 Free Software Foundation, Inc.
3   Written by Ian Lance Taylor <ian@wasabisystems.com>.
4
5   This file is part of the libiberty library, which is part of GCC.
6
7   This file is free software; you can redistribute it and/or modify
8   it under the terms of the GNU General Public License as published by
9   the Free Software Foundation; either version 2 of the License, or
10   (at your option) any later version.
11
12   In addition to the permissions in the GNU General Public License, the
13   Free Software Foundation gives you unlimited permission to link the
14   compiled version of this file into combinations with other programs,
15   and to distribute those combinations without any restriction coming
16   from the use of this file.  (The General Public License restrictions
17   do apply in other respects; for example, they cover modification of
18   the file, and distribution when not linked into a combined
19   executable.)
20
21   This program is distributed in the hope that it will be useful,
22   but WITHOUT ANY WARRANTY; without even the implied warranty of
23   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
24   GNU General Public License for more details.
25
26   You should have received a copy of the GNU General Public License
27   along with this program; if not, write to the Free Software
28   Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.
29*/
30
31/* This file implements a few interface functions which are provided
32   for use with struct demangle_component trees.  These functions are
33   declared in demangle.h.  These functions are closely tied to the
34   demangler code in cp-demangle.c, and other interface functions can
35   be found in that file.  We put these functions in a separate file
36   because they are not needed by the demangler, and so we avoid
37   having them pulled in by programs which only need the
38   demangler.  */
39
40#ifdef HAVE_CONFIG_H
41#include "config.h"
42#endif
43
44#ifdef HAVE_STDLIB_H
45#include <stdlib.h>
46#endif
47#ifdef HAVE_STRING_H
48#include <string.h>
49#endif
50
51#include "ansidecl.h"
52#include "libiberty.h"
53#include "demangle.h"
54#include "cp-demangle.h"
55
56/* Fill in most component types.  */
57
58int
59cplus_demangle_fill_component (struct demangle_component *p,
60                               enum demangle_component_type type,
61                               struct demangle_component *left,
62                                struct demangle_component *right)
63{
64  if (p == NULL)
65    return 0;
66  switch (type)
67    {
68    case DEMANGLE_COMPONENT_QUAL_NAME:
69    case DEMANGLE_COMPONENT_LOCAL_NAME:
70    case DEMANGLE_COMPONENT_TYPED_NAME:
71    case DEMANGLE_COMPONENT_TEMPLATE:
72    case DEMANGLE_COMPONENT_CONSTRUCTION_VTABLE:
73    case DEMANGLE_COMPONENT_VENDOR_TYPE_QUAL:
74    case DEMANGLE_COMPONENT_FUNCTION_TYPE:
75    case DEMANGLE_COMPONENT_ARRAY_TYPE:
76    case DEMANGLE_COMPONENT_PTRMEM_TYPE:
77    case DEMANGLE_COMPONENT_ARGLIST:
78    case DEMANGLE_COMPONENT_TEMPLATE_ARGLIST:
79    case DEMANGLE_COMPONENT_UNARY:
80    case DEMANGLE_COMPONENT_BINARY:
81    case DEMANGLE_COMPONENT_BINARY_ARGS:
82    case DEMANGLE_COMPONENT_TRINARY:
83    case DEMANGLE_COMPONENT_TRINARY_ARG1:
84    case DEMANGLE_COMPONENT_TRINARY_ARG2:
85    case DEMANGLE_COMPONENT_LITERAL:
86    case DEMANGLE_COMPONENT_LITERAL_NEG:
87      break;
88
89      /* These component types only have one subtree.  */
90    case DEMANGLE_COMPONENT_VTABLE:
91    case DEMANGLE_COMPONENT_VTT:
92    case DEMANGLE_COMPONENT_TYPEINFO:
93    case DEMANGLE_COMPONENT_TYPEINFO_NAME:
94    case DEMANGLE_COMPONENT_TYPEINFO_FN:
95    case DEMANGLE_COMPONENT_THUNK:
96    case DEMANGLE_COMPONENT_VIRTUAL_THUNK:
97    case DEMANGLE_COMPONENT_COVARIANT_THUNK:
98    case DEMANGLE_COMPONENT_JAVA_CLASS:
99    case DEMANGLE_COMPONENT_GUARD:
100    case DEMANGLE_COMPONENT_REFTEMP:
101    case DEMANGLE_COMPONENT_RESTRICT:
102    case DEMANGLE_COMPONENT_VOLATILE:
103    case DEMANGLE_COMPONENT_CONST:
104    case DEMANGLE_COMPONENT_RESTRICT_THIS:
105    case DEMANGLE_COMPONENT_VOLATILE_THIS:
106    case DEMANGLE_COMPONENT_CONST_THIS:
107    case DEMANGLE_COMPONENT_POINTER:
108    case DEMANGLE_COMPONENT_REFERENCE:
109    case DEMANGLE_COMPONENT_RVALUE_REFERENCE:
110    case DEMANGLE_COMPONENT_COMPLEX:
111    case DEMANGLE_COMPONENT_IMAGINARY:
112    case DEMANGLE_COMPONENT_VENDOR_TYPE:
113    case DEMANGLE_COMPONENT_CAST:
114    case DEMANGLE_COMPONENT_CONVERSION:
115      if (right != NULL)
116	return 0;
117      break;
118
119    default:
120      /* Other types do not use subtrees.  */
121      return 0;
122    }
123
124  p->type = type;
125  p->u.s_binary.left = left;
126  p->u.s_binary.right = right;
127  p->d_printing = 0;
128  p->d_counting = 0;
129
130  return 1;
131}
132
133/* Fill in a DEMANGLE_COMPONENT_BUILTIN_TYPE.  */
134
135int
136cplus_demangle_fill_builtin_type (struct demangle_component *p,
137                                  const char *type_name)
138{
139  int len;
140  unsigned int i;
141
142  if (p == NULL || type_name == NULL)
143    return 0;
144  len = strlen (type_name);
145  for (i = 0; i < D_BUILTIN_TYPE_COUNT; ++i)
146    {
147      if (len == cplus_demangle_builtin_types[i].len
148	  && strcmp (type_name, cplus_demangle_builtin_types[i].name) == 0)
149	{
150	  p->type = DEMANGLE_COMPONENT_BUILTIN_TYPE;
151	  p->u.s_builtin.type = &cplus_demangle_builtin_types[i];
152	  p->d_printing = 0;
153	  p->d_counting = 0;
154	  return 1;
155	}
156    }
157  return 0;
158}
159
160/* Fill in a DEMANGLE_COMPONENT_OPERATOR.  */
161
162int
163cplus_demangle_fill_operator (struct demangle_component *p,
164                              const char *opname, int args)
165{
166  int len;
167  unsigned int i;
168
169  if (p == NULL || opname == NULL)
170    return 0;
171  len = strlen (opname);
172  for (i = 0; cplus_demangle_operators[i].name != NULL; ++i)
173    {
174      if (len == cplus_demangle_operators[i].len
175	  && args == cplus_demangle_operators[i].args
176	  && strcmp (opname, cplus_demangle_operators[i].name) == 0)
177	{
178	  p->type = DEMANGLE_COMPONENT_OPERATOR;
179	  p->u.s_operator.op = &cplus_demangle_operators[i];
180	  p->d_printing = 0;
181	  p->d_counting = 0;
182	  return 1;
183	}
184    }
185  return 0;
186}
187
188/* Translate a mangled name into components.  */
189
190struct demangle_component *
191cplus_demangle_v3_components (const char *mangled, int options, void **mem)
192{
193  size_t len;
194  int type;
195  struct d_info di;
196  struct demangle_component *dc;
197
198  len = strlen (mangled);
199
200  if (mangled[0] == '_' && mangled[1] == 'Z')
201    type = 0;
202  else
203    {
204      if ((options & DMGL_TYPES) == 0)
205	return NULL;
206      type = 1;
207    }
208
209  cplus_demangle_init_info (mangled, options, len, &di);
210
211  di.comps = ((struct demangle_component *)
212	      malloc (di.num_comps * sizeof (struct demangle_component)));
213  di.subs = ((struct demangle_component **)
214	     malloc (di.num_subs * sizeof (struct demangle_component *)));
215  if (di.comps == NULL || di.subs == NULL)
216    {
217      free (di.comps);
218      free (di.subs);
219      return NULL;
220    }
221
222  if (! type)
223    dc = cplus_demangle_mangled_name (&di, 1);
224  else
225    dc = cplus_demangle_type (&di);
226
227  /* If DMGL_PARAMS is set, then if we didn't consume the entire
228     mangled string, then we didn't successfully demangle it.  */
229  if ((options & DMGL_PARAMS) != 0 && d_peek_char (&di) != '\0')
230    dc = NULL;
231
232  free (di.subs);
233
234  if (dc != NULL)
235    *mem = di.comps;
236  else
237    free (di.comps);
238
239  return dc;
240}
241