[AArch64] Avoid GET_MODE_NUNITS in v8.4 support
[official-gcc.git] / gcc / cp / friend.c
blob8125f1c34d2741ab2beb44c88e2a158fe4ebbd0c
1 /* Help friends in C++.
2 Copyright (C) 1997-2018 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3, or (at your option)
9 any later version.
11 GCC is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 #include "config.h"
21 #include "system.h"
22 #include "coretypes.h"
23 #include "cp-tree.h"
25 /* Friend data structures are described in cp-tree.h. */
28 /* The GLOBAL_FRIEND scope (functions, classes, or templates) is
29 regarded as a friend of every class. This is only used by libcc1,
30 to enable GDB's code snippets to access private members without
31 disabling access control in general, which could cause different
32 template overload resolution results when accessibility matters
33 (e.g. tests for an accessible member). */
35 static GTY(()) tree global_friend;
37 /* Set the GLOBAL_FRIEND for this compilation session. It might be
38 set multiple times, but always to the same scope. */
40 void
41 set_global_friend (tree scope)
43 gcc_checking_assert (scope != NULL_TREE);
44 gcc_assert (!global_friend || global_friend == scope);
45 global_friend = scope;
48 /* Return TRUE if SCOPE is the global friend. */
50 bool
51 is_global_friend (tree scope)
53 gcc_checking_assert (scope != NULL_TREE);
55 if (global_friend == scope)
56 return true;
58 if (!global_friend)
59 return false;
61 if (is_specialization_of_friend (global_friend, scope))
62 return true;
64 return false;
67 /* Returns nonzero if SUPPLICANT is a friend of TYPE. */
69 int
70 is_friend (tree type, tree supplicant)
72 int declp;
73 tree list;
74 tree context;
76 if (supplicant == NULL_TREE || type == NULL_TREE)
77 return 0;
79 if (is_global_friend (supplicant))
80 return 1;
82 declp = DECL_P (supplicant);
84 if (declp)
85 /* It's a function decl. */
87 tree list = DECL_FRIENDLIST (TYPE_MAIN_DECL (type));
88 tree name = DECL_NAME (supplicant);
90 for (; list ; list = TREE_CHAIN (list))
92 if (name == FRIEND_NAME (list))
94 tree friends = FRIEND_DECLS (list);
95 for (; friends ; friends = TREE_CHAIN (friends))
97 tree this_friend = TREE_VALUE (friends);
99 if (this_friend == NULL_TREE)
100 continue;
102 if (supplicant == this_friend)
103 return 1;
105 if (is_specialization_of_friend (supplicant, this_friend))
106 return 1;
108 break;
112 else
113 /* It's a type. */
115 if (same_type_p (supplicant, type))
116 return 1;
118 list = CLASSTYPE_FRIEND_CLASSES (TREE_TYPE (TYPE_MAIN_DECL (type)));
119 for (; list ; list = TREE_CHAIN (list))
121 tree t = TREE_VALUE (list);
123 if (TREE_CODE (t) == TEMPLATE_DECL ?
124 is_specialization_of_friend (TYPE_MAIN_DECL (supplicant), t) :
125 same_type_p (supplicant, t))
126 return 1;
130 if (declp)
132 if (DECL_FUNCTION_MEMBER_P (supplicant))
133 context = DECL_CONTEXT (supplicant);
134 else
135 context = NULL_TREE;
137 else
139 if (TYPE_CLASS_SCOPE_P (supplicant))
140 /* Nested classes get the same access as their enclosing types, as
141 per DR 45 (this is a change from the standard). */
142 context = TYPE_CONTEXT (supplicant);
143 else
144 /* Local classes have the same access as the enclosing function. */
145 context = decl_function_context (TYPE_MAIN_DECL (supplicant));
148 /* A namespace is not friend to anybody. */
149 if (context && TREE_CODE (context) == NAMESPACE_DECL)
150 context = NULL_TREE;
152 if (context)
153 return is_friend (type, context);
155 return 0;
158 /* Add a new friend to the friends of the aggregate type TYPE.
159 DECL is the FUNCTION_DECL of the friend being added.
161 If COMPLAIN is true, warning about duplicate friend is issued.
162 We want to have this diagnostics during parsing but not
163 when a template is being instantiated. */
165 void
166 add_friend (tree type, tree decl, bool complain)
168 tree typedecl;
169 tree list;
170 tree name;
171 tree ctx;
173 if (decl == error_mark_node)
174 return;
176 typedecl = TYPE_MAIN_DECL (type);
177 list = DECL_FRIENDLIST (typedecl);
178 name = DECL_NAME (decl);
179 type = TREE_TYPE (typedecl);
181 while (list)
183 if (name == FRIEND_NAME (list))
185 tree friends = FRIEND_DECLS (list);
186 for (; friends ; friends = TREE_CHAIN (friends))
188 if (decl == TREE_VALUE (friends))
190 if (complain)
191 warning (OPT_Wredundant_decls,
192 "%qD is already a friend of class %qT",
193 decl, type);
194 return;
198 TREE_VALUE (list) = tree_cons (NULL_TREE, decl,
199 TREE_VALUE (list));
200 break;
202 list = TREE_CHAIN (list);
205 ctx = DECL_CONTEXT (decl);
206 if (ctx && CLASS_TYPE_P (ctx) && !uses_template_parms (ctx))
207 perform_or_defer_access_check (TYPE_BINFO (ctx), decl, decl,
208 tf_warning_or_error);
210 maybe_add_class_template_decl_list (type, decl, /*friend_p=*/1);
212 if (!list)
213 DECL_FRIENDLIST (typedecl)
214 = tree_cons (DECL_NAME (decl), build_tree_list (NULL_TREE, decl),
215 DECL_FRIENDLIST (typedecl));
216 if (!uses_template_parms (type))
217 DECL_BEFRIENDING_CLASSES (decl)
218 = tree_cons (NULL_TREE, type,
219 DECL_BEFRIENDING_CLASSES (decl));
222 /* Make FRIEND_TYPE a friend class to TYPE. If FRIEND_TYPE has already
223 been defined, we make all of its member functions friends of
224 TYPE. If not, we make it a pending friend, which can later be added
225 when its definition is seen. If a type is defined, then its TYPE_DECL's
226 DECL_UNDEFINED_FRIENDS contains a (possibly empty) list of friend
227 classes that are not defined. If a type has not yet been defined,
228 then the DECL_WAITING_FRIENDS contains a list of types
229 waiting to make it their friend. Note that these two can both
230 be in use at the same time!
232 If COMPLAIN is true, warning about duplicate friend is issued.
233 We want to have this diagnostics during parsing but not
234 when a template is being instantiated. */
236 void
237 make_friend_class (tree type, tree friend_type, bool complain)
239 tree classes;
241 /* CLASS_TEMPLATE_DEPTH counts the number of template headers for
242 the enclosing class. FRIEND_DEPTH counts the number of template
243 headers used for this friend declaration. TEMPLATE_MEMBER_P,
244 defined inside the `if' block for TYPENAME_TYPE case, is true if
245 a template header in FRIEND_DEPTH is intended for DECLARATOR.
246 For example, the code
248 template <class T> struct A {
249 template <class U> struct B {
250 template <class V> template <class W>
251 friend class C<V>::D;
255 will eventually give the following results
257 1. CLASS_TEMPLATE_DEPTH equals 2 (for `T' and `U').
258 2. FRIEND_DEPTH equals 2 (for `V' and `W').
259 3. TEMPLATE_MEMBER_P is true (for `W').
261 The friend is a template friend iff FRIEND_DEPTH is nonzero. */
263 int class_template_depth = template_class_depth (type);
264 int friend_depth = processing_template_decl - class_template_depth;
266 if (! MAYBE_CLASS_TYPE_P (friend_type)
267 && TREE_CODE (friend_type) != TEMPLATE_TEMPLATE_PARM)
269 /* N1791: If the type specifier in a friend declaration designates a
270 (possibly cv-qualified) class type, that class is declared as a
271 friend; otherwise, the friend declaration is ignored.
273 So don't complain in C++11 mode. */
274 if (cxx_dialect < cxx11)
275 pedwarn (input_location, complain ? 0 : OPT_Wpedantic,
276 "invalid type %qT declared %<friend%>", friend_type);
277 return;
280 friend_type = cv_unqualified (friend_type);
282 if (check_for_bare_parameter_packs (friend_type))
283 return;
285 if (friend_depth)
287 /* [temp.friend] Friend declarations shall not declare partial
288 specializations. */
289 if (CLASS_TYPE_P (friend_type)
290 && CLASSTYPE_TEMPLATE_SPECIALIZATION (friend_type)
291 && uses_template_parms (friend_type))
293 error ("partial specialization %qT declared %<friend%>",
294 friend_type);
295 return;
298 if (TYPE_TEMPLATE_INFO (friend_type)
299 && !PRIMARY_TEMPLATE_P (TYPE_TI_TEMPLATE (friend_type)))
301 error ("%qT is not a template", friend_type);
302 inform (location_of (friend_type), "previous declaration here");
303 if (TYPE_CLASS_SCOPE_P (friend_type)
304 && CLASSTYPE_TEMPLATE_INFO (TYPE_CONTEXT (friend_type))
305 && currently_open_class (TYPE_CONTEXT (friend_type)))
306 inform (input_location, "perhaps you need explicit template "
307 "arguments in your nested-name-specifier");
308 return;
312 /* It makes sense for a template class to be friends with itself,
313 that means the instantiations can be friendly. Other cases are
314 not so meaningful. */
315 if (!friend_depth && same_type_p (type, friend_type))
317 if (complain)
318 warning (0, "class %qT is implicitly friends with itself",
319 type);
320 return;
323 /* [temp.friend]
325 A friend of a class or class template can be a function or
326 class template, a specialization of a function template or
327 class template, or an ordinary (nontemplate) function or
328 class. */
329 if (!friend_depth)
330 ;/* ok */
331 else if (TREE_CODE (friend_type) == TYPENAME_TYPE)
333 if (TREE_CODE (TYPENAME_TYPE_FULLNAME (friend_type))
334 == TEMPLATE_ID_EXPR)
336 /* template <class U> friend class T::X<U>; */
337 /* [temp.friend]
338 Friend declarations shall not declare partial
339 specializations. */
340 error ("partial specialization %qT declared %<friend%>",
341 friend_type);
342 return;
344 else
346 /* We will figure this out later. */
347 bool template_member_p = false;
349 tree ctype = TYPE_CONTEXT (friend_type);
350 tree name = TYPE_IDENTIFIER (friend_type);
351 tree decl;
353 if (!uses_template_parms_level (ctype, class_template_depth
354 + friend_depth))
355 template_member_p = true;
357 if (class_template_depth)
359 /* We rely on tsubst_friend_class to check the
360 validity of the declaration later. */
361 if (template_member_p)
362 friend_type
363 = make_unbound_class_template (ctype,
364 name,
365 current_template_parms,
366 tf_error);
367 else
368 friend_type
369 = make_typename_type (ctype, name, class_type, tf_error);
371 else
373 decl = lookup_member (ctype, name, 0, true, tf_warning_or_error);
374 if (!decl)
376 error ("%qT is not a member of %qT", name, ctype);
377 return;
379 if (template_member_p && !DECL_CLASS_TEMPLATE_P (decl))
381 error ("%qT is not a member class template of %qT",
382 name, ctype);
383 inform (DECL_SOURCE_LOCATION (decl),
384 "%qD declared here", decl);
385 return;
387 if (!template_member_p && (TREE_CODE (decl) != TYPE_DECL
388 || !CLASS_TYPE_P (TREE_TYPE (decl))))
390 error ("%qT is not a nested class of %qT",
391 name, ctype);
392 inform (DECL_SOURCE_LOCATION (decl),
393 "%qD declared here", decl);
394 return;
397 friend_type = CLASSTYPE_TI_TEMPLATE (TREE_TYPE (decl));
401 else if (TREE_CODE (friend_type) == TEMPLATE_TYPE_PARM)
403 /* template <class T> friend class T; */
404 error ("template parameter type %qT declared %<friend%>", friend_type);
405 return;
407 else if (TREE_CODE (friend_type) == TEMPLATE_TEMPLATE_PARM)
408 friend_type = TYPE_NAME (friend_type);
409 else if (!CLASSTYPE_TEMPLATE_INFO (friend_type))
411 /* template <class T> friend class A; where A is not a template */
412 error ("%q#T is not a template", friend_type);
413 return;
415 else
416 /* template <class T> friend class A; where A is a template */
417 friend_type = CLASSTYPE_TI_TEMPLATE (friend_type);
419 if (friend_type == error_mark_node)
420 return;
422 /* See if it is already a friend. */
423 for (classes = CLASSTYPE_FRIEND_CLASSES (type);
424 classes;
425 classes = TREE_CHAIN (classes))
427 tree probe = TREE_VALUE (classes);
429 if (TREE_CODE (friend_type) == TEMPLATE_DECL)
431 if (friend_type == probe)
433 if (complain)
434 warning (OPT_Wredundant_decls,
435 "%qD is already a friend of %qT", probe, type);
436 break;
439 else if (TREE_CODE (probe) != TEMPLATE_DECL)
441 if (same_type_p (probe, friend_type))
443 if (complain)
444 warning (OPT_Wredundant_decls,
445 "%qT is already a friend of %qT", probe, type);
446 break;
451 if (!classes)
453 maybe_add_class_template_decl_list (type, friend_type, /*friend_p=*/1);
455 CLASSTYPE_FRIEND_CLASSES (type)
456 = tree_cons (NULL_TREE, friend_type, CLASSTYPE_FRIEND_CLASSES (type));
457 if (TREE_CODE (friend_type) == TEMPLATE_DECL)
458 friend_type = TREE_TYPE (friend_type);
459 if (!uses_template_parms (type))
460 CLASSTYPE_BEFRIENDING_CLASSES (friend_type)
461 = tree_cons (NULL_TREE, type,
462 CLASSTYPE_BEFRIENDING_CLASSES (friend_type));
466 /* Record DECL (a FUNCTION_DECL) as a friend of the
467 CURRENT_CLASS_TYPE. If DECL is a member function, CTYPE is the
468 class of which it is a member, as named in the friend declaration.
469 DECLARATOR is the name of the friend. FUNCDEF_FLAG is true if the
470 friend declaration is a definition of the function. FLAGS is as
471 for grokclass fn. */
473 tree
474 do_friend (tree ctype, tree declarator, tree decl,
475 tree attrlist, enum overload_flags flags,
476 bool funcdef_flag)
478 gcc_assert (TREE_CODE (decl) == FUNCTION_DECL);
479 gcc_assert (!ctype || MAYBE_CLASS_TYPE_P (ctype));
481 /* Every decl that gets here is a friend of something. */
482 DECL_FRIEND_P (decl) = 1;
484 if (DECL_OVERRIDE_P (decl) || DECL_FINAL_P (decl))
485 error ("friend declaration %qD may not have virt-specifiers",
486 decl);
488 /* Unfortunately, we have to handle attributes here. Normally we would
489 handle them in start_decl_1, but since this is a friend decl start_decl_1
490 never gets to see it. */
492 /* Set attributes here so if duplicate decl, will have proper attributes. */
493 cplus_decl_attributes (&decl, attrlist, 0);
495 if (TREE_CODE (declarator) == TEMPLATE_ID_EXPR)
497 declarator = TREE_OPERAND (declarator, 0);
498 declarator = OVL_NAME (declarator);
501 if (ctype)
503 /* CLASS_TEMPLATE_DEPTH counts the number of template headers for
504 the enclosing class. FRIEND_DEPTH counts the number of template
505 headers used for this friend declaration. TEMPLATE_MEMBER_P is
506 true if a template header in FRIEND_DEPTH is intended for
507 DECLARATOR. For example, the code
509 template <class T> struct A {
510 template <class U> struct B {
511 template <class V> template <class W>
512 friend void C<V>::f(W);
516 will eventually give the following results
518 1. CLASS_TEMPLATE_DEPTH equals 2 (for `T' and `U').
519 2. FRIEND_DEPTH equals 2 (for `V' and `W').
520 3. TEMPLATE_MEMBER_P is true (for `W'). */
522 int class_template_depth = template_class_depth (current_class_type);
523 int friend_depth = processing_template_decl - class_template_depth;
524 /* We will figure this out later. */
525 bool template_member_p = false;
527 tree cname = TYPE_NAME (ctype);
528 if (TREE_CODE (cname) == TYPE_DECL)
529 cname = DECL_NAME (cname);
531 /* A method friend. */
532 if (flags == NO_SPECIAL && declarator == cname)
533 DECL_CXX_CONSTRUCTOR_P (decl) = 1;
535 grokclassfn (ctype, decl, flags);
537 if (friend_depth)
539 if (!uses_template_parms_level (ctype, class_template_depth
540 + friend_depth))
541 template_member_p = true;
544 /* A nested class may declare a member of an enclosing class
545 to be a friend, so we do lookup here even if CTYPE is in
546 the process of being defined. */
547 if (class_template_depth
548 || COMPLETE_OR_OPEN_TYPE_P (ctype))
550 if (DECL_TEMPLATE_INFO (decl))
551 /* DECL is a template specialization. No need to
552 build a new TEMPLATE_DECL. */
554 else if (class_template_depth)
555 /* We rely on tsubst_friend_function to check the
556 validity of the declaration later. */
557 decl = push_template_decl_real (decl, /*is_friend=*/true);
558 else
559 decl = check_classfn (ctype, decl,
560 template_member_p
561 ? current_template_parms
562 : NULL_TREE);
564 if ((template_member_p
565 /* Always pull out the TEMPLATE_DECL if we have a friend
566 template in a class template so that it gets tsubsted
567 properly later on (59956). tsubst_friend_function knows
568 how to tell this apart from a member template. */
569 || (class_template_depth && friend_depth))
570 && decl && TREE_CODE (decl) == FUNCTION_DECL)
571 decl = DECL_TI_TEMPLATE (decl);
573 if (decl)
574 add_friend (current_class_type, decl, /*complain=*/true);
576 else
577 error ("member %qD declared as friend before type %qT defined",
578 decl, ctype);
580 /* A global friend.
581 @@ or possibly a friend from a base class ?!? */
582 else if (TREE_CODE (decl) == FUNCTION_DECL)
584 int is_friend_template = PROCESSING_REAL_TEMPLATE_DECL_P ();
586 /* Friends must all go through the overload machinery,
587 even though they may not technically be overloaded.
589 Note that because classes all wind up being top-level
590 in their scope, their friend wind up in top-level scope as well. */
591 if (funcdef_flag)
592 SET_DECL_FRIEND_CONTEXT (decl, current_class_type);
594 if (! DECL_USE_TEMPLATE (decl))
596 /* We must check whether the decl refers to template
597 arguments before push_template_decl_real adds a
598 reference to the containing template class. */
599 int warn = (warn_nontemplate_friend
600 && ! funcdef_flag && ! is_friend_template
601 && current_template_parms
602 && uses_template_parms (decl));
604 if (is_friend_template
605 || template_class_depth (current_class_type) != 0)
606 /* We can't call pushdecl for a template class, since in
607 general, such a declaration depends on template
608 parameters. Instead, we call pushdecl when the class
609 is instantiated. */
610 decl = push_template_decl_real (decl, /*is_friend=*/true);
611 else if (current_function_decl)
612 /* pushdecl will check there's a local decl already. */
613 decl = pushdecl (decl, /*is_friend=*/true);
614 else
616 /* We can't use pushdecl, as we might be in a template
617 class specialization, and pushdecl will insert an
618 unqualified friend decl into the template parameter
619 scope, rather than the namespace containing it. */
620 tree ns = decl_namespace_context (decl);
622 push_nested_namespace (ns);
623 decl = pushdecl_namespace_level (decl, /*is_friend=*/true);
624 pop_nested_namespace (ns);
627 if (warn)
629 static int explained;
630 bool warned;
632 warned = warning (OPT_Wnon_template_friend, "friend declaration "
633 "%q#D declares a non-template function", decl);
634 if (! explained && warned)
636 inform (input_location, "(if this is not what you intended, make sure "
637 "the function template has already been declared "
638 "and add <> after the function name here) ");
639 explained = 1;
644 if (decl == error_mark_node)
645 return error_mark_node;
647 add_friend (current_class_type,
648 is_friend_template ? DECL_TI_TEMPLATE (decl) : decl,
649 /*complain=*/true);
650 DECL_FRIEND_P (decl) = 1;
653 return decl;
656 #include "gt-cp-friend.h"