| blob | cd293b9fab6087574573d792705c44a3f2971e38 |
1 /* Handle parameterized types (templates) for GNU C++.
2 Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003 Free Software Foundation, Inc.
4 Written by Ken Raeburn (raeburn@cygnus.com) while at Watchmaker Computing.
5 Rewritten by Jason Merrill (jason@cygnus.com).
7 This file is part of GCC.
9 GCC is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2, or (at your option)
12 any later version.
14 GCC 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.
19 You should have received a copy of the GNU General Public License
20 along with GCC; see the file COPYING. If not, write to
21 the Free Software Foundation, 59 Temple Place - Suite 330,
22 Boston, MA 02111-1307, USA. */
24 /* Known bugs or deficiencies include:
26 all methods must be provided in header files; can't use a source
27 file that contains only the method templates and "just win". */
46 /* The type of functions taking a tree, and some additional data, and
47 returning an int. */
50 /* The PENDING_TEMPLATES is a TREE_LIST of templates whose
51 instantiations have been deferred, either because their definitions
52 were not yet available, or because we were putting off doing the work.
53 The TREE_PURPOSE of each entry is either a DECL (for a function or
54 static data member), or a TYPE (for a class) indicating what we are
55 hoping to instantiate. The TREE_VALUE is not used. */
70 /* A map from local variable declarations in the body of the template
71 presently being instantiated to the corresponding instantiated
72 local variables. */
75 #define UNIFY_ALLOW_NONE 0
76 #define UNIFY_ALLOW_MORE_CV_QUAL 1
77 #define UNIFY_ALLOW_LESS_CV_QUAL 2
78 #define UNIFY_ALLOW_DERIVED 4
79 #define UNIFY_ALLOW_INTEGER 8
80 #define UNIFY_ALLOW_OUTER_LEVEL 16
81 #define UNIFY_ALLOW_OUTER_MORE_CV_QUAL 32
82 #define UNIFY_ALLOW_OUTER_LESS_CV_QUAL 64
83 #define UNIFY_ALLOW_MAX_CORRECTION 128
86 virtual, or a base class of a virtual
87 base. */
89 type with the desired type. */
171 /* Make the current scope suitable for access checking when we are
172 processing T. T can be FUNCTION_DECL for instantiated function
173 template, or VAR_DECL for static member variable (need by
174 instantiate_decl). */
176 static void
178 {
185 else
189 {
190 saved_access_scope = tree_cons
193 }
194 }
196 /* Restore the scope set up by push_access_scope. T is the node we
197 are processing. */
199 static void
201 {
203 {
206 }
210 else
212 }
214 /* Do any processing required when DECL (a member template
215 declaration) is finished. Returns the TEMPLATE_DECL corresponding
216 to DECL, unless it is a specialization, in which case the DECL
217 itself is returned. */
219 tree
221 {
228 {
229 tree type;
235 {
239 }
241 }
245 {
247 {
250 }
251 else
253 }
254 else
258 }
260 /* Returns the template nesting level of the indicated class TYPE.
262 For example, in:
263 template <class T>
264 struct A
265 {
266 template <class U>
267 struct B {};
268 };
270 A<T>::B<U> has depth two, while A<T> has depth one.
271 Both A<T>::B<int> and A<int>::B<U> have depth one, if
272 COUNT_SPECIALIZATIONS is 0 or if they are instantiations, not
273 specializations.
275 This function is guaranteed to return 0 if passed NULL_TREE so
276 that, for example, `template_class_depth (current_class_type)' is
277 always safe. */
279 static int
281 {
288 {
290 {
293 && ((count_specializations
297 }
298 else
299 {
302 && ((count_specializations
306 }
307 }
310 }
312 /* Returns the template nesting level of the indicated class TYPE.
313 Like template_class_depth_real, but instantiations do not count in
314 the depth. */
316 int
318 {
320 }
322 /* Returns 1 if processing DECL as part of do_pending_inlines
323 needs us to push template parms. */
325 static int
327 {
333 }
335 /* Subroutine of maybe_begin_member_template_processing.
336 Push the template parms in PARMS, starting from LEVELS steps into the
337 chain, and ending at the beginning, since template parms are listed
338 innermost first. */
340 static void
342 {
350 current_template_parms
356 NULL);
358 {
363 {
370 {
371 /* Make a CONST_DECL as is done in process_template_parm.
372 It is ugly that we recreate this here; the original
373 version built in process_template_parm is no longer
374 available. */
382 }
387 }
388 }
389 }
391 /* Restore the template parameter context for a member template or
392 a friend template defined in a class definition. */
394 void
396 {
397 tree parms;
401 {
406 {
409 }
412 }
414 /* Remember how many levels of template parameters we pushed so that
415 we can pop them later. */
422 }
424 /* Undo the effects of begin_member_template_processing. */
426 void
428 {
438 {
442 }
443 }
445 /* Returns nonzero iff T is a member template function. We must be
446 careful as in
448 template <class T> class C { void f(); }
450 Here, f is a template function, and a member, but not a member
451 template. This function does not concern itself with the origin of
452 T, only its present state. So if we have
454 template <class T> class C { template <class U> void f(U); }
456 then neither C<int>::f<char> nor C<T>::f<double> is considered
457 to be a member template. But, `template <class U> void
458 C<int>::f(U)' is considered a member template. */
460 int
462 {
464 /* Anything that isn't a function or a template function is
465 certainly not a member template. */
468 /* A local class can't have member templates. */
473 /* If there are more levels of template parameters than
474 there are template classes surrounding the declaration,
475 then we have a member template. */
478 }
481 /* Returns nonzero iff T is a member template class. See
482 is_member_template for a description of what precisely constitutes
483 a member template. */
485 int
487 {
489 /* Anything that isn't a class template, is certainly not a member
490 template. */
494 /* Anything whose context isn't a class type is surely not a
495 member template. */
498 /* If there are more levels of template parameters than there are
499 template classes surrounding the declaration, then we have a
500 member template. */
503 }
504 #endif
506 /* Return a new template argument vector which contains all of ARGS,
507 but has as its innermost set of arguments the EXTRA_ARGS. */
509 static tree
511 {
512 tree new_args;
527 }
529 /* Like add_to_template_args, but only the outermost ARGS are added to
530 the EXTRA_ARGS. In particular, all but TMPL_ARGS_DEPTH
531 (EXTRA_ARGS) levels are added. This function is used to combine
532 the template arguments from a partial instantiation with the
533 template arguments used to attain the full instantiation from the
534 partial instantiation. */
536 static tree
538 {
539 tree new_args;
541 /* If there are more levels of EXTRA_ARGS than there are ARGS,
542 something very fishy is going on. */
546 /* If *all* the new arguments will be the EXTRA_ARGS, just return
547 them. */
551 /* For the moment, we make ARGS look like it contains fewer levels. */
556 /* Now, we restore ARGS to its full dimensions. */
560 }
562 /* Return the N levels of innermost template arguments from the ARGS. */
564 tree
566 {
567 tree new_args;
573 /* If N is 1, just return the innermost set of template arguments. */
577 /* If we're not removing anything, just return the arguments we were
578 given. */
584 /* Make a new set of arguments, not containing the outer arguments. */
591 }
593 /* We've got a template header coming up; push to a new level for storing
594 the parms. */
596 void
598 {
599 /* We use a non-tag-transparent scope here, which causes pushtag to
600 put tags in this scope, rather than in the enclosing class or
601 namespace scope. This is the right thing, since we want
602 TEMPLATE_DECLS, and not TYPE_DECLS for template classes. For a
603 global template class, push_template_decl handles putting the
604 TEMPLATE_DECL into top-level scope. For a nested template class,
605 e.g.:
607 template <class T> struct S1 {
608 template <class T> struct S2 {};
609 };
611 pushtag contains special code to call pushdecl_with_scope on the
612 TEMPLATE_DECL for S2. */
617 }
619 /* This routine is called when a specialization is declared. If it is
620 invalid to declare a specialization here, an error is reported. */
622 static void
624 {
627 /* [temp.expl.spec]
629 An explicit specialization shall be declared in the namespace of
630 which the template is a member, or, for member templates, in the
631 namespace of which the enclosing class or enclosing class
632 template is a member. An explicit specialization of a member
633 function, member class or static data member of a class template
634 shall be declared in the namespace of which the class template
635 is a member. */
638 scope);
640 /* [temp.expl.spec]
642 In an explicit specialization declaration for a member of a class
643 template or a member template that appears in namespace scope,
644 the member template and some of its enclosing class templates may
645 remain unspecialized, except that the declaration shall not
646 explicitly specialize a class member template if its enclosing
647 class templates are not explicitly specialized as well. */
650 }
652 /* We've just seen template <>. */
654 void
656 {
660 }
662 /* Called at then end of processing a declaration preceded by
663 template<>. */
665 void
667 {
670 }
672 /* Any template <>'s that we have seen thus far are not referring to a
673 function specialization. */
675 void
677 {
680 }
682 /* We've just seen a template header. If SPECIALIZATION is nonzero,
683 it was of the form template <>. */
685 static void
687 {
689 template_header_count++;
690 }
692 /* We're beginning an explicit instantiation. */
694 void
696 {
699 }
702 void
704 {
707 }
709 /* The TYPE is being declared. If it is a template type, that means it
710 is a partial specialization. Do appropriate error-checking. */
712 void
714 {
715 /* TYPE maybe an ERROR_MARK_NODE. */
719 {
720 /* This is for ordinary explicit specialization and partial
721 specialization of a template class such as:
723 template <> class C<int>;
725 or:
727 template <class T> class C<T*>;
729 Make sure that `C<int>' and `C<T*>' are implicit instantiations. */
733 {
737 else
738 {
742 }
746 }
749 }
755 {
756 /* This is for an explicit specialization of member class
757 template according to [temp.expl.spec/18]:
759 template <> template <class U> class C<int>::D;
761 The context `C<int>' must be an implicit instantiation.
762 Otherwise this is just a member class template declared
763 earlier like:
765 template <> class C<int> { template <class U> class D; };
766 template <> template <class U> class C<int>::D;
768 In the first case, `C<int>::D' is a specialization of `C<T>::D'
769 while in the second case, `C<int>::D' is a primary template
770 and `C<T>::D' may not exist. */
774 {
775 tree t;
779 {
783 }
785 /* Check for invalid specialization after instantiation:
787 template <> template <> class C<int>::D<int>;
788 template <> template <class U> class C<int>::D; */
798 /* Mark TYPE as a specialization. And as a result, we only
799 have one level of template argument for the innermost
800 class template. */
804 }
805 }
808 }
810 /* Retrieve the specialization (in the sense of [temp.spec] - a
811 specialization is either an instantiation or an explicit
812 specialization) of TMPL for the given template ARGS. If there is
813 no such specialization, return NULL_TREE. The ARGS are a vector of
814 arguments, or a vector of vectors of arguments, in the case of
815 templates with more than one level of parameters. */
817 static tree
819 {
820 tree s;
824 /* There should be as many levels of arguments as there are
825 levels of parameters. */
837 }
839 /* Like retrieve_specialization, but for local declarations. */
841 static tree
843 {
847 }
849 /* Returns nonzero iff DECL is a specialization of TMPL. */
851 int
853 {
854 tree t;
857 {
863 }
864 else
865 {
874 }
877 }
879 /* Returns nonzero iff DECL is a specialization of friend declaration
880 FRIEND according to [temp.friend]. */
882 bool
884 {
890 /* For [temp.friend/6] when FRIEND is an ordinary member function
891 of a template class, we want to check if DECL is a specialization
892 if this. */
896 {
899 }
901 /* There is nothing to do if this is not a template friend. */
908 /* [temp.friend/6]
909 A member of a class template may be declared to be a friend of a
910 non-template class. In this case, the corresponding member of
911 every specialization of the class template is a friend of the
912 class granting friendship.
914 For example, given a template friend declaration
916 template <class T> friend void A<T>::f();
918 the member function below is considered a friend
920 template <> struct A<int> {
921 void f();
922 };
924 For this type of template friend, TEMPLATE_DEPTH below will be
925 nonzero. To determine if DECL is a friend of FRIEND, we first
926 check if the enclosing class is a specialization of another. */
933 {
934 /* Next, we check the members themselves. In order to handle
935 a few tricky cases like
937 template <class T> friend void A<T>::g(T t);
938 template <class T> template <T t> friend void A<T>::h();
940 we need to figure out what ARGS is (corresponding to `T' in above
941 examples) from DECL for later processing. */
947 {
949 {
952 else
954 current_depth++;
955 }
957 }
960 {
962 tree friend_type;
963 tree decl_type;
964 tree friend_args_type;
965 tree decl_args_type;
967 /* Make sure that both DECL and FRIEND are templates or
968 non-templates. */
974 {
975 /* If both are templates, check template paramter list. */
976 tree friend_parms
981 friend_parms))
985 }
986 else
994 /* Check if return types match. */
998 /* Check if function parameter types match, ignoring the
999 `this' parameter. */
1008 }
1009 }
1011 }
1013 /* Register the specialization SPEC as a specialization of TMPL with
1014 the indicated ARGS. Returns SPEC, or an equivalent prior
1015 declaration, if available. */
1017 static tree
1019 {
1020 tree s;
1026 /* This is the FUNCTION_DECL for a partial instantiation. Don't
1027 register it; we want the corresponding TEMPLATE_DECL instead.
1028 We use `uses_template_parms (DECL_TI_ARGS (spec))' rather than
1029 the more obvious `uses_template_parms (spec)' to avoid problems
1030 with default function arguments. In particular, given
1031 something like this:
1033 template <class T> void f(T t1, T t = T())
1035 the default argument expression is not substituted for in an
1036 instantiation unless and until it is actually needed. */
1039 /* There should be as many levels of arguments as there are
1040 levels of parameters. */
1048 {
1051 /* We can sometimes try to re-register a specialization that we've
1052 already got. In particular, regenerate_decl_from_template
1053 calls duplicate_decls which will update the specialization
1054 list. But, we'll still get called again here anyhow. It's
1055 more convenient to simply allow this than to try to prevent it. */
1059 {
1061 {
1063 {
1066 {
1068 fn);
1070 }
1071 else
1072 {
1073 /* This situation should occur only if the first
1074 specialization is an implicit instantiation,
1075 the second is an explicit specialization, and
1076 the implicit instantiation has not yet been
1077 used. That situation can occur if we have
1078 implicitly instantiated a member function and
1079 then specialized it later.
1081 We can also wind up here if a friend
1082 declaration that looked like an instantiation
1083 turns out to be a specialization:
1085 template <class T> void foo(T);
1086 class S { friend void foo<>(int) };
1087 template <> void foo(int);
1089 We transform the existing DECL in place so that
1090 any pointers to it become pointers to the
1091 updated declaration.
1093 If there was a definition for the template, but
1094 not for the specialization, we want this to
1095 look as if there is no definition, and vice
1096 versa. */
1101 }
1102 }
1104 {
1106 /* Dup decl failed, but this is a new
1107 definition. Set the line number so any errors
1108 match this new definition. */
1112 }
1113 }
1114 }
1115 }
1121 }
1123 /* Unregister the specialization SPEC as a specialization of TMPL.
1124 Replace it with NEW_SPEC, if NEW_SPEC is non-NULL. Returns true
1125 if the SPEC was listed as a specialization of TMPL. */
1127 bool
1129 {
1136 {
1139 else
1142 }
1145 }
1147 /* Compare an entry in the local specializations hash table P1 (which
1148 is really a pointer to a TREE_LIST) with P2 (which is really a
1149 DECL). */
1151 static int
1153 {
1155 }
1157 /* Hash P1, an entry in the local specializations table. */
1159 static hashval_t
1161 {
1163 }
1165 /* Like register_specialization, but for local declarations. We are
1166 registering SPEC, an instantiation of TMPL. */
1168 static void
1170 {
1176 }
1178 /* Print the list of candidate FNS in an error message. */
1180 void
1182 {
1183 tree fn;
1188 {
1189 tree f;
1194 }
1195 }
1197 /* Returns the template (one of the functions given by TEMPLATE_ID)
1198 which can be specialized to match the indicated DECL with the
1199 explicit template args given in TEMPLATE_ID. The DECL may be
1200 NULL_TREE if none is available. In that case, the functions in
1201 TEMPLATE_ID are non-members.
1203 If NEED_MEMBER_TEMPLATE is nonzero the function is known to be a
1204 specialization of a member template.
1206 The template args (those explicitly specified and those deduced)
1207 are output in a newly created vector *TARGS_OUT.
1209 If it is impossible to determine the result, an error message is
1210 issued. The error_mark_node is returned to indicate failure. */
1212 static tree
1214 tree decl,
1217 {
1218 tree fns;
1219 tree targs;
1220 tree explicit_targs;
1235 /* Check for baselinks. */
1240 {
1243 }
1246 {
1250 {
1251 tree decl_arg_types;
1253 /* DECL might be a specialization of FN. */
1255 /* Adjust the type of DECL in case FN is a static member. */
1261 /* Check that the number of function parameters matches.
1262 For example,
1263 template <class T> void f(int i = 0);
1264 template <> void f<int>();
1265 The specialization f<int> is invalid but is not caught
1266 by get_bindings below. */
1272 /* See whether this function might be a specialization of this
1273 template. */
1277 /* We cannot deduce template arguments that when used to
1278 specialize TMPL will produce DECL. */
1281 /* Save this template, and the arguments deduced. */
1283 }
1285 /* FN is an ordinary member function, and we need a
1286 specialization of a member template. */
1287 ;
1289 /* We can get IDENTIFIER_NODEs here in certain erroneous
1290 cases. */
1291 ;
1293 /* This is just an ordinary non-member function. Nothing can
1294 be a specialization of that. */
1295 ;
1297 /* Cannot specialize functions that are created implicitly. */
1298 ;
1299 else
1300 {
1301 tree decl_arg_types;
1303 /* This is an ordinary member function. However, since
1304 we're here, we can assume it's enclosing class is a
1305 template class. For example,
1307 template <typename T> struct S { void f(); };
1308 template <> void S<int>::f() {}
1310 Here, S<int>::f is a non-template, but S<int> is a
1311 template class. If FN has the same type as DECL, we
1312 might be in business. */
1315 /* Its enclosing class is an explicit specialization
1316 of a template class. This is not a candidate. */
1321 /* The return types differ. */
1324 /* Adjust the type of DECL in case FN is a static member. */
1331 decl_arg_types))
1332 /* They match! */
1334 }
1335 }
1338 {
1339 /* We have:
1341 [temp.expl.spec]
1343 It is possible for a specialization with a given function
1344 signature to be instantiated from more than one function
1345 template. In such cases, explicit specification of the
1346 template arguments must be used to uniquely identify the
1347 function template specialization being specialized.
1349 Note that here, there's no suggestion that we're supposed to
1350 determine which of the candidate templates is most
1351 specialized. However, we, also have:
1353 [temp.func.order]
1355 Partial ordering of overloaded function template
1356 declarations is used in the following contexts to select
1357 the function template to which a function template
1358 specialization refers:
1360 -- when an explicit specialization refers to a function
1361 template.
1363 So, we do use the partial ordering rules, at least for now.
1364 This extension can only serve to make invalid programs valid,
1365 so it's safe. And, there is strong anecdotal evidence that
1366 the committee intended the partial ordering rules to apply;
1367 the EDG front-end has that behavior, and John Spicer claims
1368 that the committee simply forgot to delete the wording in
1369 [temp.expl.spec]. */
1372 {
1375 }
1376 }
1379 {
1383 }
1387 {
1393 }
1395 /* We have one, and exactly one, match. */
1397 {
1398 /* It was a specialization of an ordinary member function in a
1399 template class. */
1402 }
1404 /* It was a specialization of a template. */
1407 {
1412 }
1413 else
1416 }
1418 /* Returns a chain of parameter types, exactly like the SPEC_TYPES,
1419 but with the default argument values filled in from those in the
1420 TMPL_TYPES. */
1422 static tree
1424 tree tmpl_types)
1425 {
1426 tree new_spec_types;
1434 /* Substitute into the rest of the list. */
1435 new_spec_types =
1439 /* Add the default argument for this parameter. */
1442 new_spec_types);
1443 }
1445 /* DECL is an explicit specialization. Replicate default arguments
1446 from the template it specializes. (That way, code like:
1448 template <class T> void f(T = 3);
1449 template <> void f(double);
1450 void g () { f (); }
1452 works, as required.) An alternative approach would be to look up
1453 the correct default arguments at the call-site, but this approach
1454 is consistent with how implicit instantiations are handled. */
1456 static void
1458 {
1459 tree tmpl;
1460 tree spec_types;
1461 tree tmpl_types;
1462 tree new_spec_types;
1463 tree old_type;
1464 tree new_type;
1465 tree t;
1470 /* See if there's anything we need to do. */
1483 {
1484 /* Remove the this pointer, but remember the object's type for
1485 CV quals. */
1491 {
1492 /* DECL may contain more parameters than TMPL due to the extra
1493 in-charge parameter in constructors and destructors. */
1496 }
1498 {
1501 }
1502 }
1504 /* Compute the merged default arguments. */
1505 new_spec_types =
1508 /* Compute the new FUNCTION_TYPE. */
1510 {
1514 new_spec_types);
1517 /* Put the in-charge parameter back. */
1520 new_spec_types);
1524 new_spec_types);
1525 }
1526 else
1528 new_spec_types);
1534 }
1536 /* Check to see if the function just declared, as indicated in
1537 DECLARATOR, and in DECL, is a specialization of a function
1538 template. We may also discover that the declaration is an explicit
1539 instantiation at this point.
1541 Returns DECL, or an equivalent declaration that should be used
1542 instead if all goes well. Issues an error message if something is
1543 amiss. Returns error_mark_node if the error is not easily
1544 recoverable.
1546 FLAGS is a bitmask consisting of the following flags:
1548 2: The function has a definition.
1549 4: The function is a friend.
1551 The TEMPLATE_COUNT is the number of references to qualifying
1552 template classes that appeared in the name of the function. For
1553 example, in
1555 template <class T> struct S { void f(); };
1556 void S<int>::f();
1558 the TEMPLATE_COUNT would be 1. However, explicitly specialized
1559 classes are not counted in the TEMPLATE_COUNT, so that in
1561 template <class T> struct S {};
1562 template <> struct S<int> { void f(); }
1563 template <> void S<int>::f();
1565 the TEMPLATE_COUNT would be 0. (Note that this declaration is
1566 invalid; there should be no template <>.)
1568 If the function is a specialization, it is marked as such via
1569 DECL_TEMPLATE_SPECIALIZATION. Furthermore, its DECL_TEMPLATE_INFO
1570 is set up correctly, and it is added to the list of specializations
1571 for that template. */
1573 tree
1575 tree decl,
1578 {
1586 tmpl_spec_kind tsk;
1591 {
1594 {
1597 }
1599 {
1601 /* This could be something like:
1603 template <class T> void f(T);
1604 class S { friend void f<>(int); } */
1606 else
1607 {
1608 /* This case handles bogus declarations like template <>
1609 template <class T> void f<int>(); */
1612 declarator);
1614 }
1615 }
1619 /* The error has already been reported in
1620 check_specialization_scope. */
1626 /* Fall through. */
1637 decl);
1640 /* Fall through. */
1645 else
1651 {
1653 decl);
1655 }
1660 {
1661 /* For backwards compatibility, we accept:
1663 template <class T> struct S { void f(); };
1664 void S<int>::f() {} // Missing template <>
1666 That used to be valid C++. */
1668 pedwarn
1672 }
1677 {
1678 /* This case handles bogus declarations like template <>
1679 template <class T> void f<int>(); */
1683 declarator);
1684 else
1686 declarator);
1688 }
1691 /* This is a specialization of a member template, without
1692 specialization the containing class. Something like:
1694 template <class T> struct S {
1695 template <class U> void f (U);
1696 };
1697 template <> template <class U> void S<int>::f(U) {}
1699 That's a specialization -- but of the entire template. */
1705 }
1708 {
1712 {
1713 pedwarn
1716 }
1719 }
1722 {
1726 /* Make sure that the declarator is a TEMPLATE_ID_EXPR. */
1728 {
1729 tree fns;
1734 else
1735 {
1736 /* If there is no class context, the explicit instantiation
1737 must be at namespace scope. */
1740 /* Find the namespace binding, using the declaration
1741 context. */
1743 }
1746 }
1752 {
1754 /* A specialization in class scope. This is invalid,
1755 but the error will already have been flagged by
1756 check_specialization_scope. */
1758 else
1759 {
1760 /* It's not valid to write an explicit instantiation in
1761 class scope, e.g.:
1763 class C { template void f(); }
1765 This case is caught by the parser. However, on
1766 something like:
1768 template class C { void f(); };
1770 (which is invalid) we can get here. The error will be
1771 issued later. */
1772 ;
1773 }
1776 }
1779 IDENTIFIER_NODE))
1780 {
1781 /* Find the list of functions in ctype that have the same
1782 name as the declared function. */
1788 {
1793 {
1794 /* From [temp.expl.spec]:
1796 If such an explicit specialization for the member
1797 of a class template names an implicitly-declared
1798 special member function (clause _special_), the
1799 program is ill-formed.
1801 Similar language is found in [temp.explicit]. */
1804 }
1807 }
1810 {
1814 }
1815 else
1816 {
1817 tree methods;
1819 /* For a type-conversion operator, we cannot do a
1820 name-based lookup. We might be looking for `operator
1821 int' which will be a specialization of `operator T'.
1822 So, we find *all* the conversion operators, and then
1823 select from them. */
1830 {
1834 /* There are no more conversion functions. */
1837 /* Glue all these conversion functions together
1838 with those we already have. */
1841 }
1842 }
1845 {
1849 }
1850 else
1852 }
1854 /* Figure out what exactly is being specialized at this point.
1855 Note that for an explicit instantiation, even one for a
1856 member function, we cannot tell apriori whether the
1857 instantiation is for a member template, or just a member
1858 function of a template class. Even if a member template is
1859 being instantiated, the member template arguments may be
1860 elided if they can be deduced from the rest of the
1861 declaration. */
1864 member_specialization);
1867 /* We couldn't figure out what this declaration was
1868 specializing. */
1870 else
1871 {
1875 {
1876 /* We don't set DECL_EXPLICIT_INSTANTIATION here; that
1877 is done by do_decl_instantiation later. */
1883 {
1884 /* If TMPL is not the most general template (for
1885 example, if TMPL is a friend template that is
1886 injected into namespace scope), then there will
1887 be too many levels of TARGS. Remove some of them
1888 here. */
1890 tree new_targs;
1897 }
1900 }
1902 /* If we thought that the DECL was a member function, but it
1903 turns out to be specializing a static member function,
1904 make DECL a static member function as well. We also have
1905 to adjust last_function_parms to avoid confusing
1906 start_function later. */
1909 {
1912 }
1914 /* If this is a specialization of a member template of a
1915 template class. In we want to return the TEMPLATE_DECL,
1916 not the specialization of it. */
1918 {
1922 {
1926 }
1928 }
1930 /* Set up the DECL_TEMPLATE_INFO for DECL. */
1933 /* Inherit default function arguments from the template
1934 DECL is specializing. */
1937 /* This specialization has the same protection as the
1938 template it specializes. */
1943 /* This is not really a declaration of a specialization.
1944 It's just the name of an instantiation. But, it's not
1945 a request for an instantiation, either. */
1948 /* This is indeed a specialization. In case of constructors
1949 and destructors, we need in-charge and not-in-charge
1950 versions in V3 ABI. */
1953 /* Register this specialization so that we can find it
1954 again. */
1956 }
1957 }
1960 }
1962 /* TYPE is being declared. Verify that the use of template headers
1963 and such is reasonable. Issue error messages if not. */
1965 void
1967 {
1969 {
1970 /* We are in the scope of some `template <...>' header. */
1972 int context_depth
1977 /* This is OK; the template headers are for the context. We
1978 are actually too lenient here; like
1979 check_explicit_specialization we should consider the number
1980 of template types included in the actual declaration. For
1981 example,
1983 template <class T> struct S {
1984 template <class U> template <class V>
1985 struct I {};
1986 };
1988 is invalid, but:
1990 template <class T> struct S {
1991 template <class U> struct I;
1992 };
1994 template <class T> template <class U.
1995 struct S<T>::I {};
1997 is not. */
1998 ;
2000 /* There are two many template parameter lists. */
2002 }
2003 }
2005 /* Returns 1 iff PARMS1 and PARMS2 are identical sets of template
2006 parameters. These are represented in the same format used for
2007 DECL_TEMPLATE_PARMS. */
2010 {
2011 tree p1;
2012 tree p2;
2020 {
2032 {
2043 }
2044 }
2047 /* One set of parameters has more parameters lists than the
2048 other. */
2052 }
2054 /* Complain if DECL shadows a template parameter.
2056 [temp.local]: A template-parameter shall not be redeclared within its
2057 scope (including nested scopes). */
2059 void
2061 {
2062 tree olddecl;
2064 /* If we're not in a template, we can't possibly shadow a template
2065 parameter. */
2069 /* Figure out what we're shadowing. */
2074 /* If there's no previous binding for this name, we're not shadowing
2075 anything, let alone a template parameter. */
2079 /* If we're not shadowing a template parameter, we're done. Note
2080 that OLDDECL might be an OVERLOAD (or perhaps even an
2081 ERROR_MARK), so we can't just blithely assume it to be a _DECL
2082 node. */
2086 /* We check for decl != olddecl to avoid bogus errors for using a
2087 name inside a class. We check TPFI to avoid duplicate errors for
2088 inline member templates. */
2095 }
2097 /* Return a new TEMPLATE_PARM_INDEX with the indicated INDEX, LEVEL,
2098 ORIG_LEVEL, DECL, and TYPE. */
2100 static tree
2104 tree decl,
2105 tree type)
2106 {
2117 }
2119 /* Return a TEMPLATE_PARM_INDEX, similar to INDEX, but whose
2120 TEMPLATE_PARM_LEVEL has been decreased by LEVELS. If such a
2121 TEMPLATE_PARM_INDEX already exists, it is returned; otherwise, a
2122 new one is created. */
2124 static tree
2126 {
2130 {
2146 /* Template template parameters need this. */
2149 }
2152 }
2154 /* Process information from new template parameter NEXT and append it to the
2155 LIST being built. */
2157 tree
2159 {
2160 tree parm;
2162 tree defval;
2172 {
2177 else
2180 }
2181 else
2185 {
2187 /* is a const-param */
2192 /* [temp.param]
2194 The top-level cv-qualifiers on the template-parameter are
2195 ignored when determining its type. */
2198 /* A template parameter is not modifiable. */
2206 processing_template_decl,
2208 }
2209 else
2210 {
2211 tree t;
2215 {
2217 /* This is for distinguishing between real templates and template
2218 template parameters */
2222 }
2223 else
2224 {
2226 /* parm is either IDENTIFIER_NODE or NULL_TREE */
2228 }
2235 processing_template_decl,
2237 }
2243 }
2245 /* The end of a template parameter list has been reached. Process the
2246 tree list into a parameter vector, converting each parameter into a more
2247 useful form. Type parameters are saved as IDENTIFIER_NODEs, and others
2248 as PARM_DECLs. */
2250 tree
2252 {
2257 current_template_parms
2262 {
2266 }
2271 }
2273 /* end_template_decl is called after a template declaration is seen. */
2275 void
2277 {
2283 /* This matches the pushlevel in begin_template_parm_list. */
2288 }
2290 /* Given a template argument vector containing the template PARMS.
2291 The innermost PARMS are given first. */
2293 tree
2295 {
2296 tree header;
2301 /* If there is only one level of template parameters, we do not
2302 create a TREE_VEC of TREE_VECs. Instead, we return a single
2303 TREE_VEC containing the arguments. */
2308 {
2314 {
2317 /* T will be a list if we are called from within a
2318 begin/end_template_parm_list pair, but a vector directly
2319 if within a begin/end_member_template_processing pair. */
2321 {
2327 else
2330 }
2331 }
2335 else
2337 }
2340 }
2342 /* Return a TEMPLATE_DECL corresponding to DECL, using the indicated
2343 template PARMS. Used by push_template_decl below. */
2345 static tree
2347 {
2352 {
2361 }
2364 }
2366 struct template_parm_data
2367 {
2368 /* The level of the template parameters we are currently
2369 processing. */
2372 /* The index of the specialization argument we are currently
2373 processing. */
2376 /* An array whose size is the number of template parameters. The
2377 elements are nonzero if the parameter has been used in any one
2378 of the arguments processed so far. */
2381 /* An array whose size is the number of template arguments. The
2382 elements are nonzero if the argument makes use of template
2383 parameters of this level. */
2385 };
2387 /* Subroutine of push_template_decl used to see if each template
2388 parameter in a partial specialization is used in the explicit
2389 argument list. If T is of the LEVEL given in DATA (which is
2390 treated as a template_parm_data*), then DATA->PARMS is marked
2391 appropriately. */
2393 static int
2395 {
2401 {
2404 }
2405 else
2406 {
2409 }
2412 {
2415 }
2417 /* Return zero so that for_each_template_parm will continue the
2418 traversal of the tree; we want to mark *every* template parm. */
2420 }
2422 /* Process the partial specialization DECL. */
2424 static tree
2426 {
2440 /* We check that each of the template parameters given in the
2441 partial specialization is used in the argument list to the
2442 specialization. For example:
2444 template <class T> struct S;
2445 template <class T> struct S<T*>;
2447 The second declaration is OK because `T*' uses the template
2448 parameter T, whereas
2450 template <class T> struct S<int>;
2452 is no good. Even trickier is:
2454 template <class T>
2455 struct S1
2456 {
2457 template <class U>
2458 struct S2;
2459 template <class U>
2460 struct S2<T>;
2461 };
2463 The S2<T> declaration is actually invalid; it is a
2464 full-specialization. Of course,
2466 template <class U>
2467 struct S2<T (*)(U)>;
2469 or some such would have been OK. */
2477 {
2482 NULL);
2483 }
2486 {
2487 /* One of the template parms was not used in the
2488 specialization. */
2490 {
2493 }
2497 }
2499 /* [temp.class.spec]
2501 The argument list of the specialization shall not be identical to
2502 the implicit argument list of the primary template. */
2509 /* [temp.class.spec]
2511 A partially specialized non-type argument expression shall not
2512 involve template parameters of the partial specialization except
2513 when the argument expression is a simple identifier.
2515 The type of a template parameter corresponding to a specialized
2516 non-type argument shall not be dependent on a parameter of the
2517 specialization. */
2521 {
2526 /* This next line is the `argument expression is not just a
2527 simple identifier' condition and also the `specialized
2528 non-type argument' bit. */
2530 {
2533 else
2534 {
2535 /* Look at the corresponding template parameter,
2536 marking which template parameters its type depends
2537 upon. */
2538 tree type =
2540 i)));
2543 {
2544 /* We haven't yet initialized TPD2. Do so now. */
2545 tpd2.arg_uses_template_parms
2547 /* The number of parameters here is the number in the
2548 main template, which, as checked in the assertion
2549 above, is NARGS. */
2553 }
2555 /* Mark the template parameters. But this time, we're
2556 looking for the template parameters of the main
2557 template, not in the specialization. */
2564 NULL);
2567 {
2568 /* The type depended on some template parameters.
2569 If they are fully specialized in the
2570 specialization, that's OK. */
2575 {
2577 type,
2578 arg);
2580 }
2581 }
2582 }
2583 }
2584 }
2587 /* We've already got this specialization. */
2595 }
2597 /* Check that a template declaration's use of default arguments is not
2598 invalid. Here, PARMS are the template parameters. IS_PRIMARY is
2599 nonzero if DECL is the thing declared by a primary template.
2600 IS_PARTIAL is nonzero if DECL is a partial specialization. */
2602 static void
2604 {
2607 tree parm_level;
2609 /* [temp.param]
2611 A default template-argument shall not be specified in a
2612 function template declaration or a function template definition, nor
2613 in the template-parameter-list of the definition of a member of a
2614 class template. */
2617 /* You can't have a function template declaration in a local
2618 scope, nor you can you define a member of a class template in a
2619 local scope. */
2625 /* If this is either a friend defined in the scope of the class
2626 or a member function. */
2632 /* And, if it was a member function, it really was defined in
2633 the scope of the class. */
2636 /* We already checked these parameters when the template was
2637 declared, so there's no need to do it again now. This function
2638 was defined in class scope, but we're processing it's body now
2639 that the class is complete. */
2642 /* [temp.param]
2644 If a template-parameter has a default template-argument, all
2645 subsequent template-parameters shall have a default
2646 template-argument supplied. */
2648 {
2655 {
2660 {
2662 /* For better subsequent error-recovery, we indicate that
2663 there should have been a default argument. */
2665 }
2666 }
2667 }
2670 /* For an ordinary class template, default template arguments are
2671 allowed at the innermost level, e.g.:
2672 template <class T = int>
2673 struct S {};
2674 but, in a partial specialization, they're not allowed even
2675 there, as we have in [temp.class.spec]:
2677 The template parameter list of a specialization shall not
2678 contain default template argument values.
2680 So, for a partial specialization, or for a function template,
2681 we look at all of them. */
2682 ;
2683 else
2684 /* But, for a primary class template that is not a partial
2685 specialization we look at all template parameters except the
2686 innermost ones. */
2689 /* Figure out what error message to issue. */
2694 else
2698 /* If we're inside a class definition, there's no need to
2699 examine the parameters to the class itself. On the one
2700 hand, they will be checked when the class is defined, and,
2701 on the other, default arguments are valid in things like:
2702 template <class T = double>
2703 struct S { template <class U> void f(U); };
2704 Here the default argument for `S' has no bearing on the
2705 declaration of `f'. */
2707 else
2708 /* Check everything. */
2714 {
2722 {
2724 {
2727 }
2729 /* Clear out the default argument so that we are not
2730 confused later. */
2732 }
2734 /* At this point, if we're still interested in issuing messages,
2735 they must apply to classes surrounding the object declared. */
2738 }
2739 }
2741 /* Worker for push_template_decl_real, called via
2742 for_each_template_parm. DATA is really an int, indicating the
2743 level of the parameters we are interested in. If T is a template
2744 parameter of that level, return nonzero. */
2746 static int
2748 {
2754 else
2757 }
2759 /* Creates a TEMPLATE_DECL for the indicated DECL using the template
2760 parameters given by current_template_args, or reuses a
2761 previously existing one, if appropriate. Returns the DECL, or an
2762 equivalent one, if it is replaced via a call to duplicate_decls.
2764 If IS_FRIEND is nonzero, DECL is a friend declaration. */
2766 tree
2768 {
2769 tree tmpl;
2770 tree args;
2771 tree info;
2772 tree ctx;
2777 /* See if this is a partial specialization. */
2785 /* For a friend, we want the context of the friend function, not
2786 the type of which it is a friend. */
2790 /* In the case of a virtual function, we want the class in which
2791 it is defined. */
2793 else
2794 /* Otherwise, if we're currently defining some class, the DECL
2795 is assumed to be a member of the class. */
2804 /* See if this is a primary template. */
2808 {
2816 {
2817 /* [temp.mem]
2819 A destructor shall not be a member template. */
2822 }
2828 else
2829 {
2832 }
2833 }
2835 /* Check to see that the rules regarding the use of default
2836 arguments are not being violated. */
2849 {
2854 /* If DECL is a TYPE_DECL for a class-template, then there won't
2855 be DECL_LANG_SPECIFIC. The information equivalent to
2856 DECL_TEMPLATE_INFO is found in TYPE_TEMPLATE_INFO instead. */
2860 {
2861 /* Since a template declaration already existed for this
2862 class-type, we must be redeclaring it here. Make sure
2863 that the redeclaration is valid. */
2865 current_template_parms);
2866 /* We don't need to create a new TEMPLATE_DECL; just use the
2867 one we already had. */
2869 }
2870 else
2871 {
2877 {
2878 /* A specialization of a member template of a template
2879 class. */
2883 }
2884 }
2885 }
2886 else
2887 {
2892 {
2898 else
2899 {
2902 }
2903 }
2905 {
2908 }
2909 else
2916 {
2917 tree new_tmpl;
2919 /* The declaration is a specialization of a member
2920 template, declared outside the class. Therefore, the
2921 innermost template arguments will be NULL, so we
2922 replace them with the arguments determined by the
2923 earlier call to check_explicit_specialization. */
2926 new_tmpl
2937 args);
2939 }
2941 /* Make sure the template headers we got make sense. */
2946 {
2949 }
2950 else
2952 {
2957 {
2961 else
2965 }
2967 /* Perhaps we should also check that the parms are used in the
2968 appropriate qualifying scopes in the declarator? */
2972 else
2974 }
2975 }
2980 /* Push template declarations for global functions and types. Note
2981 that we do not try to push a global template friend declared in a
2982 template class; such a thing may well depend on the template
2983 parameters of the class. */
2989 {
2992 {
2995 /* It is a conversion operator. See if the type converted to
2996 depends on innermost template operands. */
2999 depth))
3001 }
3002 }
3007 {
3011 /* Don't change the name if we've already set it up. */
3014 }
3019 }
3021 tree
3023 {
3025 }
3027 /* Called when a class template TYPE is redeclared with the indicated
3028 template PARMS, e.g.:
3030 template <class T> struct S;
3031 template <class T> struct S {}; */
3033 void
3035 {
3036 tree tmpl;
3037 tree tmpl_parms;
3041 {
3044 }
3048 /* The type is nested in some template class. Nothing to worry
3049 about here; there are no new template parameters for the nested
3050 type. */
3057 {
3064 }
3067 {
3074 {
3078 }
3081 {
3082 /* We have in [temp.param]:
3084 A template-parameter may not be given default arguments
3085 by two different declarations in the same scope. */
3089 }
3092 /* Update the previous template parameters (which are the ones
3093 that will really count) with the new default value. */
3096 /* Update the new parameters, too; they'll be used as the
3097 parameters for any members. */
3099 }
3100 }
3102 /* Attempt to convert the non-type template parameter EXPR to the
3103 indicated TYPE. If the conversion is successful, return the
3104 converted value. If the conversion is unsuccessful, return
3105 NULL_TREE if we issued an error message, or error_mark_node if we
3106 did not. We issue error messages for out-and-out bad template
3107 parameters, but not simply because the conversion failed, since we
3108 might be just trying to do argument deduction. By the time this
3109 function is called, neither TYPE nor EXPR may make use of template
3110 parameters. */
3112 static tree
3114 {
3117 /* A template-argument for a non-type, non-template
3118 template-parameter shall be one of:
3120 --an integral constant-expression of integral or enumeration
3121 type; or
3123 --the name of a non-type template-parameter; or
3125 --the name of an object or function with external linkage,
3126 including function templates and function template-ids but
3127 excluding non-static class members, expressed as id-expression;
3128 or
3130 --the address of an object or function with external linkage,
3131 including function templates and function template-ids but
3132 excluding non-static class members, expressed as & id-expression
3133 where the & is optional if the name refers to a function or
3134 array; or
3136 --a pointer to member expressed as described in _expr.unary.op_. */
3138 /* An integral constant-expression can include const variables or
3139 enumerators. Simplify things by folding them to their values,
3140 unless we're about to bind the declaration to a reference
3141 parameter. */
3147 /* OK for now. We'll check that it has external linkage later.
3148 Check this first since if expr_type is the unknown_type_node
3149 we would otherwise complain below. */
3150 ;
3152 {
3155 }
3159 /* If expr is the address of an overloaded function, we
3160 will get the unknown_type_node at this point. */
3162 {
3163 tree referent;
3171 else
3172 {
3174 {
3175 bad_argument:
3178 {
3181 else
3183 }
3188 }
3192 }
3195 {
3196 error ("string literal %E is not a valid template argument because it is the address of an object with static linkage",
3197 referent);
3199 }
3205 /* We'll check that it has external linkage later. */
3206 ;
3210 {
3213 }
3214 }
3216 {
3218 {
3219 non_constant:
3221 expr);
3223 }
3224 }
3225 else
3226 {
3232 else
3236 }
3239 {
3243 /* For a non-type template-parameter of integral or enumeration
3244 type, integral promotions (_conv.prom_) and integral
3245 conversions (_conv.integral_) are applied. */
3249 /* It's safe to call digest_init in this case; we know we're
3250 just converting one integral constant expression to another. */
3254 /* Curiously, some TREE_CONSTANT integral expressions do not
3255 simplify to integer constants. For example, `3 % 0',
3256 remains a TRUNC_MOD_EXPR. */
3262 {
3263 tree e;
3265 /* For a non-type template-parameter of type pointer to data
3266 member, qualification conversions (_conv.qual_) are
3267 applied. */
3270 /* The call to perform_qualification_conversions will
3271 insert a NOP_EXPR over EXPR to do express conversion,
3272 if necessary. But, that will confuse us if we use
3273 this (converted) template parameter to instantiate
3274 another template; then the thing will not look like a
3275 valid template argument. So, just make a new
3276 constant, of the appropriate type. */
3279 }
3282 {
3286 {
3287 /* For a non-type template-parameter of type pointer to
3288 function, only the function-to-pointer conversion
3289 (_conv.func_) is applied. If the template-argument
3290 represents a set of overloaded functions (or a pointer to
3291 such), the matching function is selected from the set
3292 (_over.over_). */
3293 tree fns;
3294 tree fn;
3298 else
3307 {
3310 else
3312 }
3319 }
3320 else
3321 {
3322 /* For a non-type template-parameter of type pointer to
3323 object, qualification conversions (_conv.qual_) and the
3324 array-to-pointer conversion (_conv.array_) are applied.
3325 [Note: In particular, neither the null pointer conversion
3326 (_conv.ptr_) nor the derived-to-base conversion
3327 (_conv.ptr_) are applied. Although 0 is a valid
3328 template-argument for a non-type template-parameter of
3329 integral type, it is not a valid template-argument for a
3330 non-type template-parameter of pointer type.]
3332 The call to decay_conversion performs the
3333 array-to-pointer conversion, if appropriate. */
3338 else
3340 }
3341 }
3345 {
3348 /* If this expression already has reference type, get the
3349 underlying object. */
3351 {
3358 }
3361 {
3362 /* For a non-type template-parameter of type reference to
3363 function, no conversions apply. If the
3364 template-argument represents a set of overloaded
3365 functions, the matching function is selected from the
3366 set (_over.over_). */
3367 tree fn;
3375 {
3377 /* Don't issue an error here; we might get a different
3378 function if the overloading had worked out
3379 differently. */
3381 else
3383 }
3390 }
3391 else
3392 {
3393 /* For a non-type template-parameter of type reference to
3394 object, no conversions apply. The type referred to by the
3395 reference may be more cv-qualified than the (otherwise
3396 identical) type of the template-argument. The
3397 template-parameter is bound directly to the
3398 template-argument, which must be an lvalue. */
3402 expr_type)
3405 }
3409 }
3413 {
3416 /* For a non-type template-parameter of type pointer to member
3417 function, no conversions apply. If the template-argument
3418 represents a set of overloaded member functions, the
3419 matching member function is selected from the set
3420 (_over.over_). */
3427 {
3428 /* A ptr-to-member constant. */
3431 else
3433 }
3447 }
3451 /* All non-type parameters must have one of these types. */
3454 }
3457 }
3459 /* Return 1 if PARM_PARMS and ARG_PARMS matches using rule for
3460 template template parameters. Both PARM_PARMS and ARG_PARMS are
3461 vectors of TREE_LIST nodes containing TYPE_DECL, TEMPLATE_DECL
3462 or PARM_DECL.
3464 ARG_PARMS may contain more parameters than PARM_PARMS. If this is
3465 the case, then extra parameters must have default arguments.
3467 Consider the example:
3468 template <class T, class Allocator = allocator> class vector;
3469 template<template <class U> class TT> class C;
3471 C<vector> is a valid instantiation. PARM_PARMS for the above code
3472 contains a TYPE_DECL (for U), ARG_PARMS contains two TYPE_DECLs (for
3473 T and Allocator) and OUTER_ARGS contains the argument that is used to
3474 substitute the TT parameter. */
3476 static int
3478 tree arg_parms,
3479 tsubst_flags_t complain,
3480 tree in_decl,
3481 tree outer_args)
3482 {
3492 /* The rule here is opposite of coerce_template_parms. */
3499 {
3511 {
3516 /* We encounter instantiations of templates like
3517 template <template <template <class> class> class TT>
3518 class C; */
3519 {
3526 }
3530 /* The tsubst call is used to handle cases such as
3531 template <class T, template <T> class TT> class D;
3532 i.e. the parameter list of TT depends on earlier parameters. */
3541 }
3542 }
3544 }
3546 /* Convert the indicated template ARG as necessary to match the
3547 indicated template PARM. Returns the converted ARG, or
3548 error_mark_node if the conversion was unsuccessful. Error and
3549 warning messages are issued under control of COMPLAIN. This
3550 conversion is for the Ith parameter in the parameter list. ARGS is
3551 the full set of template arguments deduced so far. */
3553 static tree
3555 tree arg,
3556 tree args,
3557 tsubst_flags_t complain,
3559 tree in_decl)
3560 {
3561 tree val;
3562 tree inner_args;
3569 {
3570 /* The template argument was the name of some
3571 member function. That's usually
3572 invalid, but static members are OK. In any
3573 case, grab the underlying fields/functions
3574 and issue an error later if required. */
3577 }
3597 {
3604 }
3606 {
3608 {
3610 {
3619 else
3621 }
3622 }
3624 }
3626 {
3628 {
3633 else
3635 }
3637 }
3640 {
3642 {
3644 /* The number of argument required is not known yet.
3645 Just accept it for now. */
3647 else
3648 {
3654 inner_args))
3655 {
3658 /* TEMPLATE_TEMPLATE_PARM node is preferred over
3659 TEMPLATE_DECL. */
3663 }
3664 else
3665 {
3667 {
3671 }
3674 }
3675 }
3676 }
3677 else
3679 }
3680 else
3681 {
3688 /* We used to call digest_init here. However, digest_init
3689 will report errors, which we don't want when complain
3690 is zero. More importantly, digest_init will try too
3691 hard to convert things: for example, `0' should not be
3692 converted to pointer type at this point according to
3693 the standard. Accepting this is not merely an
3694 extension, since deciding whether or not these
3695 conversions can occur is part of determining which
3696 function template to call, or whether a given explicit
3697 argument specification is valid. */
3699 else
3707 }
3710 }
3712 /* Convert all template arguments to their appropriate types, and
3713 return a vector containing the innermost resulting template
3714 arguments. If any error occurs, return error_mark_node. Error and
3715 warning messages are issued under control of COMPLAIN.
3717 If REQUIRE_ALL_ARGUMENTS is nonzero, all arguments must be
3718 provided in ARGLIST, or else trailing parameters must have default
3719 values. If REQUIRE_ALL_ARGUMENTS is zero, we will attempt argument
3720 deduction for any unspecified trailing arguments. */
3722 static tree
3724 tree args,
3725 tree in_decl,
3726 tsubst_flags_t complain,
3728 {
3730 tree inner_args;
3731 tree new_args;
3732 tree new_inner_args;
3740 && require_all_arguments
3742 {
3744 {
3750 }
3753 }
3758 {
3759 tree arg;
3760 tree parm;
3762 /* Get the Ith template parameter. */
3765 /* Calculate the Ith argument. */
3769 /* There must be a default arg in this case. */
3772 else
3778 else
3781 in_decl);
3784 lost++;
3786 }
3792 }
3794 /* Returns 1 if template args OT and NT are equivalent. */
3796 static int
3798 {
3803 /* For member templates */
3809 else
3811 }
3813 /* Returns 1 iff the OLDARGS and NEWARGS are in fact identical sets
3814 of template arguments. Returns 0 otherwise. */
3816 int
3818 {
3825 {
3831 }
3833 }
3835 /* Given class template name and parameter list, produce a user-friendly name
3836 for the instantiation. */
3840 {
3847 else
3851 #define ccat(C) obstack_1grow (&scratch_obstack, (C));
3852 #define cat(S) obstack_grow (&scratch_obstack, (S), strlen (S))
3860 {
3868 {
3871 }
3873 {
3875 {
3876 /* Already substituted with real template. Just output
3877 the template name here */
3880 {
3881 /* The template may be defined in a namespace, or
3882 may be a member template. */
3888 }
3890 }
3891 else
3892 /* Output the parameter declaration */
3895 }
3896 else
3899 /* No need to check arglist against parmlist here; we did that
3900 in coerce_template_parms, called from lookup_template_class. */
3902 }
3903 {
3907 offset--;
3910 /* B<C<char> >, not B<C<char>> */
3913 }
3917 }
3919 static tree
3921 {
3923 /* Specializations have already had their names set up in
3924 lookup_template_class. */
3926 {
3929 /* For non-primary templates, the template parameters are
3930 implicit from their surrounding context. */
3932 {
3941 }
3942 }
3945 }
3947 static void
3949 {
3953 tree pt;
3959 /* We are called both from instantiate_decl, where we've already had a
3960 tinst_level pushed, and instantiate_template, where we haven't.
3961 Compensate. */
3970 else
3979 }
3982 /* Return a TEMPLATE_ID_EXPR corresponding to the indicated FNS and
3983 ARGLIST. Valid choices for FNS are given in the cp-tree.def
3984 documentation for TEMPLATE_ID_EXPR. */
3986 tree
3988 {
3989 tree type;
3997 {
4000 }
4009 {
4011 unknown_type_node,
4013 arglist);
4015 }
4022 }
4024 /* Within the scope of a template class S<T>, the name S gets bound
4025 (in build_self_reference) to a TYPE_DECL for the class, not a
4026 TEMPLATE_DECL. If DECL is a TYPE_DECL for current_class_type,
4027 or one of its enclosing classes, and that type is a template,
4028 return the associated TEMPLATE_DECL. Otherwise, the original
4029 DECL is returned. */
4031 tree
4033 {
4040 }
4042 /* Given an IDENTIFIER_NODE (type TEMPLATE_DECL) and a chain of
4043 parameters, find the desired type.
4045 D1 is the PTYPENAME terminal, and ARGLIST is the list of arguments.
4047 IN_DECL, if non-NULL, is the template declaration we are trying to
4048 instantiate.
4050 If ENTERING_SCOPE is nonzero, we are about to enter the scope of
4051 the class we are looking up.
4053 Issue error and warning messages under control of COMPLAIN.
4055 If the template class is really a local class in a template
4056 function, then the FUNCTION_CONTEXT is the function in which it is
4057 being instantiated. */
4059 tree
4061 tree arglist,
4062 tree in_decl,
4063 tree context,
4065 tsubst_flags_t complain)
4066 {
4068 tree t;
4073 {
4077 else
4078 {
4085 }
4088 }
4090 {
4093 /* If we are declaring a constructor, say A<T>::A<T>, we will get
4094 an implicit typename for the second A. Deal with it. */
4099 {
4102 }
4103 }
4106 {
4109 }
4112 {
4116 }
4118 /* With something like `template <class T> class X class X { ... };'
4119 we could end up with D1 having nothing but an IDENTIFIER_VALUE.
4120 We don't want to do that, but we have to deal with the situation,
4121 so let's give them some syntax errors to chew on instead of a
4122 crash. Alternatively D1 might not be a template type at all. */
4124 {
4128 }
4131 /* Make sure it's a user visible template, if it was named by
4132 the user. */
4135 {
4137 {
4141 }
4143 }
4148 {
4149 /* Create a new TEMPLATE_DECL and TEMPLATE_TEMPLATE_PARM node to store
4150 template arguments */
4152 tree parm;
4153 tree arglist2;
4157 /* Consider an example where a template template parameter declared as
4159 template <class T, class U = std::allocator<T> > class TT
4161 The template parameter level of T and U are one level larger than
4162 of TT. To proper process the default argument of U, say when an
4163 instantiation `TT<int>' is seen, we need to build the full
4164 arguments containing {int} as the innermost level. Outer levels,
4165 available when not appearing as default template argument, can be
4166 obtained from `current_template_args ()'.
4168 Suppose that TT is later substituted with std::vector. The above
4169 instantiation is `TT<int, std::allocator<T> >' with TT at
4170 level 1, and T at level 2, while the template arguments at level 1
4171 becomes {std::vector} and the inner level 2 is {int}. */
4185 }
4186 else
4187 {
4189 tree gen_tmpl;
4190 tree type_decl;
4203 {
4204 /* We've been given an incomplete set of template arguments.
4205 For example, given:
4207 template <class T> struct S1 {
4208 template <class U> struct S2 {};
4209 template <class U> struct S2<U*> {};
4210 };
4212 we will be called with an ARGLIST of `U*', but the
4213 TEMPLATE will be `template <class T> template
4214 <class U> struct S1<T>::S2'. We must fill in the missing
4215 arguments. */
4216 arglist
4218 arglist);
4220 }
4222 /* Now we should have enough arguments. */
4225 /* From here on, we're only interested in the most general
4226 template. */
4229 /* Calculate the BOUND_ARGS. These will be the args that are
4230 actually tsubst'd into the definition to create the
4231 instantiation. */
4233 {
4234 /* We have multiple levels of arguments to coerce, at once. */
4244 {
4249 /* Don't process further if one of the levels fails. */
4251 {
4252 /* Restore the ARGLIST to its full size. */
4255 }
4259 /* We temporarily reduce the length of the ARGLIST so
4260 that coerce_template_parms will see only the arguments
4261 corresponding to the template parameters it is
4262 examining. */
4264 }
4266 /* Restore the ARGLIST to its full size. */
4270 }
4271 else
4272 arglist
4282 complain)))
4283 /* We were unable to bind the arguments. */
4286 /* In the scope of a template class, explicit references to the
4287 template class refer to the type of the template, not any
4288 instantiation of it. For example, in:
4290 template <class T> class C { void f(C<T>); }
4292 the `C<T>' is just the same as `C'. Outside of the
4293 class, however, such a reference is an instantiation. */
4295 arglist))
4296 {
4300 {
4301 tree ctx;
4311 /* We're not in the scope of the class, so the
4312 TEMPLATE_TYPE is not the type we want after all. */
4314 found_ctx:;
4315 }
4316 }
4324 {
4327 /* Use the move-to-front heuristic to speed up future
4328 searches. */
4335 }
4337 /* This type is a "partial instantiation" if any of the template
4338 arguments still involve template parameters. Note that we set
4339 IS_PARTIAL_INSTANTIATION for partial specializations as
4340 well. */
4346 {
4351 }
4358 /* Create the type. */
4360 {
4362 {
4365 }
4366 else
4367 /* We don't want to call start_enum for this type, since
4368 the values for the enumeration constants may involve
4369 template parameters. And, no one should be interested
4370 in the enumeration constants for such a type. */
4372 }
4373 else
4374 {
4381 /* A local class. Make sure the decl gets registered properly. */
4384 }
4386 /* If we called start_enum or pushtag above, this information
4387 will already be set up. */
4389 {
4397 }
4398 else
4406 /* Set up the template information. We have to figure out which
4407 template is the immediate parent if this is a full
4408 instantiation. */
4411 /* This case is easy; there are no member templates involved. */
4413 else
4414 {
4415 /* This is a full instantiation of a member template. Look
4416 for a partial instantiation of which this is an instance. */
4420 {
4424 /* We only want partial instantiations, here, not
4425 specializations or full instantiations. */
4430 /* Temporarily reduce by one the number of levels in the
4431 ARGLIST and in FOUND so as to avoid comparing the
4432 last set of arguments. */
4436 /* See if the arguments match. If they do, then TMPL is
4437 the partial instantiation we want. */
4440 /* Restore the argument vectors to their full size. */
4445 {
4448 }
4449 }
4452 {
4453 /* There was no partial instantiation. This happens
4454 where C<T> is a member template of A<T> and it's used
4455 in something like
4457 template <typename T> struct B { A<T>::C<int> m; };
4458 B<float>;
4460 Create the partial instantiation.
4461 */
4465 }
4466 }
4475 /* Now that the type has been registered on the instantiations
4476 list, we set up the enumerators. Because the enumeration
4477 constants may involve the enumeration type itself, we make
4478 sure to register the type first, and then create the
4479 constants. That way, doing tsubst_expr for the enumeration
4480 constants won't result in recursive calls here; we'll find
4481 the instantiation and exit above. */
4484 /* Reset the name of the type, now that CLASSTYPE_TEMPLATE_INFO
4485 is set up. */
4489 {
4490 /* For backwards compatibility; code that uses
4491 -fexternal-templates expects looking up a template to
4492 instantiate it. I think DDD still relies on this.
4493 (jason 8/20/1998) */
4495 && flag_external_templates
4499 }
4500 else
4501 /* If the type makes use of template parameters, the
4502 code that generates debugging information will crash. */
4506 }
4508 }
4509 \f
4510 struct pair_fn_data
4511 {
4512 tree_fn_t fn;
4514 htab_t visited;
4515 };
4517 /* Called from for_each_template_parm via walk_tree. */
4519 static tree
4521 {
4528 /* If we have already visited this tree, there's no need to walk
4529 subtrees. Otherwise, add it to the visited table. */
4532 {
4535 }
4543 {
4547 /* Fall through. */
4559 /* Since we're not going to walk subtrees, we have to do this
4560 explicitly here. */
4564 /* Fall through. */
4567 /* Check the return type. */
4571 /* Check the parameter types. Since default arguments are not
4572 instantiated until they are needed, the TYPE_ARG_TYPES may
4573 contain expressions that involve template parameters. But,
4574 no-one should be looking at them yet. And, once they're
4575 instantiated, they don't contain template parameters, so
4576 there's no point in looking at them then, either. */
4577 {
4578 tree parm;
4585 /* Since we've already handled the TYPE_ARG_TYPES, we don't
4586 want walk_tree walking into them itself. */
4588 }
4603 /* Fall through. */
4618 /* Record template parameters such as `T' inside `TT<T>'. */
4621 /* Fall through. */
4633 /* A template template parameter is encountered */
4638 /* Already substituted template template parameter */
4659 /* If there's no type, then this thing must be some expression
4660 involving template parameters. */
4680 /* If we do not handle this case specially, we end up walking
4681 the BINFO hierarchy, which is circular, and therefore
4682 confuses walk_tree. */
4691 }
4693 /* We didn't find any template parameters we liked. */
4695 }
4697 /* For each TEMPLATE_TYPE_PARM, TEMPLATE_TEMPLATE_PARM,
4698 BOUND_TEMPLATE_TEMPLATE_PARM or TEMPLATE_PARM_INDEX in T,
4699 call FN with the parameter and the DATA.
4700 If FN returns nonzero, the iteration is terminated, and
4701 for_each_template_parm returns 1. Otherwise, the iteration
4702 continues. If FN never returns a nonzero value, the value
4703 returned by for_each_template_parm is 0. If FN is NULL, it is
4704 considered to be the function which always returns 1. */
4706 static int
4708 {
4712 /* Set up. */
4716 /* Walk the tree. (Conceptually, we would like to walk without
4717 duplicates, but for_each_template_parm_r recursively calls
4718 for_each_template_parm, so we would need to reorganize a fair
4719 bit to use walk_tree_without_duplicates, so we keep our own
4720 visited list.) */
4723 else
4725 NULL);
4727 for_each_template_parm_r,
4731 /* Clean up. */
4736 }
4738 /* Returns true if T depends on any template parameter. */
4740 int
4742 {
4744 }
4746 /* Returns true if T depends on any template parameter with level LEVEL. */
4748 int
4750 {
4752 }
4756 #ifdef GATHER_STATISTICS
4758 #endif
4762 /* We're starting to instantiate D; record the template instantiation context
4763 for diagnostics and to restore it later. */
4765 int
4767 {
4771 {
4772 /* If the instantiation in question still has unbound template parms,
4773 we don't really care if we can't instantiate it, so just return.
4774 This happens with base instantiation for implicit `typename'. */
4779 error ("template instantiation depth exceeds maximum of %d (use -ftemplate-depth-NN to increase the maximum) instantiating `%D'",
4785 }
4792 #ifdef GATHER_STATISTICS
4795 #endif
4799 }
4801 /* We're done instantiating this template; return to the instantiation
4802 context. */
4804 void
4806 {
4809 /* Restore the filename and line number stashed away when we started
4810 this instantiation. */
4818 }
4820 /* We're instantiating a deferred template; restore the template
4821 instantiation context in which the instantiation was requested, which
4822 is one step out from LEVEL. */
4824 static void
4826 {
4827 tree t;
4835 }
4837 /* Return the outermost template instantiation context, for use with
4838 -falt-external-templates. */
4840 tree
4842 {
4847 ;
4849 }
4851 /* DECL is a friend FUNCTION_DECL or TEMPLATE_DECL. ARGS is the
4852 vector of template arguments, as for tsubst.
4854 Returns an appropriate tsubst'd friend declaration. */
4856 static tree
4858 {
4859 tree new_friend;
4867 /* This was a friend declared with an explicit template
4868 argument list, e.g.:
4870 friend void f<>(T);
4872 to indicate that f was a template instantiation, not a new
4873 function declaration. Now, we have to figure out what
4874 instantiation of what template. */
4875 {
4877 tree new_args;
4878 tree tmpl;
4881 /* Friend functions are looked up in the containing namespace scope.
4882 We must enter that scope, to avoid finding member functions of the
4883 current cless with same name. */
4898 }
4902 /* The NEW_FRIEND will look like an instantiation, to the
4903 compiler, but is not an instantiation from the point of view of
4904 the language. For example, we might have had:
4906 template <class T> struct S {
4907 template <class U> friend void f(T, U);
4908 };
4910 Then, in S<int>, template <class U> void f(int, U) is not an
4911 instantiation of anything. */
4914 {
4918 }
4920 /* The mangled name for the NEW_FRIEND is incorrect. The function
4921 is not a template instantiation and should not be mangled like
4922 one. Therefore, we forget the mangling here; we'll recompute it
4923 later if we need it. */
4925 {
4928 }
4931 {
4932 tree old_decl;
4933 tree new_friend_template_info;
4934 tree new_friend_result_template_info;
4935 tree ns;
4938 /* We must save some information from NEW_FRIEND before calling
4939 duplicate decls since that function will free NEW_FRIEND if
4940 possible. */
4943 {
4944 /* This declaration is a `primary' template. */
4947 new_friend_is_defn
4949 new_friend_result_template_info
4951 }
4952 else
4953 {
4956 }
4958 /* Inside pushdecl_namespace_level, we will push into the
4959 current namespace. However, the friend function should go
4960 into the namespace of the template. */
4967 {
4968 /* This new friend declaration matched an existing
4969 declaration. For example, given:
4971 template <class T> void f(T);
4972 template <class U> class C {
4973 template <class T> friend void f(T) {}
4974 };
4976 the friend declaration actually provides the definition
4977 of `f', once C has been instantiated for some type. So,
4978 old_decl will be the out-of-class template declaration,
4979 while new_friend is the in-class definition.
4981 But, if `f' was called before this point, the
4982 instantiation of `f' will have DECL_TI_ARGS corresponding
4983 to `T' but not to `U', references to which might appear
4984 in the definition of `f'. Previously, the most general
4985 template for an instantiation of `f' was the out-of-class
4986 version; now it is the in-class version. Therefore, we
4987 run through all specialization of `f', adding to their
4988 DECL_TI_ARGS appropriately. In particular, they need a
4989 new set of outer arguments, corresponding to the
4990 arguments for this class instantiation.
4992 The same situation can arise with something like this:
4994 friend void f(int);
4995 template <class T> class C {
4996 friend void f(T) {}
4997 };
4999 when `C<int>' is instantiated. Now, `f(int)' is defined
5000 in the class. */
5003 /* On the other hand, if the in-class declaration does
5004 *not* provide a definition, then we don't want to alter
5005 existing definitions. We can just leave everything
5006 alone. */
5007 ;
5008 else
5009 {
5010 /* Overwrite whatever template info was there before, if
5011 any, with the new template information pertaining to
5012 the declaration. */
5018 old_decl);
5019 else
5020 {
5021 tree t;
5022 tree new_friend_args;
5031 {
5037 }
5039 /* Now, since specializations are always supposed to
5040 hang off of the most general template, we must move
5041 them. */
5044 {
5049 }
5050 }
5051 }
5053 /* The information from NEW_FRIEND has been merged into OLD_DECL
5054 by duplicate_decls. */
5056 }
5057 }
5059 {
5060 /* Check to see that the declaration is really present, and,
5061 possibly obtain an improved declaration. */
5067 }
5069 done:
5072 }
5074 /* FRIEND_TMPL is a friend TEMPLATE_DECL. ARGS is the vector of
5075 template arguments, as for tsubst.
5077 Returns an appropriate tsubst'd friend type or error_mark_node on
5078 failure. */
5080 static tree
5082 {
5083 tree friend_type;
5084 tree tmpl;
5085 tree context;
5090 {
5093 else
5095 }
5097 /* First, we look for a class template. */
5100 /* But, if we don't find one, it might be because we're in a
5101 situation like this:
5103 template <class T>
5104 struct S {
5105 template <class U>
5106 friend struct S;
5107 };
5109 Here, in the scope of (say) S<int>, `S' is bound to a TYPE_DECL
5110 for `S<int>', not the TEMPLATE_DECL. */
5112 {
5115 }
5118 {
5119 /* The friend template has already been declared. Just
5120 check to see that the declarations match, and install any new
5121 default parameters. We must tsubst the default parameters,
5122 of course. We only need the innermost template parameters
5123 because that is all that redeclare_class_template will look
5124 at. */
5127 {
5128 tree parms;
5132 }
5135 }
5136 else
5137 {
5138 /* The friend template has not already been declared. In this
5139 case, the instantiation of the template class will cause the
5140 injection of this template into the global scope. */
5143 /* The new TMPL is not an instantiation of anything, so we
5144 forget its origins. We don't reset CLASSTYPE_TI_TEMPLATE for
5145 the new type because that is supposed to be the corresponding
5146 template decl, i.e., TMPL. */
5153 /* Inject this template into the global scope. */
5155 }
5158 {
5161 else
5163 }
5166 }
5168 /* Returns zero if TYPE cannot be completed later due to circularity.
5169 Otherwise returns one. */
5171 static int
5173 {
5183 else
5185 }
5187 tree
5189 {
5191 tree typedecl;
5192 tree pbinfo;
5202 /* Figure out which template is being instantiated. */
5206 /* Figure out which arguments are being used to do the
5207 instantiation. */
5210 /* Determine what specialization of the original template to
5211 instantiate. */
5214 {
5219 {
5221 {
5224 }
5225 }
5228 }
5232 else
5235 /* If the template we're instantiating is incomplete, then clearly
5236 there's nothing we can do. */
5240 /* If we've recursively instantiated too many templates, stop. */
5244 /* Now we're really doing the instantiation. Mark the type as in
5245 the process of being defined. */
5248 /* We may be in the middle of deferred access check. Disable
5249 it now. */
5255 {
5256 /* This TYPE is actually an instantiation of a partial
5257 specialization. We replace the innermost set of ARGS with
5258 the arguments appropriate for substitution. For example,
5259 given:
5261 template <class T> struct S {};
5262 template <class T> struct S<T*> {};
5264 and supposing that we are instantiating S<int*>, ARGS will
5265 present be {int*} but we need {int}. */
5266 tree inner_args
5268 args);
5270 /* If there were multiple levels in ARGS, replacing the
5271 innermost level would alter CLASSTYPE_TI_ARGS, which we don't
5272 want, so we make a copy first. */
5274 {
5277 }
5278 else
5280 }
5283 {
5285 {
5288 }
5289 else
5290 {
5292 SET_CLASSTYPE_INTERFACE_UNKNOWN_X
5294 }
5295 }
5296 else
5297 {
5299 }
5301 /* Set the input location to the template definition. This is needed
5302 if tsubsting causes an error. */
5332 #ifdef ENABLE_CHECKING
5336 /* We should never instantiate a nested class before its enclosing
5337 class; we need to look up the nested class by name before we can
5338 instantiate it, and that lookup should instantiate the enclosing
5339 class. */
5341 #endif
5344 {
5351 /* We must enter the scope containing the type, as that is where
5352 the accessibility of types named in dependent bases are
5353 looked up from. */
5356 /* Substitute into each of the bases to determine the actual
5357 basetypes. */
5359 {
5360 tree base;
5361 tree access;
5362 tree pbase;
5367 /* Substitute to figure out the base class. */
5374 }
5376 /* The list is now in reverse order; correct that. */
5379 /* Now call xref_basetypes to set up all the base-class
5380 information. */
5384 }
5386 /* Now that our base classes are set up, enter the scope of the
5387 class, so that name lookups into base classes, etc. will work
5388 correctly. This is precisely analogous to what we do in
5389 begin_class_definition when defining an ordinary non-template
5390 class. */
5393 /* Now members are processed in the order of declaration. */
5396 {
5400 {
5402 {
5403 /* Build new CLASSTYPE_NESTED_UTDS. */
5407 tree newtag;
5412 {
5414 /* Unfortunately, lookup_template_class sets
5415 CLASSTYPE_IMPLICIT_INSTANTIATION for a partial
5416 instantiation (i.e., for the type of a member
5417 template class nested within a template class.)
5418 This behavior is required for
5419 maybe_process_partial_specialization to work
5420 correctly, but is not accurate in this case;
5421 the TAG is not an instantiation of anything.
5422 (The corresponding TEMPLATE_DECL is an
5423 instantiation, but the TYPE is not.) */
5426 /* Now, we call pushtag to put this NEWTAG into the scope of
5427 TYPE. We first set up the IDENTIFIER_TYPE_VALUE to avoid
5428 pushtag calling push_template_decl. We don't have to do
5429 this for enums because it will already have been done in
5430 tsubst_enum. */
5434 }
5435 }
5438 {
5439 /* Build new TYPE_METHODS. */
5440 tree r;
5450 }
5451 else
5452 {
5453 /* Build new TYPE_FIELDS. */
5456 {
5457 tree r;
5459 /* The the file and line for this declaration, to
5460 assist in error message reporting. Since we
5461 called push_tinst_level above, we don't need to
5462 restore these. */
5471 {
5472 tree init;
5477 else
5480 finish_static_data_member_decl
5485 }
5487 {
5488 /* Determine whether R has a valid type and can be
5489 completed later. If R is invalid, then it is
5490 replaced by error_mark_node so that it will not be
5491 added to TYPE_FIELDS. */
5497 {
5500 }
5501 }
5503 /* If it is a TYPE_DECL for a class-scoped ENUMERAL_TYPE,
5504 such a thing will already have been added to the field
5505 list by tsubst_enum in finish_member_declaration in the
5506 CLASSTYPE_NESTED_UTDS case above. */
5510 {
5513 }
5514 }
5515 }
5516 }
5517 else
5518 {
5520 {
5521 /* Build new CLASSTYPE_FRIEND_CLASSES. */
5524 tree new_friend_type;
5533 else
5534 {
5537 /* The call to xref_tag_from_type does injection for friend
5538 classes. */
5540 new_friend_type =
5543 }
5546 /* Trick make_friend_class into realizing that the friend
5547 we're adding is a template, not an ordinary class. It's
5548 important that we use make_friend_class since it will
5549 perform some error-checking and output cross-reference
5550 information. */
5559 }
5560 else
5561 {
5562 /* Build new DECL_FRIENDLIST. */
5563 tree r;
5571 }
5572 }
5573 }
5575 /* Set the file and line number information to whatever is given for
5576 the class itself. This puts error messages involving generated
5577 implicit functions at a predictable point, and the same point
5578 that would be used for non-template classes. */
5585 /* Clear this now so repo_template_used is happy. */
5589 /* Now that the class is complete, instantiate default arguments for
5590 any member functions. We don't do this earlier because the
5591 default arguments may reference members of the class. */
5595 /* Implicitly generated member functions will not have template
5596 information; they are not instantiations, but instead are
5597 created "fresh" for each instantiation. */
5610 }
5612 static tree
5614 {
5615 tree r;
5621 else
5622 {
5626 {
5627 /* Sometimes, one of the args was an expression involving a
5628 template constant parameter, like N - 1. Now that we've
5629 tsubst'd, we might have something like 2 - 1. This will
5630 confuse lookup_template_class, so we do constant folding
5631 here. We have to unset processing_template_decl, to fool
5632 tsubst_copy_and_build() into building an actual tree. */
5634 /* If the TREE_TYPE of ARG is not NULL_TREE, ARG is already
5635 as simple as it's going to get, and trying to reprocess
5636 the trees will break. Once tsubst_expr et al DTRT for
5637 non-dependent exprs, this code can go away, as the type
5638 will always be set. */
5640 {
5647 }
5649 }
5650 }
5652 }
5654 /* Substitute ARGS into the vector or list of template arguments T. */
5656 static tree
5658 {
5664 {
5666 tree new_arg;
5670 else
5679 }
5689 }
5691 /* Return the result of substituting ARGS into the template parameters
5692 given by PARMS. If there are m levels of ARGS and m + n levels of
5693 PARMS, then the result will contain n levels of PARMS. For
5694 example, if PARMS is `template <class T> template <class U>
5695 template <T*, U, class V>' and ARGS is {{int}, {double}} then the
5696 result will be `template <int*, double, class V>'. */
5698 static tree
5700 {
5708 {
5709 tree new_vec =
5714 {
5725 }
5731 }
5734 }
5736 /* Substitute the ARGS into the indicated aggregate (or enumeration)
5737 type T. If T is not an aggregate or enumeration type, it is
5738 handled as if by tsubst. IN_DECL is as for tsubst. If
5739 ENTERING_SCOPE is nonzero, T is the context for a template which
5740 we are presently tsubst'ing. Return the substituted value. */
5742 static tree
5744 tree args,
5745 tsubst_flags_t complain,
5746 tree in_decl,
5748 {
5753 {
5758 /* else fall through */
5762 {
5763 tree argvec;
5764 tree context;
5765 tree r;
5767 /* First, determine the context for the type we are looking
5768 up. */
5774 /* Then, figure out what arguments are appropriate for the
5775 type we are trying to find. For example, given:
5777 template <class T> struct S;
5778 template <class T, class U> void f(T, U) { S<U> su; }
5780 and supposing that we are instantiating f<int, double>,
5781 then our ARGS will be {int, double}, but, when looking up
5782 S we only want {double}. */
5792 }
5793 else
5794 /* This is not a template type, so there's nothing to do. */
5799 }
5800 }
5802 /* Substitute into the default argument ARG (a default argument for
5803 FN), which has the indicated TYPE. */
5805 tree
5807 {
5808 /* This default argument came from a template. Instantiate the
5809 default argument here, not in tsubst. In the case of
5810 something like:
5812 template <class T>
5813 struct S {
5814 static T t();
5815 void f(T = t());
5816 };
5818 we must be careful to do name lookup in the scope of S<T>,
5819 rather than in the current class.
5821 ??? current_class_type affects a lot more than name lookup. This is
5822 very fragile. Fortunately, it will go away when we do 2-phase name
5823 binding properly. */
5825 /* FN is already the desired FUNCTION_DECL. */
5833 /* Make sure the default argument is reasonable. */
5837 }
5839 /* Substitute into all the default arguments for FN. */
5841 static void
5843 {
5844 tree arg;
5845 tree tmpl_args;
5849 /* If this function is not yet instantiated, we certainly don't need
5850 its default arguments. */
5855 arg;
5861 }
5863 /* Substitute the ARGS into the T, which is a _DECL. TYPE is the
5864 (already computed) substitution of ARGS into TREE_TYPE (T), if
5865 appropriate. Return the result of the substitution. Issue error
5866 and warning messages under control of COMPLAIN. */
5868 static tree
5870 {
5871 location_t saved_loc;
5875 /* Set the filename and linenumber to improve error-reporting. */
5880 {
5882 {
5883 /* We can get here when processing a member template function
5884 of a template class. */
5886 tree spec;
5890 {
5891 /* We might already have an instance of this template.
5892 The ARGS are for the surrounding class type, so the
5893 full args contain the tsubst'd args for the context,
5894 plus the innermost args from the template decl. */
5898 tree full_args;
5903 /* tsubst_template_args doesn't copy the vector if
5904 nothing changed. But, *something* should have
5905 changed. */
5910 {
5913 }
5914 }
5916 /* Make a new template decl. It will be similar to the
5917 original, but will record the current template arguments.
5918 We also create a new function declaration, which is just
5919 like the old one, but points to this new template, rather
5920 than the old one. */
5926 {
5931 }
5940 {
5946 }
5947 else
5948 {
5957 }
5963 /* The template parameters for this new template are all the
5964 template parameters for the old template, except the
5965 outermost level of parameters. */
5968 complain);
5974 /* Record this non-type partial instantiation. */
5977 }
5981 {
5982 tree ctx;
5985 tree gen_tmpl;
5990 /* Nobody should be tsubst'ing into non-template functions. */
5994 {
5995 tree spec;
5998 /* If T is not dependent, just return it. We have to
5999 increment PROCESSING_TEMPLATE_DECL because
6000 value_dependent_expression_p assumes that nothing is
6001 dependent when PROCESSING_TEMPLATE_DECL is zero. */
6008 /* Calculate the most general template of which R is a
6009 specialization, and the complete set of arguments used to
6010 specialize R. */
6016 /* Check to see if we already have this specialization. */
6020 {
6023 }
6025 /* We can see more levels of arguments than parameters if
6026 there was a specialization of a member template, like
6027 this:
6029 template <class T> struct S { template <class U> void f(); }
6030 template <> template <class U> void S<int>::f(U);
6032 Here, we'll be substituting into the specialization,
6033 because that's where we can find the code we actually
6034 want to generate, but we'll have enough arguments for
6035 the most general template.
6037 We also deal with the peculiar case:
6039 template <class T> struct S {
6040 template <class U> friend void f();
6041 };
6042 template <class U> void f() {}
6043 template S<int>;
6044 template void f<double>();
6046 Here, the ARGS for the instantiation of will be {int,
6047 double}. But, we only need as many ARGS as there are
6048 levels of template parameters in CODE_PATTERN. We are
6049 careful not to get fooled into reducing the ARGS in
6050 situations like:
6052 template <class T> struct S { template <class U> void f(U); }
6053 template <class T> template <> void S<T>::f(int) {}
6055 which we can spot because the pattern will be a
6056 specialization in this case. */
6058 parms_depth =
6063 }
6064 else
6065 {
6066 /* This special case arises when we have something like this:
6068 template <class T> struct S {
6069 friend void f<int>(int, double);
6070 };
6072 Here, the DECL_TI_TEMPLATE for the friend declaration
6073 will be an IDENTIFIER_NODE. We are being called from
6074 tsubst_friend_function, and we want only to create a
6075 new decl (R) with appropriate types so that we can call
6076 determine_specialization. */
6078 }
6081 {
6084 else
6088 }
6089 else
6090 {
6093 }
6098 /* We do NOT check for matching decls pushed separately at this
6099 point, as they may not represent instantiations of this
6100 template, and in any case are considered separate under the
6101 discrete model. */
6105 /* Clear out the mangled name and RTL for the instantiation. */
6112 /* Type-conversion operator. Reconstruct the name, in
6113 case it's the name of one of the template's parameters. */
6131 {
6136 }
6138 /* Set up the DECL_TEMPLATE_INFO for R. There's no need to do
6139 this in the special friend case mentioned above where
6140 GEN_TMPL is NULL. */
6142 {
6148 /* We're not supposed to instantiate default arguments
6149 until they are called, for a template. But, for a
6150 declaration like:
6152 template <class T> void f ()
6153 { extern void g(int i = T()); }
6155 we should do the substitution when the template is
6156 instantiated. We handle the member function case in
6157 instantiate_class_template since the default arguments
6158 might refer to other members of the class. */
6163 }
6165 /* Copy the list of befriending classes. */
6169 {
6173 in_decl);
6174 }
6177 {
6181 /* If this is an instantiation of a member template, clone it.
6182 If it isn't, that'll be handled by
6183 clone_constructors_and_destructors. */
6186 }
6190 }
6194 {
6203 {
6206 else
6209 }
6218 }
6222 {
6227 /* We don't have to set DECL_CONTEXT here; it is set by
6228 finish_member_declaration. */
6234 }
6238 {
6240 /* It is not a dependent using decl any more. */
6247 }
6253 {
6254 /* If this is the canonical decl, we don't have to mess with
6255 instantiations, and often we can't (for typename, template
6256 type parms and such). Note that TYPE_NAME is not correct for
6257 the above test if we've copied the type for a typedef. */
6260 }
6262 /* Fall through. */
6265 {
6268 tree spec;
6270 tree ctx;
6273 /* Assume this is a non-local variable. */
6278 complain,
6282 else
6283 {
6284 /* Subsequent calls to pushdecl will fill this in. */
6287 }
6289 /* Check to see if we already have this specialization. */
6291 {
6296 }
6297 else
6301 {
6304 }
6308 {
6312 }
6318 /* Clear out the mangled name and RTL for the instantiation. */
6322 /* Don't try to expand the initializer until someone tries to use
6323 this variable; otherwise we run into circular dependencies. */
6328 /* Even if the original location is out of scope, the newly
6329 substituted one is not. */
6331 {
6334 }
6337 {
6338 /* A static data member declaration is always marked
6339 external when it is declared in-class, even if an
6340 initializer is present. We mimic the non-template
6341 processing here. */
6347 }
6348 else
6354 /* Compute the size, alignment, etc. of R. */
6356 }
6361 }
6363 /* Restore the file and line information. */
6367 }
6369 /* Substitute into the ARG_TYPES of a function type. */
6371 static tree
6373 tree args,
6374 tsubst_flags_t complain,
6375 tree in_decl)
6376 {
6377 tree remaining_arg_types;
6378 tree type;
6392 {
6394 {
6398 }
6400 }
6402 /* Do array-to-pointer, function-to-pointer conversion, and ignore
6403 top-level qualifiers as required. */
6406 /* Note that we do not substitute into default arguments here. The
6407 standard mandates that they be instantiated only when needed,
6408 which is done in build_over_call. */
6410 remaining_arg_types);
6412 }
6414 /* Substitute into a FUNCTION_TYPE or METHOD_TYPE. This routine does
6415 *not* handle the exception-specification for FNTYPE, because the
6416 initial substitution of explicitly provided template parameters
6417 during argument deduction forbids substitution into the
6418 exception-specification:
6420 [temp.deduct]
6422 All references in the function type of the function template to the
6423 corresponding template parameters are replaced by the specified tem-
6424 plate argument values. If a substitution in a template parameter or
6425 in the function type of the function template results in an invalid
6426 type, type deduction fails. [Note: The equivalent substitution in
6427 exception specifications is done only when the function is instanti-
6428 ated, at which point a program is ill-formed if the substitution
6429 results in an invalid type.] */
6431 static tree
6433 tree args,
6434 tsubst_flags_t complain,
6435 tree in_decl)
6436 {
6437 tree return_type;
6438 tree arg_types;
6439 tree fntype;
6441 /* The TYPE_CONTEXT is not used for function/method types. */
6444 /* Substitute the return type. */
6449 /* Substitute the argument types. */
6455 /* Construct a new type node and return it. */
6458 else
6459 {
6462 {
6463 /* [temp.deduct]
6465 Type deduction may fail for any of the following
6466 reasons:
6468 -- Attempting to create "pointer to member of T" when T
6469 is not a class type. */
6472 r);
6474 }
6478 }
6483 }
6485 /* Substitute into the PARMS of a call-declarator. */
6487 static tree
6489 tree args,
6490 tsubst_flags_t complain,
6491 tree in_decl)
6492 {
6493 tree new_parms;
6494 tree type;
6495 tree defarg;
6503 /* Figure out the type of this parameter. */
6506 /* Figure out the default argument as well. Note that we use
6507 tsubst_expr since the default argument is really an expression. */
6510 /* Chain this parameter on to the front of those we have already
6511 processed. We don't use hash_tree_cons because that function
6512 doesn't check TREE_PARMLIST. */
6515 /* And note that these are parameters. */
6519 }
6521 /* Take the tree structure T and replace template parameters used
6522 therein with the argument vector ARGS. IN_DECL is an associated
6523 decl for diagnostics. If an error occurs, returns ERROR_MARK_NODE.
6524 Issue error and warning messages under control of COMPLAIN. Note
6525 that we must be relatively non-tolerant of extensions here, in
6526 order to preserve conformance; if we allow substitutions that
6527 should not be allowed, we may allow argument deductions that should
6528 not succeed, and therefore report ambiguous overload situations
6529 where there are none. In theory, we could allow the substitution,
6530 but indicate that it should have failed, and allow our caller to
6531 make sure that the right thing happens, but we don't try to do this
6532 yet.
6534 This function is used for dealing with types, decls and the like;
6535 for expressions, use tsubst_expr or tsubst_copy. */
6537 static tree
6539 {
6551 else
6570 {
6597 {
6600 /* The array dimension behaves like a non-type template arg,
6601 in that we want to fold it as much as possible. */
6607 /* When providing explicit arguments to a template
6608 function, but leaving some arguments for subsequent
6609 deduction, MAX may be template-dependent even if we're
6610 not PROCESSING_TEMPLATE_DECL. We still need to check for
6611 template parms, though; MAX won't be an INTEGER_CST for
6612 dynamic arrays, either. */
6615 {
6619 integer_one_node);
6621 }
6624 {
6625 /* Still allow an explicit array of size zero. */
6628 }
6632 {
6633 /* [temp.deduct]
6635 Type deduction may fail for any of the following
6636 reasons:
6638 Attempting to create an array with a size that is
6639 zero or negative. */
6644 }
6647 }
6653 {
6663 {
6666 }
6667 else
6668 {
6671 }
6674 {
6684 {
6686 {
6688 return cp_build_qualified_type_real
6691 }
6693 {
6694 /* We are processing a type constructed from
6695 a template template parameter */
6701 /* We can get a TEMPLATE_TEMPLATE_PARM here when
6702 we are resolving nested-types in the signature of
6703 a member function templates.
6704 Otherwise ARG is a TEMPLATE_DECL and is the real
6705 template to be instantiated. */
6713 complain);
6714 return cp_build_qualified_type_real
6716 }
6717 else
6718 /* TEMPLATE_TEMPLATE_PARM or TEMPLATE_PARM_INDEX. */
6720 }
6721 }
6722 else
6726 /* This can happen during the attempted tsubst'ing in
6727 unify. This means that we don't yet have any information
6728 about the template parameter in question. */
6731 /* If we get here, we must have been looking at a parm for a
6732 more deeply nested template. Make a new version of this
6733 template parameter, but with a lower level. */
6735 {
6740 {
6742 r = cp_build_qualified_type_real
6746 }
6747 else
6748 {
6759 {
6767 }
6768 }
6777 }
6780 }
6783 {
6791 {
6795 }
6798 {
6802 }
6805 {
6809 }
6815 {
6818 }
6819 else
6822 }
6825 {
6826 /* A binfo node. We always need to make a copy, of the node
6827 itself and of its BINFO_BASETYPES. */
6831 /* Make sure type isn't a typedef copy. */
6836 {
6841 }
6843 }
6845 /* Otherwise, a vector of template arguments. */
6850 {
6859 /* [temp.deduct]
6861 Type deduction may fail for any of the following
6862 reasons:
6864 -- Attempting to create a pointer to reference type.
6865 -- Attempting to create a reference to a reference type or
6866 a reference to void. */
6869 {
6872 /* We keep track of the last time we issued this error
6873 message to avoid spewing a ton of messages during a
6874 single bad template instantiation. */
6878 {
6881 else
6884 type);
6886 }
6889 }
6891 {
6895 }
6896 else
6901 /* Will this ever be needed for TYPE_..._TO values? */
6905 }
6907 {
6910 {
6911 /* [temp.deduct]
6913 Type deduction may fail for any of the following
6914 reasons:
6916 -- Attempting to create "pointer to member of T" when T
6917 is not a class type. */
6921 }
6923 {
6928 }
6931 {
6932 /* This is really a method type. The cv qualifiers of the
6933 this pointer should _not_ be determined by the cv
6934 qualifiers of the class type. They should be held
6935 somewhere in the FUNCTION_TYPE, but we don't do that at
6936 the moment. Consider
6937 typedef void (Func) () const;
6939 template <typename T1> void Foo (Func T1::*);
6941 */
6942 tree method_type;
6948 }
6949 else
6952 complain);
6953 }
6956 {
6957 tree fntype;
6958 tree raises;
6964 /* Substitute the exception specification. */
6967 {
6972 else
6974 {
6981 }
6983 }
6985 }
6987 {
6992 /* As an optimization, we avoid regenerating the array type if
6993 it will obviously be the same as T. */
6997 /* These checks should match the ones in grokdeclarator.
6999 [temp.deduct]
7001 The deduction may fail for any of the following reasons:
7003 -- Attempting to create an array with an element type that
7004 is void, a function type, or a reference type. */
7008 {
7012 }
7016 }
7020 {
7028 }
7032 {
7038 }
7041 {
7051 {
7054 ctx);
7056 }
7058 {
7059 /* Normally, make_typename_type does not require that the CTX
7060 have complete type in order to allow things like:
7062 template <class T> struct S { typename S<T>::X Y; };
7064 But, such constructs have already been resolved by this
7065 point, so here CTX really should have complete type, unless
7066 it's a partial instantiation. */
7069 {
7073 }
7074 }
7081 {
7084 }
7086 return cp_build_qualified_type_real
7088 }
7091 {
7100 }
7103 {
7108 }
7111 {
7116 }
7119 {
7126 }
7129 {
7131 tree e2 = (tsubst_call_declarator_parms
7141 }
7144 {
7151 }
7154 {
7162 complain);
7163 }
7169 }
7170 }
7172 /* Like tsubst_expr for a BASELINK. OBJECT_TYPE, if non-NULL, is the
7173 type of the expression on the left-hand side of the "." or "->"
7174 operator. */
7176 static tree
7179 {
7180 tree name;
7181 tree qualifying_scope;
7182 tree fns;
7186 /* A baselink indicates a function from a base class. The
7187 BASELINK_ACCESS_BINFO and BASELINK_BINFO are going to have
7188 non-dependent types; otherwise, the lookup could not have
7189 succeeded. However, they may indicate bases of the template
7190 class, rather than the instantiated class.
7192 In addition, lookups that were not ambiguous before may be
7193 ambiguous now. Therefore, we perform the lookup again. */
7197 {
7204 }
7211 template_args);
7215 qualifying_scope,
7216 object_type);
7217 }
7219 /* Like tsubst_expr for a SCOPE_REF, given by QUALIFIED_ID. DONE is
7220 true if the qualified-id will be a postfix-expression in-and-of
7221 itself; false if more of the postfix-expression follows the
7222 QUALIFIED_ID. ADDRESS_P is true if the qualified-id is the operand
7223 of "&". */
7225 static tree
7229 {
7230 tree expr;
7231 tree scope;
7232 tree name;
7234 tree template_args;
7238 /* Figure out what name to look up. */
7241 {
7248 }
7249 else
7250 {
7253 }
7255 /* Substitute into the qualifying scope. When there are no ARGS, we
7256 are just trying to simplify a non-dependent expression. In that
7257 case the qualifying scope may be dependent, and, in any case,
7258 substituting will not help. */
7261 {
7264 }
7265 else
7271 {
7275 {
7278 qualified_id);
7280 }
7281 }
7285 scope);
7287 /* Remember that there was a reference to this entity. */
7289 {
7293 }
7301 {
7302 expr = (adjust_result_of_qualified_name_lookup
7305 }
7308 }
7310 /* Like tsubst, but deals with expressions. This function just replaces
7311 template parms; to finish processing the resultant expression, use
7312 tsubst_expr. */
7314 static tree
7316 {
7318 tree r;
7326 {
7333 {
7334 tree enum_type;
7335 tree v;
7339 /* There is no need to substitute into namespace-scope
7340 enumerators. */
7344 /* Unfortunately, we cannot just call lookup_name here.
7345 Consider:
7347 template <int I> int f() {
7348 enum E { a = I };
7349 struct S { void g() { E e = a; } };
7350 };
7352 When we instantiate f<7>::S::g(), say, lookup_name is not
7353 clever enough to find f<7>::a. */
7354 enum_type
7364 /* We didn't find the name. That should never happen; if
7365 name-lookup found it during preliminary parsing, we
7366 should find it again here during instantiation. */
7368 }
7373 {
7374 tree ctx;
7380 }
7402 {
7403 /* Template template argument like the following example need
7404 special treatment:
7406 template <template <class> class TT> struct C {};
7407 template <class T> struct D {
7408 template <class U> struct E {};
7409 C<E> c; // #1
7410 };
7411 D<int> d; // #2
7413 We are processing the template argument `E' in #1 for
7414 the template instantiation #2. Originally, `E' is a
7415 TEMPLATE_DECL with `D<T>' as its DECL_CONTEXT. Now we
7416 have to substitute this with one having context `D<int>'. */
7420 }
7421 else
7422 /* Ordinary template template argument. */
7431 return build1
7448 return build1
7453 {
7454 tree object;
7455 tree name;
7460 {
7464 }
7467 {
7475 }
7480 in_decl);
7481 else
7484 }
7524 return build_nt
7533 in_decl),
7534 NULL_TREE);
7537 /* This processing should really occur in tsubst_expr. However,
7538 tsubst_expr does not recurse into expressions, since it
7539 assumes that there aren't any statements inside them. So, we
7540 need to expand the STMT_EXPR here. */
7542 {
7548 }
7555 {
7556 r = build_nt
7561 }
7564 {
7565 r = build_nt
7571 }
7574 {
7575 r = build_nt
7581 }
7584 {
7585 /* Substituted template arguments */
7594 }
7597 {
7617 }
7641 {
7644 }
7645 else
7649 {
7650 r = build_constructor
7655 }
7659 in_decl),
7664 }
7665 }
7667 /* Like tsubst_copy for expressions, etc. but also does semantic
7668 processing. */
7670 static tree
7672 {
7674 tsubst_flags_t stmt_expr
7689 {
7703 {
7704 tree r;
7711 else
7714 }
7723 {
7724 tree decl;
7725 tree init;
7732 {
7735 tree decl;
7743 else
7745 }
7746 else
7747 {
7751 {
7754 /* By marking the declaration as instantiated, we avoid
7755 trying to instantiate it. Since instantiate_decl can't
7756 handle local variables, and since we've already done
7757 all that needs to be done, that's the right thing to
7758 do. */
7763 /* Anonymous aggregates are a special case. */
7765 else
7766 {
7770 {
7771 /* For __PRETTY_FUNCTION__ we have to adjust the
7772 initializer. */
7776 }
7777 else
7780 }
7781 }
7782 }
7784 /* A DECL_STMT can also be used as an expression, in the condition
7785 clause of an if/for/while construct. If we aren't followed by
7786 another statement, return our decl. */
7789 }
7793 {
7801 stmt);
7806 }
7810 {
7815 stmt);
7818 }
7822 {
7829 stmt);
7830 }
7834 {
7839 stmt);
7842 {
7845 }
7848 {
7852 }
7855 }
7859 {
7863 else
7868 in_decl);
7872 else
7874 }
7888 {
7889 tree val;
7897 }
7904 in_decl));
7921 /* Computed goto's must be tsubst'd into. On the other hand,
7922 non-computed gotos must not be; the identifier in question
7923 will have no binding. */
7925 else
7932 tmp = finish_asm_stmt
7944 {
7950 stmt);
7951 }
7952 else
7953 {
7956 else
7963 else
7969 else
7971 }
7975 {
7976 tree decl;
7981 {
7984 /* Prevent instantiate_decl from trying to instantiate
7985 this variable. We've already done all that needs to be
7986 done. */
7988 }
7989 else
7994 }
8004 }
8007 }
8009 /* T is a postfix-expression that is not being used in a function
8010 call. Return the substituted version of T. */
8012 static tree
8014 tsubst_flags_t complain,
8015 tree in_decl)
8016 {
8020 else
8025 }
8027 /* Like tsubst but deals with expressions and performs semantic
8028 analysis. FUNCTION_P is true if T is the "F" in "F (ARGS)". */
8030 tree
8032 tree args,
8033 tsubst_flags_t complain,
8034 tree in_decl,
8036 {
8037 #define RECUR(NODE) \
8040 tree op1;
8046 {
8049 /* Fallthrough. */
8051 {
8052 tree decl;
8053 cp_id_kind idk;
8054 tree qualifying_class;
8059 {
8062 }
8064 /* Look up the name. */
8067 /* By convention, expressions use ERROR_MARK_NODE to indicate
8068 failure, not NULL_TREE. */
8084 }
8087 {
8088 tree object;
8096 {
8099 }
8100 else
8107 else
8109 }
8115 return build_functional_cast
8120 return build_reinterpret_cast
8125 return build_const_cast
8130 return build_dynamic_cast
8135 return build_static_cast
8161 else
8163 in_decl);
8199 return build_x_binary_op
8211 /* new-type-id */
8216 /* Remember that there was a reference to this entity. */
8225 {
8226 /* When there are no ARGS, we are trying to evaluate a
8227 non-dependent expression from the parser. Trying to do
8228 the substitutions may not work. */
8231 }
8232 else
8233 {
8237 }
8240 else
8244 return build_x_modify_expr
8252 /* Remember that there was a reference to this entity. */
8258 return build_new
8265 return delete_sanity
8276 {
8277 tree function;
8278 tree call_args;
8283 /* When we parsed the expression, we determined whether or
8284 not Koenig lookup should be performed. */
8287 {
8292 }
8293 else
8294 {
8299 in_decl,
8303 }
8314 {
8317 }
8319 /* Remember that there was a reference to this entity. */
8335 koenig_p);
8336 }
8339 return build_x_conditional_expr
8345 return finish_pseudo_destructor_expr
8351 {
8371 }
8374 {
8375 tree object;
8376 tree member;
8380 /* Remember that there was a reference to this entity. */
8389 else
8393 {
8396 NULL_TREE,
8401 object,
8403 }
8406 {
8407 tree tmpl;
8408 tree args;
8410 /* Lookup the template functions now that we know what the
8411 scope is. */
8420 args);
8421 else
8422 {
8425 }
8426 }
8431 }
8434 return build_throw
8438 {
8439 tree r;
8440 tree elts;
8444 /* digest_init will do the wrong thing if we let it. */
8449 /* We do not want to process the purpose of aggregate
8450 initializers as they are identifier nodes which will be
8451 looked up by digest_init. */
8454 elts;
8456 {
8464 }
8472 }
8475 {
8480 }
8488 else
8489 /* If there are no ARGS, then we are evaluating a
8490 non-dependent expression. If the expression is
8491 non-dependent, the variable must be a constant. */
8498 in_decl));
8502 }
8504 #undef RECUR
8505 }
8507 /* Verify that the instantiated ARGS are valid. For type arguments,
8508 make sure that the type's linkage is ok. For non-type arguments,
8509 make sure they are constants if they are integral or enumerations.
8510 Emit an error under control of COMPLAIN, and return TRUE on error. */
8512 static bool
8514 {
8519 {
8523 {
8524 /* [basic.link]: A name with no linkage (notably, the name
8525 of a class or enumeration declared in a local scope)
8526 shall not be used to declare an entity with linkage.
8527 This implies that names with no linkage cannot be used as
8528 template arguments. */
8532 {
8537 else
8540 }
8541 /* In order to avoid all sorts of complications, we do not
8542 allow variably-modified types as template arguments. */
8544 {
8548 }
8549 }
8550 /* A non-type argument of integral or enumerated type must be a
8551 constant. */
8555 {
8559 }
8560 }
8564 }
8566 /* Instantiate the indicated variable or function template TMPL with
8567 the template arguments in TARG_PTR. */
8569 tree
8571 {
8572 tree fndecl;
8573 tree gen_tmpl;
8574 tree spec;
8581 /* If this function is a clone, handle it specially. */
8583 {
8585 complain);
8586 tree clone;
8588 /* Look for the clone. */
8594 /* We should always have found the clone by now. */
8597 }
8599 /* Check to see if we already have this specialization. */
8606 {
8607 /* The TMPL is a partial instantiation. To get a full set of
8608 arguments we must add the arguments used to perform the
8609 partial instantiation. */
8611 targ_ptr);
8613 /* Check to see if we already have this specialization. */
8617 }
8620 complain))
8623 /* We are building a FUNCTION_DECL, during which the access of its
8624 parameters and return types have to be checked. However this
8625 FUNCTION_DECL which is the desired context for access checking
8626 is not built yet. We solve this chicken-and-egg problem by
8627 deferring all checks until we have the FUNCTION_DECL. */
8630 /* substitute template parameters */
8634 /* Now we know the specialization, compute access previously
8635 deferred. */
8641 /* The DECL_TI_TEMPLATE should always be the immediate parent
8642 template, not the most general template. */
8648 /* If we've just instantiated the main entry point for a function,
8649 instantiate all the alternate entry points as well. We do this
8650 by cloning the instantiation of the main entry point, not by
8651 instantiating the template clones. */
8656 }
8658 /* The FN is a TEMPLATE_DECL for a function. The ARGS are the
8659 arguments that are being used when calling it. TARGS is a vector
8660 into which the deduced template arguments are placed.
8662 Return zero for success, 2 for an incomplete match that doesn't resolve
8663 all the types, and 1 for complete failure. An error message will be
8664 printed only for an incomplete match.
8666 If FN is a conversion operator, or we are trying to produce a specific
8667 specialization, RETURN_TYPE is the return type desired.
8669 The EXPLICIT_TARGS are explicit template arguments provided via a
8670 template-id.
8672 The parameter STRICT is one of:
8674 DEDUCE_CALL:
8675 We are deducing arguments for a function call, as in
8676 [temp.deduct.call].
8678 DEDUCE_CONV:
8679 We are deducing arguments for a conversion function, as in
8680 [temp.deduct.conv].
8682 DEDUCE_EXACT:
8683 We are deducing arguments when doing an explicit instantiation
8684 as in [temp.explicit], when determining an explicit specialization
8685 as in [temp.expl.spec], or when taking the address of a function
8686 template, as in [temp.deduct.funcaddr].
8688 DEDUCE_ORDER:
8689 We are deducing arguments when calculating the partial
8690 ordering between specializations of function or class
8691 templates, as in [temp.func.order] and [temp.class.order].
8693 LEN is the number of parms to consider before returning success, or -1
8694 for all. This is used in partial ordering to avoid comparing parms for
8695 which no actual argument was passed, since they are not considered in
8696 overload resolution (and are explicitly excluded from consideration in
8697 partial ordering in [temp.func.order]/6). */
8699 int
8701 tree explicit_targs,
8702 tree targs,
8703 tree args,
8704 tree return_type,
8705 unification_kind_t strict,
8707 {
8708 tree parms;
8709 tree fntype;
8716 {
8717 /* [temp.deduct]
8719 The specified template arguments must match the template
8720 parameters in kind (i.e., type, nontype, template), and there
8721 must not be more arguments than there are parameters;
8722 otherwise type deduction fails.
8724 Nontype arguments must match the types of the corresponding
8725 nontype template parameters, or must be convertible to the
8726 types of the corresponding nontype parameters as specified in
8727 _temp.arg.nontype_, otherwise type deduction fails.
8729 All references in the function type of the function template
8730 to the corresponding template parameters are replaced by the
8731 specified template argument values. If a substitution in a
8732 template parameter or in the function type of the function
8733 template results in an invalid type, type deduction fails. */
8735 tree converted_args;
8738 converted_args
8745 /* Substitute the explicit args into the function type. This is
8746 necessary so that, for instance, explicitly declared function
8747 arguments can match null pointed constants. If we were given
8748 an incomplete set of explicit args, we must not do semantic
8749 processing during substitution as we could create partial
8750 instantiations. */
8759 /* Place the explicitly specified arguments in TARGS. */
8762 }
8765 /* Never do unification on the 'this' parameter. */
8770 {
8771 /* We've been given a return type to match, prepend it. */
8776 }
8778 /* We allow incomplete unification without an error message here
8779 because the standard doesn't seem to explicitly prohibit it. Our
8780 callers must be ready to deal with unification failures in any
8781 event. */
8787 /* All is well so far. Now, check:
8789 [temp.deduct]
8791 When all template arguments have been deduced, all uses of
8792 template parameters in nondeduced contexts are replaced with
8793 the corresponding deduced argument values. If the
8794 substitution results in an invalid type, as described above,
8795 type deduction fails. */
8801 }
8803 /* Adjust types before performing type deduction, as described in
8804 [temp.deduct.call] and [temp.deduct.conv]. The rules in these two
8805 sections are symmetric. PARM is the type of a function parameter
8806 or the return type of the conversion function. ARG is the type of
8807 the argument passed to the call, or the type of the value
8808 initialized with the result of the conversion function. */
8810 static int
8814 {
8818 {
8823 {
8824 /* Swap PARM and ARG throughout the remainder of this
8825 function; the handling is precisely symmetric since PARM
8826 will initialize ARG rather than vice versa. */
8831 }
8834 /* There is nothing to do in this case. */
8838 /* DR 214. [temp.func.order] is underspecified, and leads to no
8839 ordering between things like `T *' and `T const &' for `U *'.
8840 The former has T=U and the latter T=U*. The former looks more
8841 specialized and John Spicer considers it well-formed (the EDG
8842 compiler accepts it).
8844 John also confirms that deduction should proceed as in a function
8845 call. Which implies the usual ARG and PARM conversions as DEDUCE_CALL.
8846 However, in ordering, ARG can have REFERENCE_TYPE, but no argument
8847 to an actual call can have such a type.
8849 If both ARG and PARM are REFERENCE_TYPE, we change neither.
8850 If only ARG is a REFERENCE_TYPE, we look through that and then
8851 proceed as with DEDUCE_CALL (which could further convert it). */
8853 {
8857 }
8861 }
8864 {
8865 /* [temp.deduct.call]
8867 If P is not a reference type:
8869 --If A is an array type, the pointer type produced by the
8870 array-to-pointer standard conversion (_conv.array_) is
8871 used in place of A for type deduction; otherwise,
8873 --If A is a function type, the pointer type produced by
8874 the function-to-pointer standard conversion
8875 (_conv.func_) is used in place of A for type deduction;
8876 otherwise,
8878 --If A is a cv-qualified type, the top level
8879 cv-qualifiers of A's type are ignored for type
8880 deduction. */
8885 else
8887 }
8889 /* [temp.deduct.call]
8891 If P is a cv-qualified type, the top level cv-qualifiers
8892 of P's type are ignored for type deduction. If P is a
8893 reference type, the type referred to by P is used for
8894 type deduction. */
8897 {
8900 }
8902 /* DR 322. For conversion deduction, remove a reference type on parm
8903 too (which has been swapped into ARG). */
8908 }
8910 /* Most parms like fn_type_unification.
8912 If SUBR is 1, we're being called recursively (to unify the
8913 arguments of a function or method parameter of a function
8914 template). */
8916 static int
8918 tree targs,
8919 tree xparms,
8920 tree xargs,
8922 unification_kind_t strict,
8925 {
8941 {
8961 }
8966 again:
8973 && args
8975 {
8984 /* We can't deduce anything from this, but we might get all the
8985 template args from other function args. */
8988 /* Conversions will be performed on a function argument that
8989 corresponds with a function parameter that contains only
8990 non-deducible template parameters and explicitly specified
8991 template parameters. */
8993 {
8994 tree type;
8998 else
8999 {
9002 }
9005 {
9008 }
9009 else
9010 /* It might work; we shouldn't check now, because we might
9011 get into infinite recursion. Overload resolution will
9012 handle it. */
9016 }
9019 {
9022 {
9023 /* [temp.deduct.type] A template-argument can be deduced from
9024 a pointer to function or pointer to member function
9025 argument if the set of overloaded functions does not
9026 contain function templates and at most one of a set of
9027 overloaded functions provides a unique match. */
9034 }
9038 }
9040 {
9048 }
9050 /* Are we done with the interesting parms? */
9053 }
9054 /* Fail if we've reached the end of the parm list, and more args
9055 are present, and the parm list isn't variadic. */
9058 /* Fail if parms are left and they don't have default values. */
9064 done:
9068 {
9071 /* If this is an undeduced nontype parameter that depends on
9072 a type parameter, try another pass; its type may have been
9073 deduced from a later argument than the one from which
9074 this parameter can be deduced. */
9083 }
9085 }
9087 /* Subroutine of type_unification_real. Args are like the variables at the
9088 call site. ARG is an overloaded function (or template-id); we try
9089 deducing template args from each of the overloads, and if only one
9090 succeeds, we go with that. Modifies TARGS and returns 0 on success. */
9092 static int
9094 tree targs,
9095 tree parm,
9096 tree arg,
9097 unification_kind_t strict,
9099 {
9105 {
9108 }
9109 else
9113 /* Handle `&x' where `x' is some static or non-static member
9114 function name. */
9120 /* Strip baselink information. */
9125 {
9126 /* If we got some explicit template args, we need to plug them into
9127 the affected templates before we try to unify, in case the
9128 explicit args will completely resolve the templates in question. */
9134 {
9142 expl_subargs);
9144 {
9148 }
9149 }
9150 }
9153 {
9158 }
9159 else
9162 /* [temp.deduct.type] A template-argument can be deduced from a pointer
9163 to function or pointer to member function argument if the set of
9164 overloaded functions does not contain function templates and at most
9165 one of a set of overloaded functions provides a unique match.
9167 So if we found multiple possibilities, we return success but don't
9168 deduce anything. */
9171 {
9176 }
9181 }
9183 /* Subroutine of resolve_overloaded_unification; does deduction for a single
9184 overload. Fills TARGS with any deduced arguments, or error_mark_node if
9185 different overloads deduce different arguments for a given parm.
9186 ADDR_P is true if the expression for which deduction is being
9187 performed was of the form "& fn" rather than simply "fn".
9189 Returns 1 on success. */
9191 static int
9193 tree orig_targs,
9194 tree targs,
9195 tree parm,
9196 tree arg,
9197 unification_kind_t strict,
9200 {
9202 tree tempargs;
9205 /* [temp.deduct.type] A template-argument can be deduced from a pointer
9206 to function or pointer to member function argument if the set of
9207 overloaded functions does not contain function templates and at most
9208 one of a set of overloaded functions provides a unique match.
9210 So if this is a template, just return success. */
9222 /* We don't copy orig_targs for this because if we have already deduced
9223 some template args from previous args, unify would complain when we
9224 try to deduce a template parameter for the same argument, even though
9225 there isn't really a conflict. */
9232 /* First make sure we didn't deduce anything that conflicts with
9233 explicitly specified args. */
9235 {
9242 {
9243 /* Since we're unifying against ourselves, we will fill in template
9244 args used in the function parm list with our own template parms.
9245 Discard them. */
9248 }
9251 }
9254 {
9259 }
9262 }
9264 /* Verify that nondeduce template argument agrees with the type
9265 obtained from argument deduction. Return nonzero if the
9266 verification fails.
9268 For example:
9270 struct A { typedef int X; };
9271 template <class T, class U> struct C {};
9272 template <class T> struct C<T, typename T::X> {};
9274 Then with the instantiation `C<A, int>', we can deduce that
9275 `T' is `A' but unify () does not check whether `typename T::X'
9276 is `int'. This function ensure that they agree.
9278 TARGS, PARMS are the same as the arguments of unify.
9279 ARGS contains template arguments from all levels. */
9281 static int
9283 {
9290 }
9292 /* PARM is a template class (perhaps with unbound template
9293 parameters). ARG is a fully instantiated type. If ARG can be
9294 bound to PARM, return ARG, otherwise return NULL_TREE. TPARMS and
9295 TARGS are as for unify. */
9297 static tree
9299 {
9300 tree copy_of_targs;
9307 /* We need to make a new template argument vector for the call to
9308 unify. If we used TARGS, we'd clutter it up with the result of
9309 the attempted unification, even if this class didn't work out.
9310 We also don't want to commit ourselves to all the unifications
9311 we've already done, since unification is supposed to be done on
9312 an argument-by-argument basis. In other words, consider the
9313 following pathological case:
9315 template <int I, int J, int K>
9316 struct S {};
9318 template <int I, int J>
9319 struct S<I, J, 2> : public S<I, I, I>, S<J, J, J> {};
9321 template <int I, int J, int K>
9322 void f(S<I, J, K>, S<I, I, I>);
9324 void g() {
9325 S<0, 0, 0> s0;
9326 S<0, 1, 2> s2;
9328 f(s0, s2);
9329 }
9331 Now, by the time we consider the unification involving `s2', we
9332 already know that we must have `f<0, 0, 0>'. But, even though
9333 `S<0, 1, 2>' is derived from `S<0, 0, 0>', the code is invalid
9334 because there are two ways to unify base classes of S<0, 1, 2>
9335 with S<I, I, I>. If we kept the already deduced knowledge, we
9336 would reject the possibility I=1. */
9339 /* If unification failed, we're done. */
9345 }
9347 /* Subroutine of get_template_base. RVAL, if non-NULL, is a base we
9348 have already discovered to be satisfactory. ARG_BINFO is the binfo
9349 for the base class of ARG that we are currently examining. */
9351 static tree
9353 tree targs,
9354 tree parm,
9355 tree arg_binfo,
9356 tree rval,
9358 {
9359 tree binfos;
9364 {
9368 /* If there is more than one satisfactory baseclass, then:
9370 [temp.deduct.call]
9372 If they yield more than one possible deduced A, the type
9373 deduction fails.
9375 applies. */
9380 }
9385 /* Process base types. */
9387 {
9391 /* Skip this base, if we've already seen it. */
9395 this_virtual =
9398 /* When searching for a non-virtual, we cannot mark virtually
9399 found binfos. */
9404 parm,
9405 base_binfo,
9406 rval,
9409 /* If we discovered more than one matching base class, we can
9410 stop now. */
9413 }
9416 }
9418 /* Given a template type PARM and a class type ARG, find the unique
9419 base type in ARG that is an instance of PARM. We do not examine
9420 ARG itself; only its base-classes. If there is no appropriate base
9421 class, return NULL_TREE. If there is more than one, return
9422 error_mark_node. PARM may be the type of a partial specialization,
9423 as well as a plain template type. Used by unify. */
9425 static tree
9427 {
9428 tree rval;
9429 tree arg_binfo;
9436 NULL_TREE,
9437 GTB_IGNORE_TYPE);
9439 /* Since get_template_base_recursive marks the bases classes, we
9440 must unmark them here. */
9444 }
9446 /* Returns the level of DECL, which declares a template parameter. */
9448 static int
9450 {
9452 {
9463 }
9464 }
9466 /* Decide whether ARG can be unified with PARM, considering only the
9467 cv-qualifiers of each type, given STRICT as documented for unify.
9468 Returns nonzero iff the unification is OK on that basis.*/
9470 static int
9472 {
9477 {
9478 /* If the cvr quals of parm will not unify with ARG, they'll be
9479 ignored in instantiation, so we have to do the same here. */
9485 }
9496 }
9498 /* Takes parameters as for type_unification. Returns 0 if the
9499 type deduction succeeds, 1 otherwise. The parameter STRICT is a
9500 bitwise or of the following flags:
9502 UNIFY_ALLOW_NONE:
9503 Require an exact match between PARM and ARG.
9504 UNIFY_ALLOW_MORE_CV_QUAL:
9505 Allow the deduced ARG to be more cv-qualified (by qualification
9506 conversion) than ARG.
9507 UNIFY_ALLOW_LESS_CV_QUAL:
9508 Allow the deduced ARG to be less cv-qualified than ARG.
9509 UNIFY_ALLOW_DERIVED:
9510 Allow the deduced ARG to be a template base class of ARG,
9511 or a pointer to a template base class of the type pointed to by
9512 ARG.
9513 UNIFY_ALLOW_INTEGER:
9514 Allow any integral type to be deduced. See the TEMPLATE_PARM_INDEX
9515 case for more information.
9516 UNIFY_ALLOW_OUTER_LEVEL:
9517 This is the outermost level of a deduction. Used to determine validity
9518 of qualification conversions. A valid qualification conversion must
9519 have const qualified pointers leading up to the inner type which
9520 requires additional CV quals, except at the outer level, where const
9521 is not required [conv.qual]. It would be normal to set this flag in
9522 addition to setting UNIFY_ALLOW_MORE_CV_QUAL.
9523 UNIFY_ALLOW_OUTER_MORE_CV_QUAL:
9524 This is the outermost level of a deduction, and PARM can be more CV
9525 qualified at this point.
9526 UNIFY_ALLOW_OUTER_LESS_CV_QUAL:
9527 This is the outermost level of a deduction, and PARM can be less CV
9528 qualified at this point.
9529 UNIFY_ALLOW_MAX_CORRECTION:
9530 This is an INTEGER_TYPE's maximum value. Used if the range may
9531 have been derived from a size specification, such as an array size.
9532 If the size was given by a nontype template parameter N, the maximum
9533 value will have the form N-1. The flag says that we can (and indeed
9534 must) unify N with (ARG + 1), an exception to the normal rules on
9535 folding PARM. */
9537 static int
9539 {
9541 tree targ;
9542 tree tparm;
9545 /* I don't think this will do the right thing with respect to types.
9546 But the only case I've seen it in so far has been array bounds, where
9547 signedness is the only information lost, and I think that will be
9548 okay. */
9555 /* We can't deduce anything from this, but we might get all the
9556 template args from other function args. */
9559 /* If PARM uses template parameters, then we can't bail out here,
9560 even if ARG == PARM, since we won't record unifications for the
9561 template parameters. We might need them if we're trying to
9562 figure out which of two things is more specialized. */
9566 /* Immediately reject some pairs that won't unify because of
9567 cv-qualification mismatches. */
9570 /* It is the elements of the array which hold the cv quals of an array
9571 type, and the elements might be template type parms. We'll check
9572 when we recurse. */
9574 /* We check the cv-qualifiers when unifying with template type
9575 parameters below. We want to allow ARG `const T' to unify with
9576 PARM `T' for example, when computing which of two templates
9577 is more specialized, for example. */
9592 {
9596 /* In a type which contains a nested-name-specifier, template
9597 argument values cannot be deduced for template parameters used
9598 within the nested-name-specifier. */
9608 /* The PARM is not one we're trying to unify. Just check
9609 to see if it matches ARG. */
9616 /* Check for mixed types and values. */
9624 {
9625 /* ARG must be constructed from a template class or a template
9626 template parameter. */
9631 {
9635 tree argtmplvec
9639 /* The parameter and argument roles have to be switched here
9640 in order to handle default arguments properly. For example,
9641 template<template <class> class TT> void f(TT<int>)
9642 should be able to accept vector<int> which comes from
9643 template <class T, class Allocator = allocator>
9644 class vector. */
9650 /* Deduce arguments T, i from TT<T> or TT<i>.
9651 We check each element of PARMVEC and ARGVEC individually
9652 rather than the whole TREE_VEC since they can have
9653 different number of elements. */
9656 {
9661 UNIFY_ALLOW_NONE))
9663 }
9664 }
9667 /* Fall through to deduce template name. */
9668 }
9672 {
9673 /* Deduce template name TT from TT, TT<>, TT<T> and TT<i>. */
9675 /* Simple cases: Value already set, does match or doesn't. */
9680 }
9681 else
9682 {
9683 /* If PARM is `const T' and ARG is only `int', we don't have
9684 a match unless we are allowing additional qualification.
9685 If ARG is `const int' and PARM is just `T' that's OK;
9686 that binds `const int' to `T'. */
9691 /* Consider the case where ARG is `const volatile int' and
9692 PARM is `const T'. Then, T should be `volatile int'. */
9693 arg = cp_build_qualified_type_real
9698 /* Simple cases: Value already set, does match or doesn't. */
9704 /* Make sure that ARG is not a variable-sized array. (Note
9705 that were talking about variable-sized arrays (like
9706 `int[n]'), rather than arrays of unknown size (like
9707 `int[]').) We'll get very confused by such a type since
9708 the bound of the array will not be computable in an
9709 instantiation. Besides, such types are not allowed in
9710 ISO C++, so we can do as we please here. */
9713 }
9723 /* The PARM is not one we're trying to unify. Just check
9724 to see if it matches ARG. */
9734 /* [temp.deduct.type] If, in the declaration of a function template
9735 with a non-type template-parameter, the non-type
9736 template-parameter is used in an expression in the function
9737 parameter-list and, if the corresponding template-argument is
9738 deduced, the template-argument type shall match the type of the
9739 template-parameter exactly, except that a template-argument
9740 deduced from an array bound may be of any integral type.
9741 The non-type parameter might use already deduced type parameters. */
9744 /* Template-parameter dependent expression. Just accept it for now.
9745 It will later be processed in convert_template_argument. */
9746 ;
9754 /* We haven't deduced the type of this parameter yet. Try again
9755 later. */
9757 else
9764 {
9765 /* A pointer-to-member constant can be unified only with
9766 another constant. */
9770 /* Just unify the class member. It would be useless (and possibly
9771 wrong, depending on the strict flags) to unify also
9772 PTRMEM_CST_CLASS, because we want to be sure that both parm and
9773 arg refer to the same variable, even if through different
9774 classes. For instance:
9776 struct A { int x; };
9777 struct B : A { };
9779 Unification of &A::x and &B::x must succeed. */
9782 }
9785 {
9789 /* [temp.deduct.call]
9791 A can be another pointer or pointer to member type that can
9792 be converted to the deduced A via a qualification
9793 conversion (_conv.qual_).
9795 We pass down STRICT here rather than UNIFY_ALLOW_NONE.
9796 This will allow for additional cv-qualification of the
9797 pointed-to types if appropriate. */
9800 /* The derived-to-base conversion only persists through one
9801 level of pointers. */
9806 }
9838 {
9848 }
9849 /* We have already checked cv-qualification at the top of the
9850 function. */
9854 /* As far as unification is concerned, this wins. Later checks
9855 will invalidate it if necessary. */
9858 /* Types INTEGER_CST and MINUS_EXPR can come from array bounds. */
9859 /* Type INTEGER_CST can come from ordinary constant template args. */
9869 {
9878 UNIFY_ALLOW_NONE))
9881 }
9889 {
9896 strict);
9897 }
9900 {
9904 {
9905 /* First, we try to unify the PARM and ARG directly. */
9910 {
9911 /* Fallback to the special case allowed in
9912 [temp.deduct.call]:
9914 If P is a class, and P has the form
9915 template-id, then A can be a derived class of
9916 the deduced A. Likewise, if P is a pointer to
9917 a class of the form template-id, A can be a
9918 pointer to a derived class pointed to by the
9919 deduced A. */
9925 }
9926 }
9930 /* Perhaps PARM is something like S<U> and ARG is S<int>.
9931 Then, we should unify `int' and `U'. */
9933 else
9934 /* There's no chance of unification succeeding. */
9939 }
9963 strict);
9974 /* Matched cases are handled by the ARG == PARM test above. */
9980 {
9981 /* We handle this case specially, since it comes up with
9982 arrays. In particular, something like:
9984 template <int N> void f(int (&x)[N]);
9986 Here, we are trying to unify the range type, which
9987 looks like [0 ... (N - 1)]. */
9995 }
9996 /* else fall through */
10000 {
10002 /* We're looking at an expression. This can happen with
10003 something like:
10005 template <int I>
10006 void foo(S<I>, S<I + 2>);
10008 This is a "nondeduced context":
10010 [deduct.type]
10012 The nondeduced contexts are:
10014 --A type that is a template-id in which one or more of
10015 the template-arguments is an expression that references
10016 a template-parameter.
10018 In these cases, we assume deduction succeeded, but don't
10019 actually infer any unifications. */
10024 else
10026 }
10027 else
10032 }
10033 }
10034 \f
10035 /* Called if RESULT is explicitly instantiated, or is a member of an
10036 explicitly instantiated class, or if using -frepo and the
10037 instantiation of RESULT has been assigned to this file. */
10039 void
10041 {
10042 /* We used to set this unconditionally; we moved that to
10043 do_decl_instantiation so it wouldn't get set on members of
10044 explicit class template instantiations. But we still need to set
10045 it here for the 'extern template' case in order to suppress
10046 implicit instantiations. */
10050 /* If this entity has already been written out, it's too late to
10051 make any modifications. */
10056 /* The TREE_PUBLIC flag for function declarations will have been
10057 set correctly by tsubst. */
10060 /* This might have been set by an earlier implicit instantiation. */
10064 {
10068 /* Always make artificials weak. */
10071 /* For WIN32 we also want to put explicit instantiations in
10072 linkonce sections. */
10075 }
10079 }
10081 /* Given two function templates PAT1 and PAT2, return:
10083 DEDUCE should be DEDUCE_EXACT or DEDUCE_ORDER.
10085 1 if PAT1 is more specialized than PAT2 as described in [temp.func.order].
10086 -1 if PAT2 is more specialized than PAT1.
10087 0 if neither is more specialized.
10089 LEN is passed through to fn_type_unification. */
10091 int
10093 {
10094 tree targs;
10097 /* If template argument deduction succeeds, we substitute the
10098 resulting arguments into non-deduced contexts. While doing that,
10099 we must be aware that we may encounter dependent types. */
10113 }
10115 /* Given two class template specialization list nodes PAT1 and PAT2, return:
10117 1 if PAT1 is more specialized than PAT2 as described in [temp.class.order].
10118 -1 if PAT2 is more specialized than PAT1.
10119 0 if neither is more specialized.
10121 FULL_ARGS is the full set of template arguments that triggers this
10122 partial ordering. */
10124 int
10126 {
10127 tree targs;
10141 }
10143 /* Return the template arguments that will produce the function signature
10144 DECL from the function template FN, with the explicit template
10145 arguments EXPLICIT_ARGS. If CHECK_RETTYPE is 1, the return type must
10146 also match. Return NULL_TREE if no satisfactory arguments could be
10147 found. DEDUCE and LEN are passed through to fn_type_unification. */
10149 static tree
10151 tree decl,
10152 tree explicit_args,
10156 {
10159 tree decl_type;
10160 tree decl_arg_types;
10163 /* Substitute the explicit template arguments into the type of DECL.
10164 The call to fn_type_unification will handle substitution into the
10165 FN. */
10168 {
10169 tree tmpl;
10170 tree converted_args;
10174 else
10175 /* We can get here for some invalid specializations. */
10178 converted_args
10188 }
10191 /* Never do unification on the 'this' parameter. */
10196 decl_arg_types,
10205 }
10207 /* For most uses, we want to check the return type. */
10209 static tree
10211 {
10213 }
10215 /* But for resolve_overloaded_unification, we only care about the parameter
10216 types. */
10218 static tree
10220 {
10222 }
10224 /* Return the innermost template arguments that, when applied to a
10225 template specialization whose innermost template parameters are
10226 TPARMS, and whose specialization arguments are PARMS, yield the
10227 ARGS.
10229 For example, suppose we have:
10231 template <class T, class U> struct S {};
10232 template <class T> struct S<T*, int> {};
10234 Then, suppose we want to get `S<double*, int>'. The TPARMS will be
10235 {T}, the PARMS will be {T*, int} and the ARGS will be {double*,
10236 int}. The resulting vector will be {double}, indicating that `T'
10237 is bound to `double'. */
10239 static tree
10241 {
10246 UNIFY_ALLOW_NONE))
10257 }
10259 /* In INSTANTIATIONS is a list of <INSTANTIATION, TEMPLATE> pairs.
10260 Pick the most specialized template, and return the corresponding
10261 instantiation, or if there is no corresponding instantiation, the
10262 template itself. If there is no most specialized template,
10263 error_mark_node is returned. If there are no templates at all,
10264 NULL_TREE is returned. */
10266 tree
10268 {
10277 {
10281 ;
10282 else
10283 {
10285 {
10289 }
10291 }
10292 }
10295 {
10300 }
10303 }
10305 /* Return the most specialized of the list of templates in FNS that can
10306 produce an instantiation matching DECL, given the explicit template
10307 arguments EXPLICIT_ARGS. */
10309 static tree
10311 {
10316 {
10322 }
10325 }
10327 /* If DECL is a specialization of some template, return the most
10328 general such template. Otherwise, returns NULL_TREE.
10330 For example, given:
10332 template <class T> struct S { template <class U> void f(U); };
10334 if TMPL is `template <class U> void S<int>::f(U)' this will return
10335 the full template. This function will not trace past partial
10336 specializations, however. For example, given in addition:
10338 template <class T> struct S<T*> { template <class U> void f(U); };
10340 if TMPL is `template <class U> void S<int*>::f(U)' this will return
10341 `template <class T> template <class U> S<T*>::f(U)'. */
10343 tree
10345 {
10346 /* If DECL is a FUNCTION_DECL, find the TEMPLATE_DECL of which it is
10347 an immediate specialization. */
10349 {
10353 /* The DECL_TI_TEMPLATE can be an IDENTIFIER_NODE for a
10354 template friend. */
10359 }
10361 /* Look for more and more general templates. */
10363 {
10364 /* The DECL_TI_TEMPLATE can be an IDENTIFIER_NODE in some cases.
10365 (See cp-tree.h for details.) */
10373 /* Stop if we run into an explicitly specialized class template. */
10380 }
10383 }
10385 /* Return the most specialized of the class template specializations
10386 of TMPL which can produce an instantiation matching ARGS, or
10387 error_mark_node if the choice is ambiguous. */
10389 static tree
10391 {
10393 tree t;
10394 tree champ;
10399 {
10400 tree spec_args
10403 {
10406 }
10407 }
10416 {
10419 ;
10420 else
10421 {
10423 {
10427 }
10429 }
10430 }
10433 {
10437 }
10440 }
10442 /* Explicitly instantiate DECL. */
10444 void
10446 {
10451 /* An error occurred, for which grokdeclarator has already issued
10452 an appropriate message. */
10455 {
10458 }
10460 {
10461 /* There is an asymmetry here in the way VAR_DECLs and
10462 FUNCTION_DECLs are handled by grokdeclarator. In the case of
10463 the latter, the DECL we get back will be marked as a
10464 template instantiation, and the appropriate
10465 DECL_TEMPLATE_INFO will be set up. This does not happen for
10466 VAR_DECLs so we do the lookup here. Probably, grokdeclarator
10467 should handle VAR_DECLs as it currently handles
10468 FUNCTION_DECLs. */
10471 {
10474 }
10475 }
10477 {
10480 }
10481 else
10484 /* Check for various error cases. Note that if the explicit
10485 instantiation is valid the RESULT will currently be marked as an
10486 *implicit* instantiation; DECL_EXPLICIT_INSTANTIATION is not set
10487 until we get here. */
10490 {
10491 /* DR 259 [temp.spec].
10493 Both an explicit instantiation and a declaration of an explicit
10494 specialization shall not appear in a program unless the explicit
10495 instantiation follows a declaration of the explicit specialization.
10497 For a given set of template parameters, if an explicit
10498 instantiation of a template appears after a declaration of an
10499 explicit specialization for that template, the explicit
10500 instantiation has no effect. */
10502 }
10504 {
10505 /* [temp.spec]
10507 No program shall explicitly instantiate any template more
10508 than once.
10510 We check DECL_INTERFACE_KNOWN so as not to complain when the first
10511 instantiation was `extern' and the second is not, and EXTERN_P for
10512 the opposite case. If -frepo, chances are we already got marked
10513 as an explicit instantiation because of the repo file. */
10517 /* If we've already instantiated the template, just return now. */
10520 }
10522 {
10525 }
10527 {
10530 }
10536 ;
10538 {
10542 }
10543 else
10545 storage);
10552 }
10554 void
10556 {
10562 {
10565 }
10566 }
10568 /* Called from do_type_instantiation through binding_table_foreach to
10569 do recursive instantiation for the type bound in ENTRY. */
10570 static void
10572 {
10578 }
10580 /* Perform an explicit instantiation of template class T. STORAGE, if
10581 non-null, is the RID for extern, inline or static. COMPLAIN is
10582 nonzero if this is called from the parser, zero if called recursively,
10583 since the standard is unclear (as detailed below). */
10585 void
10587 {
10596 {
10599 }
10603 /* With -fexternal-templates, explicit instantiations are treated the same
10604 as implicit ones. */
10609 {
10612 t);
10614 }
10617 {
10628 else
10629 {
10631 storage);
10633 }
10634 }
10637 {
10638 /* DR 259 [temp.spec].
10640 Both an explicit instantiation and a declaration of an explicit
10641 specialization shall not appear in a program unless the explicit
10642 instantiation follows a declaration of the explicit specialization.
10644 For a given set of template parameters, if an explicit
10645 instantiation of a template appears after a declaration of an
10646 explicit specialization for that template, the explicit
10647 instantiation has no effect. */
10649 }
10651 {
10652 /* [temp.spec]
10654 No program shall explicitly instantiate any template more
10655 than once.
10657 If CLASSTYPE_INTERFACE_ONLY, then the first explicit instantiation
10658 was `extern'. If EXTERN_P then the second is. If -frepo, chances
10659 are we already got marked as an explicit instantiation because of the
10660 repo file. All these cases are OK. */
10665 /* If we've already instantiated the template, just return now. */
10668 }
10676 {
10677 tree tmp;
10679 /* In contrast to implicit instantiation, where only the
10680 declarations, and not the definitions, of members are
10681 instantiated, we have here:
10683 [temp.explicit]
10685 The explicit instantiation of a class template specialization
10686 implies the instantiation of all of its members not
10687 previously explicitly specialized in the translation unit
10688 containing the explicit instantiation.
10690 Of course, we can't instantiate member template classes, since
10691 we don't have any arguments for them. Note that the standard
10692 is unclear on whether the instantiation of the members are
10693 *explicit* instantiations or not. We choose to be generous,
10694 and not set DECL_EXPLICIT_INSTANTIATION. Therefore, we allow
10695 the explicit instantiation of a class where some of the members
10696 have no definition in the current translation unit. */
10702 {
10707 }
10711 {
10716 }
10721 }
10722 }
10724 /* Given a function DECL, which is a specialization of TMPL, modify
10725 DECL to be a re-instantiation of TMPL with the same template
10726 arguments. TMPL should be the template into which tsubst'ing
10727 should occur for DECL, not the most general template.
10729 One reason for doing this is a scenario like this:
10731 template <class T>
10732 void f(const T&, int i);
10734 void g() { f(3, 7); }
10736 template <class T>
10737 void f(const T& t, const int i) { }
10739 Note that when the template is first instantiated, with
10740 instantiate_template, the resulting DECL will have no name for the
10741 first parameter, and the wrong type for the second. So, when we go
10742 to instantiate the DECL, we regenerate it. */
10744 static void
10746 {
10747 /* The most general version of TMPL. */
10748 tree gen_tmpl;
10749 /* The arguments used to instantiate DECL, from the most general
10750 template. */
10751 tree args;
10752 tree code_pattern;
10753 tree new_decl;
10759 /* Unregister the specialization so that when we tsubst we will not
10760 just return DECL. We don't have to unregister DECL from TMPL
10761 because if would only be registered there if it were a partial
10762 instantiation of a specialization, which it isn't: it's a full
10763 instantiation. */
10768 /* If the DECL was not unregistered then something peculiar is
10769 happening: we created a specialization but did not call
10770 register_specialization for it. */
10773 /* Make sure that we can see identifiers, and compute access
10774 correctly. */
10777 /* Do the substitution to get the new declaration. */
10781 {
10782 /* Set up DECL_INITIAL, since tsubst doesn't. */
10787 }
10789 {
10790 /* Convince duplicate_decls to use the DECL_ARGUMENTS from the
10791 new decl. */
10793 /* And don't complain about a duplicate definition. */
10795 }
10799 /* The immediate parent of the new template is still whatever it was
10800 before, even though tsubst sets DECL_TI_TEMPLATE up as the most
10801 general template. We also reset the DECL_ASSEMBLER_NAME since
10802 tsubst always calculates the name as if the function in question
10803 were really a template instance, and sometimes, with friend
10804 functions, this is not so. See tsubst_friend_function for
10805 details. */
10811 /* Call duplicate decls to merge the old and new declarations. */
10814 /* Now, re-register the specialization. */
10816 }
10818 /* Return the TEMPLATE_DECL into which DECL_TI_ARGS(DECL) should be
10819 substituted to get DECL. */
10821 tree
10823 {
10826 /* Set TMPL to the template whose DECL_TEMPLATE_RESULT is the pattern
10827 for the instantiation. This is not always the most general
10828 template. Consider, for example:
10830 template <class T>
10831 struct S { template <class U> void f();
10832 template <> void f<int>(); };
10834 and an instantiation of S<double>::f<int>. We want TD to be the
10835 specialization S<T>::f<int>, not the more general S<T>::f<U>. */
10837 more general template. */
10839 /* We must also deal with friend templates. Given:
10841 template <class T> struct S {
10842 template <class U> friend void f() {};
10843 };
10845 S<int>::f<U> say, is not an instantiation of S<T>::f<U>,
10846 so far as the language is concerned, but that's still
10847 where we get the pattern for the instantiation from. On
10848 other hand, if the definition comes outside the class, say:
10850 template <class T> struct S {
10851 template <class U> friend void f();
10852 };
10853 template <class U> friend void f() {}
10855 we don't need to look any further. That's what the check for
10856 DECL_INITIAL is for. */
10860 {
10861 /* The present template, TD, should not be a definition. If it
10862 were a definition, we should be using it! Note that we
10863 cannot restructure the loop to just keep going until we find
10864 a template with a definition, since that might go too far if
10865 a specialization was declared, but not defined. */
10870 /* Fetch the more general template. */
10872 }
10875 }
10877 /* Produce the definition of D, a _DECL generated from a template. If
10878 DEFER_OK is nonzero, then we don't have to actually do the
10879 instantiation now; we just have to do it sometime. */
10881 tree
10883 {
10885 tree gen_args;
10886 tree args;
10887 tree td;
10888 tree code_pattern;
10889 tree spec;
10890 tree gen_tmpl;
10895 /* This function should only be used to instantiate templates for
10896 functions and static member variables. */
10900 /* Variables are never deferred; if instantiation is required, they
10901 are instantiated right away. That allows for better code in the
10902 case that an expression refers to the value of the variable --
10903 if the variable has a constant value the referring expression can
10904 take advantage of that fact. */
10908 /* Don't instantiate cloned functions. Instead, instantiate the
10909 functions they cloned. */
10914 /* D has already been instantiated. It might seem reasonable to
10915 check whether or not D is an explicit instantiation, and, if so,
10916 stop here. But when an explicit instantiation is deferred
10917 until the end of the compilation, DECL_EXPLICIT_INSTANTIATION
10918 is set, even though we still need to do the instantiation. */
10921 /* If we already have a specialization of this declaration, then
10922 there's no reason to instantiate it. Note that
10923 retrieve_specialization gives us both instantiations and
10924 specializations, so we must explicitly check
10925 DECL_TEMPLATE_SPECIALIZATION. */
10932 /* This needs to happen before any tsubsting. */
10938 /* We may be in the middle of deferred access check. Disable it now. */
10941 /* Our caller does not expect collection to happen, which it might if
10942 we decide to compile the function to rtl now. Arrange for a new
10943 gc context to be created if so. */
10944 function_depth++;
10946 /* Set TD to the template whose DECL_TEMPLATE_RESULT is the pattern
10947 for the instantiation. */
10953 /* In the case of a friend template whose definition is provided
10954 outside the class, we may have too many arguments. Drop the
10955 ones we don't need. The same is true for specializations. */
10956 args = get_innermost_template_args
10958 else
10963 else
10969 {
10970 /* Let the repository code that this template definition is
10971 available.
10973 The repository doesn't need to know about cloned functions
10974 because they never actually show up in the object file. It
10975 does need to know about the clones; those are the symbols
10976 that the linker will be emitting error messages about. */
10979 {
10980 tree t;
10986 }
10987 else
10991 {
10993 {
10996 }
10998 {
11001 }
11002 else
11004 }
11008 }
11011 {
11012 /* Recheck the substitutions to obtain any warning messages
11013 about ignoring cv qualifiers. */
11017 /* Make sure that we can see identifiers, and compute access
11018 correctly. D is already the target FUNCTION_DECL with the
11019 right context. */
11023 {
11027 /* Don't simply tsubst the function type, as that will give
11028 duplicate warnings about poor parameter qualifications.
11029 The function arguments are the same as the decl_arguments
11030 without the top level cv qualifiers. */
11032 }
11036 }
11040 /* We should have set up DECL_INITIAL in instantiate_class_template. */
11042 /* Reject all external templates except inline functions. */
11048 /* Defer all other templates, unless we have been explicitly
11049 forbidden from doing so. We restore the source position here
11050 because it's used by add_pending_template. */
11052 {
11057 /* [temp.explicit]
11059 The definition of a non-exported function template, a
11060 non-exported member function template, or a non-exported
11061 member function or static data member of a class template
11062 shall be present in every translation unit in which it is
11063 explicitly instantiated. */
11064 pedwarn
11069 }
11075 /* Regenerate the declaration in case the template has been modified
11076 by a subsequent redeclaration. */
11079 /* We already set the file and line above. Reset them now in case
11080 they changed as a result of calling
11081 regenerate_decl_from_template. */
11085 {
11086 /* Clear out DECL_RTL; whatever was there before may not be right
11087 since we've reset the type of the declaration. */
11095 {
11096 /* The fact that this code is executing indicates that:
11098 (1) D is a template static data member, for which a
11099 definition is available.
11101 (2) An implicit or explicit instantiation has occurred.
11103 (3) We are not going to emit a definition of the static
11104 data member at this time.
11106 This situation is peculiar, but it occurs on platforms
11107 without weak symbols when performing an implicit
11108 instantiation. There, we cannot implicitly instantiate a
11109 defined static data member in more than one translation
11110 unit, so import_export_decl marks the declaration as
11111 external; we must rely on explicit instantiation. */
11112 }
11113 else
11114 {
11115 /* Mark D as instantiated so that recursive calls to
11116 instantiate_decl do not try to instantiate it again. */
11122 }
11123 }
11125 {
11126 htab_t saved_local_specializations;
11127 tree subst_decl;
11128 tree tmpl_parm;
11129 tree spec_parm;
11131 /* Mark D as instantiated so that recursive calls to
11132 instantiate_decl do not try to instantiate it again. */
11135 /* Save away the current list, in case we are instantiating one
11136 template from within the body of another. */
11139 /* Set up the list of local specializations. */
11141 hash_local_specialization,
11142 eq_local_specializations,
11143 NULL);
11145 /* Set up context. */
11149 /* Create substitution entries for the parameters. */
11154 {
11158 }
11160 {
11164 }
11167 /* Substitute into the body of the function. */
11171 /* We don't need the local specializations any more. */
11175 /* Finish the function. */
11178 }
11180 /* We're not deferring instantiation any more. */
11186 out:
11190 function_depth--;
11195 }
11197 /* Run through the list of templates that we wish we could
11198 instantiate, and instantiate any we can. */
11200 int
11202 {
11209 do
11210 {
11215 {
11221 {
11222 tree fn;
11225 {
11229 fn;
11234 {
11237 }
11238 }
11241 /* If INSTANTIATION has been instantiated, then we don't
11242 need to consider it again in the future. */
11244 else
11245 {
11248 }
11249 }
11250 else
11251 {
11254 {
11258 {
11261 }
11262 }
11266 /* If INSTANTIATION has been instantiated, then we don't
11267 need to consider it again in the future. */
11269 else
11270 {
11273 }
11274 }
11277 }
11279 }
11284 }
11286 /* Substitute ARGVEC into T, which is a list of initializers for
11287 either base class or a non-static data member. The TREE_PURPOSEs
11288 are DECLs, and the TREE_VALUEs are the initializer values. Used by
11289 instantiate_decl. */
11291 static tree
11293 {
11297 {
11298 tree decl;
11299 tree init;
11300 tree val;
11303 NULL_TREE);
11309 NULL_TREE);
11311 ;
11321 {
11325 }
11326 }
11328 }
11330 /* Set CURRENT_ACCESS_SPECIFIER based on the protection of DECL. */
11332 static void
11334 {
11339 else
11341 }
11343 /* Instantiate an enumerated type. TAG is the template type, NEWTAG
11344 is the instantiation (which should have been created with
11345 start_enum) and ARGS are the template arguments to use. */
11347 static void
11349 {
11350 tree e;
11353 {
11354 tree value;
11355 tree decl;
11358 /* Note that in a template enum, the TREE_VALUE is the
11359 CONST_DECL, not the corresponding INTEGER_CST. */
11362 NULL_TREE);
11364 /* Give this enumeration constant the correct access. */
11367 /* Actually build the enumerator itself. */
11369 }
11374 }
11376 /* DECL is a FUNCTION_DECL that is a template specialization. Return
11377 its type -- but without substituting the innermost set of template
11378 arguments. So, innermost set of template parameters will appear in
11379 the type. */
11381 tree
11383 {
11384 tree fn_type;
11385 tree tmpl;
11386 tree targs;
11387 tree tparms;
11395 /* There should be as many levels of arguments as there are levels
11396 of parameters. */
11402 /* No substitution is necessary. */
11403 ;
11404 else
11405 {
11407 tree partial_args;
11409 /* Replace the innermost level of the TARGS with NULL_TREEs to
11410 let tsubst know not to substitute for those parameters. */
11419 /* Make sure that we can see identifiers, and compute access
11420 correctly. We can just use the context of DECL for the
11421 partial substitution here. It depends only on outer template
11422 parameters, regardless of whether the innermost level is
11423 specialized or not. */
11427 /* Now, do the (partial) substitution to figure out the
11428 appropriate function type. */
11432 /* Substitute into the template parameters to obtain the real
11433 innermost set of parameters. This step is important if the
11434 innermost set of template parameters contains value
11435 parameters whose types depend on outer template parameters. */
11440 }
11443 }
11445 /* Return truthvalue if we're processing a template different from
11446 the last one involved in diagnostics. */
11447 int
11449 {
11451 }
11453 /* Remember current template involved in diagnostics. */
11454 void
11456 {
11458 }
11460 tree
11462 {
11464 }
11466 /* [temp.param] Check that template non-type parm TYPE is of an allowable
11467 type. Return zero for ok, nonzero for disallowed. Issue error and
11468 warning messages under control of COMPLAIN. */
11470 static int
11472 {
11486 type);
11488 }
11490 /* Returns TRUE if TYPE is dependent, in the sense of [temp.dep.type].
11491 Assumes that TYPE really is a type, and not the ERROR_MARK_NODE.*/
11493 static bool
11495 {
11496 tree scope;
11498 /* [temp.dep.type]
11500 A type is dependent if it is:
11502 -- a template parameter. */
11505 /* -- a qualified-id with a nested-name-specifier which contains a
11506 class-name that names a dependent type or whose unqualified-id
11507 names a dependent type. */
11510 /* -- a cv-qualified type where the cv-unqualified type is
11511 dependent. */
11513 /* -- a compound type constructed from any dependent type. */
11523 {
11524 tree arg_type;
11529 arg_type;
11534 }
11535 /* -- an array type constructed from any dependent type or whose
11536 size is specified by a constant expression that is
11537 value-dependent. */
11539 {
11541 && ((value_dependent_expression_p
11543 || (type_dependent_expression_p
11547 }
11549 /* -- a template-id in which either the template name is a template
11550 parameter ... */
11553 /* ... or any of the template arguments is a dependent type or
11554 an expression that is type-dependent or value-dependent. */
11556 && (any_dependent_template_arguments_p
11560 /* All TYPEOF_TYPEs are dependent; if the argument of the `typeof'
11561 expression is not type-dependent, then it should already been
11562 have resolved. */
11566 /* The standard does not specifically mention types that are local
11567 to template functions or local classes, but they should be
11568 considered dependent too. For example:
11570 template <int I> void f() {
11571 enum E { a = I };
11572 S<sizeof (E)> s;
11573 }
11575 The size of `E' cannot be known until the value of `I' has been
11576 determined. Therefore, `E' must be considered dependent. */
11583 /* Other types are non-dependent. */
11585 }
11587 /* Returns TRUE if TYPE is dependent, in the sense of
11588 [temp.dep.type]. */
11590 bool
11592 {
11593 /* If there are no template parameters in scope, then there can't be
11594 any dependent types. */
11598 /* If the type is NULL, we have not computed a type for the entity
11599 in question; in that case, the type is dependent. */
11603 /* Erroneous types can be considered non-dependent. */
11607 /* If we have not already computed the appropriate value for TYPE,
11608 do so now. */
11610 {
11613 }
11616 }
11618 /* Returns TRUE if EXPRESSION is dependent, according to CRITERION. */
11620 static bool
11622 {
11623 tree scope;
11624 tree name;
11634 /* [temp.dep.expr]
11636 An id-expression is type-dependent if it contains a
11637 nested-name-specifier that contains a class-name that names a
11638 dependent type. */
11639 /* The suggested resolution to Core Issue 2 implies that if the
11640 qualifying type is the current class, then we must peek
11641 inside it. */
11650 }
11652 /* Returns TRUE if the EXPRESSION is value-dependent, in the sense of
11653 [temp.dep.constexpr] */
11655 bool
11657 {
11661 /* A name declared with a dependent type. */
11666 /* A non-type template parameter. */
11671 /* A constant with integral or enumeration type and is initialized
11672 with an expression that is value-dependent. */
11678 /* These expressions are value-dependent if the type to which the
11679 cast occurs is dependent or the expression being casted is
11680 value-dependent. */
11686 {
11689 /* A functional cast has a list of operands. */
11692 {
11693 do
11694 {
11698 }
11701 }
11702 else
11704 }
11705 /* A `sizeof' expression is value-dependent if the operand is
11706 type-dependent. */
11709 {
11714 }
11720 /* A constant expression is value-dependent if any subexpression is
11721 value-dependent. */
11723 {
11725 {
11733 || (value_dependent_expression_p
11736 {
11739 /* In some cases, some of the operands may be missing.
11740 (For example, in the case of PREDECREMENT_EXPR, the
11741 amount to increment by may be missing.) That doesn't
11742 make the expression dependent. */
11744 && (value_dependent_expression_p
11748 }
11749 }
11750 }
11752 /* The expression is not value-dependent. */
11754 }
11756 /* Returns TRUE if the EXPRESSION is type-dependent, in the sense of
11757 [temp.dep.expr]. */
11759 bool
11761 {
11768 /* An unresolved name is always dependent. */
11772 /* Some expression forms are never type-dependent. */
11782 /* The types of these expressions depends only on the type to which
11783 the cast occurs. */
11791 /* The types of these expressions depends only on the type created
11792 by the expression. */
11795 {
11796 /* For NEW_EXPR tree nodes created inside a template, either
11797 the object type itself or a TREE_LIST may appear as the
11798 operand 1. */
11801 /* This is an array type. We need to check array dimensions
11802 as well. */
11804 || value_dependent_expression_p
11806 else
11808 }
11812 type_dependent_expression_p))
11818 && (any_dependent_template_arguments_p
11823 {
11827 {
11833 }
11838 {
11843 }
11845 {
11847 {
11851 }
11853 }
11855 }
11858 }
11860 /* Returns TRUE if ARGS (a TREE_LIST of arguments to a function call)
11861 contains a type-dependent expression. */
11863 bool
11865 {
11867 {
11873 }
11875 }
11877 /* Returns TRUE if the ARG (a template argument) is dependent. */
11879 static bool
11881 {
11890 else
11893 }
11895 /* Returns true if ARGS (a collection of template arguments) contains
11896 any dependent arguments. */
11898 bool
11900 {
11911 }
11913 /* Returns TRUE if the template TMPL is dependent. */
11915 bool
11917 {
11918 /* Template template parameters are dependent. */
11922 /* So are qualified names that have not been looked up. */
11925 /* So are member templates of dependent classes. */
11929 }
11931 /* Returns TRUE if the specialization TMPL<ARGS> is dependent. */
11933 bool
11935 {
11938 }
11940 /* TYPE is a TYPENAME_TYPE. Returns the ordinary TYPE to which the
11941 TYPENAME_TYPE corresponds. Returns ERROR_MARK_NODE if no such TYPE
11942 can be found. Note that this function peers inside uninstantiated
11943 templates and therefore should be used only in extremely limited
11944 situations. */
11946 tree
11948 {
11949 tree scope;
11950 tree name;
11951 tree decl;
11960 /* If the SCOPE is itself a TYPENAME_TYPE, then we need to resolve
11961 it first before we can figure out what NAME refers to. */
11964 /* If we don't know what SCOPE refers to, then we cannot resolve the
11965 TYPENAME_TYPE. */
11968 /* If the SCOPE is a template type parameter, we have no way of
11969 resolving the name. */
11972 /* If the SCOPE is not the current instantiation, there's no reason
11973 to look inside it. */
11976 /* If SCOPE is a partial instantiation, it will not have a valid
11977 TYPE_FIELDS list, so use the original template. */
11979 /* Enter the SCOPE so that name lookup will be resolved as if we
11980 were in the class definition. In particular, SCOPE will no
11981 longer be considered a dependent type. */
11983 /* Look up the declaration. */
11985 /* Obtain the set of qualifiers applied to the TYPE. */
11987 /* For a TYPENAME_TYPE like "typename X::template Y<T>", we want to
11988 find a TEMPLATE_DECL. Otherwise, we want to find a TYPE_DECL. */
11996 {
11997 tree tmpl;
11998 tree args;
11999 /* Obtain the template and the arguments. */
12002 /* Instantiate the template. */
12005 }
12006 else
12008 /* Qualify the resulting type. */
12011 /* Leave the SCOPE. */
12015 }
12017 /* EXPR is an expression which is not type-dependent. Return a proxy
12018 for EXPR that can be used to compute the types of larger
12019 expressions containing EXPR. */
12021 tree
12023 {
12024 /* Preserve null pointer constants so that the type of things like
12025 "p == 0" where "p" is a pointer can be determined. */
12028 /* Preserve OVERLOADs; the functions must be available to resolve
12029 types. */
12032 /* Preserve string constants; conversions from string constants to
12033 "char *" are allowed, even though normally a "const char *"
12034 cannot be used to initialize a "char *". */
12053 /* Otherwise, build a NON_DEPENDENT_EXPR.
12055 REFERENCE_TYPEs are not stripped for expressions in templates
12056 because doing so would play havoc with mangling. Consider, for
12057 example:
12059 template <typename T> void f<T& g>() { g(); }
12061 In the body of "f", the expression for "g" will have
12062 REFERENCE_TYPE, even though the standard says that it should
12063 not. The reason is that we must preserve the syntactic form of
12064 the expression so that mangling (say) "f<g>" inside the body of
12065 "f" works out correctly. Therefore, the REFERENCE_TYPE is
12066 stripped here. */
12068 }
12070 /* ARGS is a TREE_LIST of expressions as arguments to a function call.
12071 Return a new TREE_LIST with the various arguments replaced with
12072 equivalent non-dependent expressions. */
12074 tree
12076 {
12077 tree a;
12078 tree new_args;
12084 new_args);
12086 }