1 /* Maintain binary trees of symbols.
2 Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
4 Free Software Foundation, Inc.
5 Contributed by Andy Vaught
7 This file is part of GCC.
9 GCC is free software; you can redistribute it and/or modify it under
10 the terms of the GNU General Public License as published by the Free
11 Software Foundation; either version 3, or (at your option) any later
14 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
15 WARRANTY; without even the implied warranty of MERCHANTABILITY or
16 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19 You should have received a copy of the GNU General Public License
20 along with GCC; see the file COPYING3. If not see
21 <http://www.gnu.org/licenses/>. */
30 #include "constructor.h"
33 /* Strings for all symbol attributes. We use these for dumping the
34 parse tree, in error messages, and also when reading and writing
37 const mstring flavors[] =
39 minit ("UNKNOWN-FL", FL_UNKNOWN), minit ("PROGRAM", FL_PROGRAM),
40 minit ("BLOCK-DATA", FL_BLOCK_DATA), minit ("MODULE", FL_MODULE),
41 minit ("VARIABLE", FL_VARIABLE), minit ("PARAMETER", FL_PARAMETER),
42 minit ("LABEL", FL_LABEL), minit ("PROCEDURE", FL_PROCEDURE),
43 minit ("DERIVED", FL_DERIVED), minit ("NAMELIST", FL_NAMELIST),
47 const mstring procedures[] =
49 minit ("UNKNOWN-PROC", PROC_UNKNOWN),
50 minit ("MODULE-PROC", PROC_MODULE),
51 minit ("INTERNAL-PROC", PROC_INTERNAL),
52 minit ("DUMMY-PROC", PROC_DUMMY),
53 minit ("INTRINSIC-PROC", PROC_INTRINSIC),
54 minit ("EXTERNAL-PROC", PROC_EXTERNAL),
55 minit ("STATEMENT-PROC", PROC_ST_FUNCTION),
59 const mstring intents[] =
61 minit ("UNKNOWN-INTENT", INTENT_UNKNOWN),
62 minit ("IN", INTENT_IN),
63 minit ("OUT", INTENT_OUT),
64 minit ("INOUT", INTENT_INOUT),
68 const mstring access_types[] =
70 minit ("UNKNOWN-ACCESS", ACCESS_UNKNOWN),
71 minit ("PUBLIC", ACCESS_PUBLIC),
72 minit ("PRIVATE", ACCESS_PRIVATE),
76 const mstring ifsrc_types[] =
78 minit ("UNKNOWN", IFSRC_UNKNOWN),
79 minit ("DECL", IFSRC_DECL),
80 minit ("BODY", IFSRC_IFBODY)
83 const mstring save_status[] =
85 minit ("UNKNOWN", SAVE_NONE),
86 minit ("EXPLICIT-SAVE", SAVE_EXPLICIT),
87 minit ("IMPLICIT-SAVE", SAVE_IMPLICIT),
90 /* This is to make sure the backend generates setup code in the correct
93 static int next_dummy_order = 1;
96 gfc_namespace *gfc_current_ns;
97 gfc_namespace *gfc_global_ns_list;
99 gfc_gsymbol *gfc_gsym_root = NULL;
101 static gfc_symbol *changed_syms = NULL;
103 gfc_dt_list *gfc_derived_types;
106 /* List of tentative typebound-procedures. */
108 typedef struct tentative_tbp
110 gfc_typebound_proc *proc;
111 struct tentative_tbp *next;
115 static tentative_tbp *tentative_tbp_list = NULL;
118 /*********** IMPLICIT NONE and IMPLICIT statement handlers ***********/
120 /* The following static variable indicates whether a particular element has
121 been explicitly set or not. */
123 static int new_flag[GFC_LETTERS];
126 /* Handle a correctly parsed IMPLICIT NONE. */
129 gfc_set_implicit_none (void)
133 if (gfc_current_ns->seen_implicit_none)
135 gfc_error ("Duplicate IMPLICIT NONE statement at %C");
139 gfc_current_ns->seen_implicit_none = 1;
141 for (i = 0; i < GFC_LETTERS; i++)
143 gfc_clear_ts (&gfc_current_ns->default_type[i]);
144 gfc_current_ns->set_flag[i] = 1;
149 /* Reset the implicit range flags. */
152 gfc_clear_new_implicit (void)
156 for (i = 0; i < GFC_LETTERS; i++)
161 /* Prepare for a new implicit range. Sets flags in new_flag[]. */
164 gfc_add_new_implicit_range (int c1, int c2)
171 for (i = c1; i <= c2; i++)
175 gfc_error ("Letter '%c' already set in IMPLICIT statement at %C",
187 /* Add a matched implicit range for gfc_set_implicit(). Check if merging
188 the new implicit types back into the existing types will work. */
191 gfc_merge_new_implicit (gfc_typespec *ts)
195 if (gfc_current_ns->seen_implicit_none)
197 gfc_error ("Cannot specify IMPLICIT at %C after IMPLICIT NONE");
201 for (i = 0; i < GFC_LETTERS; i++)
205 if (gfc_current_ns->set_flag[i])
207 gfc_error ("Letter %c already has an IMPLICIT type at %C",
212 gfc_current_ns->default_type[i] = *ts;
213 gfc_current_ns->implicit_loc[i] = gfc_current_locus;
214 gfc_current_ns->set_flag[i] = 1;
221 /* Given a symbol, return a pointer to the typespec for its default type. */
224 gfc_get_default_type (const char *name, gfc_namespace *ns)
230 if (gfc_option.flag_allow_leading_underscore && letter == '_')
231 gfc_internal_error ("Option -fallow-leading-underscore is for use only by "
232 "gfortran developers, and should not be used for "
233 "implicitly typed variables");
235 if (letter < 'a' || letter > 'z')
236 gfc_internal_error ("gfc_get_default_type(): Bad symbol '%s'", name);
241 return &ns->default_type[letter - 'a'];
245 /* Given a pointer to a symbol, set its type according to the first
246 letter of its name. Fails if the letter in question has no default
250 gfc_set_default_type (gfc_symbol *sym, int error_flag, gfc_namespace *ns)
254 if (sym->ts.type != BT_UNKNOWN)
255 gfc_internal_error ("gfc_set_default_type(): symbol already has a type");
257 ts = gfc_get_default_type (sym->name, ns);
259 if (ts->type == BT_UNKNOWN)
261 if (error_flag && !sym->attr.untyped)
263 gfc_error ("Symbol '%s' at %L has no IMPLICIT type",
264 sym->name, &sym->declared_at);
265 sym->attr.untyped = 1; /* Ensure we only give an error once. */
272 sym->attr.implicit_type = 1;
274 if (ts->type == BT_CHARACTER && ts->u.cl)
275 sym->ts.u.cl = gfc_new_charlen (sym->ns, ts->u.cl);
277 if (sym->attr.is_bind_c == 1)
279 /* BIND(C) variables should not be implicitly declared. */
280 gfc_warning_now ("Implicitly declared BIND(C) variable '%s' at %L may "
281 "not be C interoperable", sym->name, &sym->declared_at);
282 sym->ts.f90_type = sym->ts.type;
285 if (sym->attr.dummy != 0)
287 if (sym->ns->proc_name != NULL
288 && (sym->ns->proc_name->attr.subroutine != 0
289 || sym->ns->proc_name->attr.function != 0)
290 && sym->ns->proc_name->attr.is_bind_c != 0)
292 /* Dummy args to a BIND(C) routine may not be interoperable if
293 they are implicitly typed. */
294 gfc_warning_now ("Implicitly declared variable '%s' at %L may not "
295 "be C interoperable but it is a dummy argument to "
296 "the BIND(C) procedure '%s' at %L", sym->name,
297 &(sym->declared_at), sym->ns->proc_name->name,
298 &(sym->ns->proc_name->declared_at));
299 sym->ts.f90_type = sym->ts.type;
307 /* This function is called from parse.c(parse_progunit) to check the
308 type of the function is not implicitly typed in the host namespace
309 and to implicitly type the function result, if necessary. */
312 gfc_check_function_type (gfc_namespace *ns)
314 gfc_symbol *proc = ns->proc_name;
316 if (!proc->attr.contained || proc->result->attr.implicit_type)
319 if (proc->result->ts.type == BT_UNKNOWN && proc->result->ts.interface == NULL)
321 if (gfc_set_default_type (proc->result, 0, gfc_current_ns)
324 if (proc->result != proc)
326 proc->ts = proc->result->ts;
327 proc->as = gfc_copy_array_spec (proc->result->as);
328 proc->attr.dimension = proc->result->attr.dimension;
329 proc->attr.pointer = proc->result->attr.pointer;
330 proc->attr.allocatable = proc->result->attr.allocatable;
333 else if (!proc->result->attr.proc_pointer)
335 gfc_error ("Function result '%s' at %L has no IMPLICIT type",
336 proc->result->name, &proc->result->declared_at);
337 proc->result->attr.untyped = 1;
343 /******************** Symbol attribute stuff *********************/
345 /* This is a generic conflict-checker. We do this to avoid having a
346 single conflict in two places. */
348 #define conf(a, b) if (attr->a && attr->b) { a1 = a; a2 = b; goto conflict; }
349 #define conf2(a) if (attr->a) { a2 = a; goto conflict; }
350 #define conf_std(a, b, std) if (attr->a && attr->b)\
359 check_conflict (symbol_attribute *attr, const char *name, locus *where)
361 static const char *dummy = "DUMMY", *save = "SAVE", *pointer = "POINTER",
362 *target = "TARGET", *external = "EXTERNAL", *intent = "INTENT",
363 *intent_in = "INTENT(IN)", *intrinsic = "INTRINSIC",
364 *intent_out = "INTENT(OUT)", *intent_inout = "INTENT(INOUT)",
365 *allocatable = "ALLOCATABLE", *elemental = "ELEMENTAL",
366 *privat = "PRIVATE", *recursive = "RECURSIVE",
367 *in_common = "COMMON", *result = "RESULT", *in_namelist = "NAMELIST",
368 *publik = "PUBLIC", *optional = "OPTIONAL", *entry = "ENTRY",
369 *function = "FUNCTION", *subroutine = "SUBROUTINE",
370 *dimension = "DIMENSION", *in_equivalence = "EQUIVALENCE",
371 *use_assoc = "USE ASSOCIATED", *cray_pointer = "CRAY POINTER",
372 *cray_pointee = "CRAY POINTEE", *data = "DATA", *value = "VALUE",
373 *volatile_ = "VOLATILE", *is_protected = "PROTECTED",
374 *is_bind_c = "BIND(C)", *procedure = "PROCEDURE",
375 *asynchronous = "ASYNCHRONOUS", *codimension = "CODIMENSION",
376 *contiguous = "CONTIGUOUS";
377 static const char *threadprivate = "THREADPRIVATE";
383 where = &gfc_current_locus;
385 if (attr->pointer && attr->intent != INTENT_UNKNOWN)
389 standard = GFC_STD_F2003;
393 /* Check for attributes not allowed in a BLOCK DATA. */
394 if (gfc_current_state () == COMP_BLOCK_DATA)
398 if (attr->in_namelist)
400 if (attr->allocatable)
406 if (attr->access == ACCESS_PRIVATE)
408 if (attr->access == ACCESS_PUBLIC)
410 if (attr->intent != INTENT_UNKNOWN)
416 ("%s attribute not allowed in BLOCK DATA program unit at %L",
422 if (attr->save == SAVE_EXPLICIT)
425 conf (in_common, save);
428 switch (attr->flavor)
436 a1 = gfc_code2string (flavors, attr->flavor);
441 /* Conflicts between SAVE and PROCEDURE will be checked at
442 resolution stage, see "resolve_fl_procedure". */
451 conf (dummy, intrinsic);
452 conf (dummy, threadprivate);
453 conf (pointer, target);
454 conf (pointer, intrinsic);
455 conf (pointer, elemental);
456 conf (allocatable, elemental);
458 conf (target, external);
459 conf (target, intrinsic);
461 if (!attr->if_source)
462 conf (external, dimension); /* See Fortran 95's R504. */
464 conf (external, intrinsic);
465 conf (entry, intrinsic);
467 if ((attr->if_source == IFSRC_DECL && !attr->procedure) || attr->contained)
468 conf (external, subroutine);
470 if (attr->proc_pointer && gfc_notify_std (GFC_STD_F2003,
471 "Fortran 2003: Procedure pointer at %C") == FAILURE)
474 conf (allocatable, pointer);
475 conf_std (allocatable, dummy, GFC_STD_F2003);
476 conf_std (allocatable, function, GFC_STD_F2003);
477 conf_std (allocatable, result, GFC_STD_F2003);
478 conf (elemental, recursive);
480 conf (in_common, dummy);
481 conf (in_common, allocatable);
482 conf (in_common, codimension);
483 conf (in_common, result);
485 conf (dummy, result);
487 conf (in_equivalence, use_assoc);
488 conf (in_equivalence, codimension);
489 conf (in_equivalence, dummy);
490 conf (in_equivalence, target);
491 conf (in_equivalence, pointer);
492 conf (in_equivalence, function);
493 conf (in_equivalence, result);
494 conf (in_equivalence, entry);
495 conf (in_equivalence, allocatable);
496 conf (in_equivalence, threadprivate);
498 conf (in_namelist, pointer);
499 conf (in_namelist, allocatable);
501 conf (entry, result);
503 conf (function, subroutine);
505 if (!function && !subroutine)
506 conf (is_bind_c, dummy);
508 conf (is_bind_c, cray_pointer);
509 conf (is_bind_c, cray_pointee);
510 conf (is_bind_c, codimension);
511 conf (is_bind_c, allocatable);
512 conf (is_bind_c, elemental);
514 /* Need to also get volatile attr, according to 5.1 of F2003 draft.
515 Parameter conflict caught below. Also, value cannot be specified
516 for a dummy procedure. */
518 /* Cray pointer/pointee conflicts. */
519 conf (cray_pointer, cray_pointee);
520 conf (cray_pointer, dimension);
521 conf (cray_pointer, codimension);
522 conf (cray_pointer, contiguous);
523 conf (cray_pointer, pointer);
524 conf (cray_pointer, target);
525 conf (cray_pointer, allocatable);
526 conf (cray_pointer, external);
527 conf (cray_pointer, intrinsic);
528 conf (cray_pointer, in_namelist);
529 conf (cray_pointer, function);
530 conf (cray_pointer, subroutine);
531 conf (cray_pointer, entry);
533 conf (cray_pointee, allocatable);
534 conf (cray_pointer, contiguous);
535 conf (cray_pointer, codimension);
536 conf (cray_pointee, intent);
537 conf (cray_pointee, optional);
538 conf (cray_pointee, dummy);
539 conf (cray_pointee, target);
540 conf (cray_pointee, intrinsic);
541 conf (cray_pointee, pointer);
542 conf (cray_pointee, entry);
543 conf (cray_pointee, in_common);
544 conf (cray_pointee, in_equivalence);
545 conf (cray_pointee, threadprivate);
548 conf (data, function);
550 conf (data, allocatable);
552 conf (value, pointer)
553 conf (value, allocatable)
554 conf (value, subroutine)
555 conf (value, function)
556 conf (value, volatile_)
557 conf (value, dimension)
558 conf (value, codimension)
559 conf (value, external)
561 conf (codimension, result)
564 && (attr->intent == INTENT_OUT || attr->intent == INTENT_INOUT))
567 a2 = attr->intent == INTENT_OUT ? intent_out : intent_inout;
571 conf (is_protected, intrinsic)
572 conf (is_protected, in_common)
574 conf (asynchronous, intrinsic)
575 conf (asynchronous, external)
577 conf (volatile_, intrinsic)
578 conf (volatile_, external)
580 if (attr->volatile_ && attr->intent == INTENT_IN)
587 conf (procedure, allocatable)
588 conf (procedure, dimension)
589 conf (procedure, codimension)
590 conf (procedure, intrinsic)
591 conf (procedure, target)
592 conf (procedure, value)
593 conf (procedure, volatile_)
594 conf (procedure, asynchronous)
595 conf (procedure, entry)
597 a1 = gfc_code2string (flavors, attr->flavor);
599 if (attr->in_namelist
600 && attr->flavor != FL_VARIABLE
601 && attr->flavor != FL_PROCEDURE
602 && attr->flavor != FL_UNKNOWN)
608 switch (attr->flavor)
618 conf2 (asynchronous);
621 conf2 (is_protected);
631 conf2 (threadprivate);
633 if (attr->access == ACCESS_PUBLIC || attr->access == ACCESS_PRIVATE)
635 a2 = attr->access == ACCESS_PUBLIC ? publik : privat;
636 gfc_error ("%s attribute applied to %s %s at %L", a2, a1,
643 gfc_error_now ("BIND(C) applied to %s %s at %L", a1, name, where);
657 /* Conflicts with INTENT, SAVE and RESULT will be checked
658 at resolution stage, see "resolve_fl_procedure". */
660 if (attr->subroutine)
666 conf2 (asynchronous);
671 conf2 (threadprivate);
674 if (!attr->proc_pointer)
679 case PROC_ST_FUNCTION:
689 conf2 (threadprivate);
709 conf2 (threadprivate);
712 if (attr->intent != INTENT_UNKNOWN)
729 conf2 (is_protected);
735 conf2 (asynchronous);
736 conf2 (threadprivate);
751 gfc_error ("%s attribute conflicts with %s attribute at %L",
754 gfc_error ("%s attribute conflicts with %s attribute in '%s' at %L",
755 a1, a2, name, where);
762 return gfc_notify_std (standard, "Fortran 2003: %s attribute "
763 "with %s attribute at %L", a1, a2,
768 return gfc_notify_std (standard, "Fortran 2003: %s attribute "
769 "with %s attribute in '%s' at %L",
770 a1, a2, name, where);
779 /* Mark a symbol as referenced. */
782 gfc_set_sym_referenced (gfc_symbol *sym)
785 if (sym->attr.referenced)
788 sym->attr.referenced = 1;
790 /* Remember which order dummy variables are accessed in. */
792 sym->dummy_order = next_dummy_order++;
796 /* Common subroutine called by attribute changing subroutines in order
797 to prevent them from changing a symbol that has been
798 use-associated. Returns zero if it is OK to change the symbol,
802 check_used (symbol_attribute *attr, const char *name, locus *where)
805 if (attr->use_assoc == 0)
809 where = &gfc_current_locus;
812 gfc_error ("Cannot change attributes of USE-associated symbol at %L",
815 gfc_error ("Cannot change attributes of USE-associated symbol %s at %L",
822 /* Generate an error because of a duplicate attribute. */
825 duplicate_attr (const char *attr, locus *where)
829 where = &gfc_current_locus;
831 gfc_error ("Duplicate %s attribute specified at %L", attr, where);
836 gfc_add_ext_attribute (symbol_attribute *attr, ext_attr_id_t ext_attr,
837 locus *where ATTRIBUTE_UNUSED)
839 attr->ext_attr |= 1 << ext_attr;
844 /* Called from decl.c (attr_decl1) to check attributes, when declared
848 gfc_add_attribute (symbol_attribute *attr, locus *where)
850 if (check_used (attr, NULL, where))
853 return check_conflict (attr, NULL, where);
858 gfc_add_allocatable (symbol_attribute *attr, locus *where)
861 if (check_used (attr, NULL, where))
864 if (attr->allocatable)
866 duplicate_attr ("ALLOCATABLE", where);
870 if (attr->flavor == FL_PROCEDURE && attr->if_source == IFSRC_IFBODY
871 && gfc_find_state (COMP_INTERFACE) == FAILURE)
873 gfc_error ("ALLOCATABLE specified outside of INTERFACE body at %L",
878 attr->allocatable = 1;
879 return check_conflict (attr, NULL, where);
884 gfc_add_codimension (symbol_attribute *attr, const char *name, locus *where)
887 if (check_used (attr, name, where))
890 if (attr->codimension)
892 duplicate_attr ("CODIMENSION", where);
896 if (attr->flavor == FL_PROCEDURE && attr->if_source == IFSRC_IFBODY
897 && gfc_find_state (COMP_INTERFACE) == FAILURE)
899 gfc_error ("CODIMENSION specified for '%s' outside its INTERFACE body "
900 "at %L", name, where);
904 attr->codimension = 1;
905 return check_conflict (attr, name, where);
910 gfc_add_dimension (symbol_attribute *attr, const char *name, locus *where)
913 if (check_used (attr, name, where))
918 duplicate_attr ("DIMENSION", where);
922 if (attr->flavor == FL_PROCEDURE && attr->if_source == IFSRC_IFBODY
923 && gfc_find_state (COMP_INTERFACE) == FAILURE)
925 gfc_error ("DIMENSION specified for '%s' outside its INTERFACE body "
926 "at %L", name, where);
931 return check_conflict (attr, name, where);
936 gfc_add_contiguous (symbol_attribute *attr, const char *name, locus *where)
939 if (check_used (attr, name, where))
942 attr->contiguous = 1;
943 return check_conflict (attr, name, where);
948 gfc_add_external (symbol_attribute *attr, locus *where)
951 if (check_used (attr, NULL, where))
956 duplicate_attr ("EXTERNAL", where);
960 if (attr->pointer && attr->if_source != IFSRC_IFBODY)
963 attr->proc_pointer = 1;
968 return check_conflict (attr, NULL, where);
973 gfc_add_intrinsic (symbol_attribute *attr, locus *where)
976 if (check_used (attr, NULL, where))
981 duplicate_attr ("INTRINSIC", where);
987 return check_conflict (attr, NULL, where);
992 gfc_add_optional (symbol_attribute *attr, locus *where)
995 if (check_used (attr, NULL, where))
1000 duplicate_attr ("OPTIONAL", where);
1005 return check_conflict (attr, NULL, where);
1010 gfc_add_pointer (symbol_attribute *attr, locus *where)
1013 if (check_used (attr, NULL, where))
1016 if (attr->pointer && !(attr->if_source == IFSRC_IFBODY
1017 && gfc_find_state (COMP_INTERFACE) == FAILURE))
1019 duplicate_attr ("POINTER", where);
1023 if (attr->procedure || (attr->external && attr->if_source != IFSRC_IFBODY)
1024 || (attr->if_source == IFSRC_IFBODY
1025 && gfc_find_state (COMP_INTERFACE) == FAILURE))
1026 attr->proc_pointer = 1;
1030 return check_conflict (attr, NULL, where);
1035 gfc_add_cray_pointer (symbol_attribute *attr, locus *where)
1038 if (check_used (attr, NULL, where))
1041 attr->cray_pointer = 1;
1042 return check_conflict (attr, NULL, where);
1047 gfc_add_cray_pointee (symbol_attribute *attr, locus *where)
1050 if (check_used (attr, NULL, where))
1053 if (attr->cray_pointee)
1055 gfc_error ("Cray Pointee at %L appears in multiple pointer()"
1056 " statements", where);
1060 attr->cray_pointee = 1;
1061 return check_conflict (attr, NULL, where);
1066 gfc_add_protected (symbol_attribute *attr, const char *name, locus *where)
1068 if (check_used (attr, name, where))
1071 if (attr->is_protected)
1073 if (gfc_notify_std (GFC_STD_LEGACY,
1074 "Duplicate PROTECTED attribute specified at %L",
1080 attr->is_protected = 1;
1081 return check_conflict (attr, name, where);
1086 gfc_add_result (symbol_attribute *attr, const char *name, locus *where)
1089 if (check_used (attr, name, where))
1093 return check_conflict (attr, name, where);
1098 gfc_add_save (symbol_attribute *attr, save_state s, const char *name,
1102 if (check_used (attr, name, where))
1105 if (s == SAVE_EXPLICIT && gfc_pure (NULL))
1108 ("SAVE attribute at %L cannot be specified in a PURE procedure",
1113 if (s == SAVE_EXPLICIT && attr->save == SAVE_EXPLICIT)
1115 if (gfc_notify_std (GFC_STD_LEGACY,
1116 "Duplicate SAVE attribute specified at %L",
1123 return check_conflict (attr, name, where);
1128 gfc_add_value (symbol_attribute *attr, const char *name, locus *where)
1131 if (check_used (attr, name, where))
1136 if (gfc_notify_std (GFC_STD_LEGACY,
1137 "Duplicate VALUE attribute specified at %L",
1144 return check_conflict (attr, name, where);
1149 gfc_add_volatile (symbol_attribute *attr, const char *name, locus *where)
1151 /* No check_used needed as 11.2.1 of the F2003 standard allows
1152 that the local identifier made accessible by a use statement can be
1153 given a VOLATILE attribute - unless it is a coarray (F2008, C560). */
1155 if (attr->volatile_ && attr->volatile_ns == gfc_current_ns)
1156 if (gfc_notify_std (GFC_STD_LEGACY,
1157 "Duplicate VOLATILE attribute specified at %L", where)
1161 attr->volatile_ = 1;
1162 attr->volatile_ns = gfc_current_ns;
1163 return check_conflict (attr, name, where);
1168 gfc_add_asynchronous (symbol_attribute *attr, const char *name, locus *where)
1170 /* No check_used needed as 11.2.1 of the F2003 standard allows
1171 that the local identifier made accessible by a use statement can be
1172 given a ASYNCHRONOUS attribute. */
1174 if (attr->asynchronous && attr->asynchronous_ns == gfc_current_ns)
1175 if (gfc_notify_std (GFC_STD_LEGACY,
1176 "Duplicate ASYNCHRONOUS attribute specified at %L",
1180 attr->asynchronous = 1;
1181 attr->asynchronous_ns = gfc_current_ns;
1182 return check_conflict (attr, name, where);
1187 gfc_add_threadprivate (symbol_attribute *attr, const char *name, locus *where)
1190 if (check_used (attr, name, where))
1193 if (attr->threadprivate)
1195 duplicate_attr ("THREADPRIVATE", where);
1199 attr->threadprivate = 1;
1200 return check_conflict (attr, name, where);
1205 gfc_add_target (symbol_attribute *attr, locus *where)
1208 if (check_used (attr, NULL, where))
1213 duplicate_attr ("TARGET", where);
1218 return check_conflict (attr, NULL, where);
1223 gfc_add_dummy (symbol_attribute *attr, const char *name, locus *where)
1226 if (check_used (attr, name, where))
1229 /* Duplicate dummy arguments are allowed due to ENTRY statements. */
1231 return check_conflict (attr, name, where);
1236 gfc_add_in_common (symbol_attribute *attr, const char *name, locus *where)
1239 if (check_used (attr, name, where))
1242 /* Duplicate attribute already checked for. */
1243 attr->in_common = 1;
1244 return check_conflict (attr, name, where);
1249 gfc_add_in_equivalence (symbol_attribute *attr, const char *name, locus *where)
1252 /* Duplicate attribute already checked for. */
1253 attr->in_equivalence = 1;
1254 if (check_conflict (attr, name, where) == FAILURE)
1257 if (attr->flavor == FL_VARIABLE)
1260 return gfc_add_flavor (attr, FL_VARIABLE, name, where);
1265 gfc_add_data (symbol_attribute *attr, const char *name, locus *where)
1268 if (check_used (attr, name, where))
1272 return check_conflict (attr, name, where);
1277 gfc_add_in_namelist (symbol_attribute *attr, const char *name, locus *where)
1280 attr->in_namelist = 1;
1281 return check_conflict (attr, name, where);
1286 gfc_add_sequence (symbol_attribute *attr, const char *name, locus *where)
1289 if (check_used (attr, name, where))
1293 return check_conflict (attr, name, where);
1298 gfc_add_elemental (symbol_attribute *attr, locus *where)
1301 if (check_used (attr, NULL, where))
1304 if (attr->elemental)
1306 duplicate_attr ("ELEMENTAL", where);
1310 attr->elemental = 1;
1311 return check_conflict (attr, NULL, where);
1316 gfc_add_pure (symbol_attribute *attr, locus *where)
1319 if (check_used (attr, NULL, where))
1324 duplicate_attr ("PURE", where);
1329 return check_conflict (attr, NULL, where);
1334 gfc_add_recursive (symbol_attribute *attr, locus *where)
1337 if (check_used (attr, NULL, where))
1340 if (attr->recursive)
1342 duplicate_attr ("RECURSIVE", where);
1346 attr->recursive = 1;
1347 return check_conflict (attr, NULL, where);
1352 gfc_add_entry (symbol_attribute *attr, const char *name, locus *where)
1355 if (check_used (attr, name, where))
1360 duplicate_attr ("ENTRY", where);
1365 return check_conflict (attr, name, where);
1370 gfc_add_function (symbol_attribute *attr, const char *name, locus *where)
1373 if (attr->flavor != FL_PROCEDURE
1374 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1378 return check_conflict (attr, name, where);
1383 gfc_add_subroutine (symbol_attribute *attr, const char *name, locus *where)
1386 if (attr->flavor != FL_PROCEDURE
1387 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1390 attr->subroutine = 1;
1391 return check_conflict (attr, name, where);
1396 gfc_add_generic (symbol_attribute *attr, const char *name, locus *where)
1399 if (attr->flavor != FL_PROCEDURE
1400 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1404 return check_conflict (attr, name, where);
1409 gfc_add_proc (symbol_attribute *attr, const char *name, locus *where)
1412 if (check_used (attr, NULL, where))
1415 if (attr->flavor != FL_PROCEDURE
1416 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1419 if (attr->procedure)
1421 duplicate_attr ("PROCEDURE", where);
1425 attr->procedure = 1;
1427 return check_conflict (attr, NULL, where);
1432 gfc_add_abstract (symbol_attribute* attr, locus* where)
1436 duplicate_attr ("ABSTRACT", where);
1445 /* Flavors are special because some flavors are not what Fortran
1446 considers attributes and can be reaffirmed multiple times. */
1449 gfc_add_flavor (symbol_attribute *attr, sym_flavor f, const char *name,
1453 if ((f == FL_PROGRAM || f == FL_BLOCK_DATA || f == FL_MODULE
1454 || f == FL_PARAMETER || f == FL_LABEL || f == FL_DERIVED
1455 || f == FL_NAMELIST) && check_used (attr, name, where))
1458 if (attr->flavor == f && f == FL_VARIABLE)
1461 if (attr->flavor != FL_UNKNOWN)
1464 where = &gfc_current_locus;
1467 gfc_error ("%s attribute of '%s' conflicts with %s attribute at %L",
1468 gfc_code2string (flavors, attr->flavor), name,
1469 gfc_code2string (flavors, f), where);
1471 gfc_error ("%s attribute conflicts with %s attribute at %L",
1472 gfc_code2string (flavors, attr->flavor),
1473 gfc_code2string (flavors, f), where);
1480 return check_conflict (attr, name, where);
1485 gfc_add_procedure (symbol_attribute *attr, procedure_type t,
1486 const char *name, locus *where)
1489 if (check_used (attr, name, where))
1492 if (attr->flavor != FL_PROCEDURE
1493 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1497 where = &gfc_current_locus;
1499 if (attr->proc != PROC_UNKNOWN)
1501 gfc_error ("%s procedure at %L is already declared as %s procedure",
1502 gfc_code2string (procedures, t), where,
1503 gfc_code2string (procedures, attr->proc));
1510 /* Statement functions are always scalar and functions. */
1511 if (t == PROC_ST_FUNCTION
1512 && ((!attr->function && gfc_add_function (attr, name, where) == FAILURE)
1513 || attr->dimension))
1516 return check_conflict (attr, name, where);
1521 gfc_add_intent (symbol_attribute *attr, sym_intent intent, locus *where)
1524 if (check_used (attr, NULL, where))
1527 if (attr->intent == INTENT_UNKNOWN)
1529 attr->intent = intent;
1530 return check_conflict (attr, NULL, where);
1534 where = &gfc_current_locus;
1536 gfc_error ("INTENT (%s) conflicts with INTENT(%s) at %L",
1537 gfc_intent_string (attr->intent),
1538 gfc_intent_string (intent), where);
1544 /* No checks for use-association in public and private statements. */
1547 gfc_add_access (symbol_attribute *attr, gfc_access access,
1548 const char *name, locus *where)
1551 if (attr->access == ACCESS_UNKNOWN
1552 || (attr->use_assoc && attr->access != ACCESS_PRIVATE))
1554 attr->access = access;
1555 return check_conflict (attr, name, where);
1559 where = &gfc_current_locus;
1560 gfc_error ("ACCESS specification at %L was already specified", where);
1566 /* Set the is_bind_c field for the given symbol_attribute. */
1569 gfc_add_is_bind_c (symbol_attribute *attr, const char *name, locus *where,
1570 int is_proc_lang_bind_spec)
1573 if (is_proc_lang_bind_spec == 0 && attr->flavor == FL_PROCEDURE)
1574 gfc_error_now ("BIND(C) attribute at %L can only be used for "
1575 "variables or common blocks", where);
1576 else if (attr->is_bind_c)
1577 gfc_error_now ("Duplicate BIND attribute specified at %L", where);
1579 attr->is_bind_c = 1;
1582 where = &gfc_current_locus;
1584 if (gfc_notify_std (GFC_STD_F2003, "Fortran 2003: BIND(C) at %L", where)
1588 return check_conflict (attr, name, where);
1592 /* Set the extension field for the given symbol_attribute. */
1595 gfc_add_extension (symbol_attribute *attr, locus *where)
1598 where = &gfc_current_locus;
1600 if (attr->extension)
1601 gfc_error_now ("Duplicate EXTENDS attribute specified at %L", where);
1603 attr->extension = 1;
1605 if (gfc_notify_std (GFC_STD_F2003, "Fortran 2003: EXTENDS at %L", where)
1614 gfc_add_explicit_interface (gfc_symbol *sym, ifsrc source,
1615 gfc_formal_arglist * formal, locus *where)
1618 if (check_used (&sym->attr, sym->name, where))
1622 where = &gfc_current_locus;
1624 if (sym->attr.if_source != IFSRC_UNKNOWN
1625 && sym->attr.if_source != IFSRC_DECL)
1627 gfc_error ("Symbol '%s' at %L already has an explicit interface",
1632 if (source == IFSRC_IFBODY && (sym->attr.dimension || sym->attr.allocatable))
1634 gfc_error ("'%s' at %L has attributes specified outside its INTERFACE "
1635 "body", sym->name, where);
1639 sym->formal = formal;
1640 sym->attr.if_source = source;
1646 /* Add a type to a symbol. */
1649 gfc_add_type (gfc_symbol *sym, gfc_typespec *ts, locus *where)
1655 where = &gfc_current_locus;
1658 type = sym->result->ts.type;
1660 type = sym->ts.type;
1662 if (sym->attr.result && type == BT_UNKNOWN && sym->ns->proc_name)
1663 type = sym->ns->proc_name->ts.type;
1665 if (type != BT_UNKNOWN && !(sym->attr.function && sym->attr.implicit_type))
1667 gfc_error ("Symbol '%s' at %L already has basic type of %s", sym->name,
1668 where, gfc_basic_typename (type));
1672 if (sym->attr.procedure && sym->ts.interface)
1674 gfc_error ("Procedure '%s' at %L may not have basic type of %s",
1675 sym->name, where, gfc_basic_typename (ts->type));
1679 flavor = sym->attr.flavor;
1681 if (flavor == FL_PROGRAM || flavor == FL_BLOCK_DATA || flavor == FL_MODULE
1682 || flavor == FL_LABEL
1683 || (flavor == FL_PROCEDURE && sym->attr.subroutine)
1684 || flavor == FL_DERIVED || flavor == FL_NAMELIST)
1686 gfc_error ("Symbol '%s' at %L cannot have a type", sym->name, where);
1695 /* Clears all attributes. */
1698 gfc_clear_attr (symbol_attribute *attr)
1700 memset (attr, 0, sizeof (symbol_attribute));
1704 /* Check for missing attributes in the new symbol. Currently does
1705 nothing, but it's not clear that it is unnecessary yet. */
1708 gfc_missing_attr (symbol_attribute *attr ATTRIBUTE_UNUSED,
1709 locus *where ATTRIBUTE_UNUSED)
1716 /* Copy an attribute to a symbol attribute, bit by bit. Some
1717 attributes have a lot of side-effects but cannot be present given
1718 where we are called from, so we ignore some bits. */
1721 gfc_copy_attr (symbol_attribute *dest, symbol_attribute *src, locus *where)
1723 int is_proc_lang_bind_spec;
1725 /* In line with the other attributes, we only add bits but do not remove
1726 them; cf. also PR 41034. */
1727 dest->ext_attr |= src->ext_attr;
1729 if (src->allocatable && gfc_add_allocatable (dest, where) == FAILURE)
1732 if (src->dimension && gfc_add_dimension (dest, NULL, where) == FAILURE)
1734 if (src->codimension && gfc_add_codimension (dest, NULL, where) == FAILURE)
1736 if (src->contiguous && gfc_add_contiguous (dest, NULL, where) == FAILURE)
1738 if (src->optional && gfc_add_optional (dest, where) == FAILURE)
1740 if (src->pointer && gfc_add_pointer (dest, where) == FAILURE)
1742 if (src->is_protected && gfc_add_protected (dest, NULL, where) == FAILURE)
1744 if (src->save && gfc_add_save (dest, src->save, NULL, where) == FAILURE)
1746 if (src->value && gfc_add_value (dest, NULL, where) == FAILURE)
1748 if (src->volatile_ && gfc_add_volatile (dest, NULL, where) == FAILURE)
1750 if (src->asynchronous && gfc_add_asynchronous (dest, NULL, where) == FAILURE)
1752 if (src->threadprivate
1753 && gfc_add_threadprivate (dest, NULL, where) == FAILURE)
1755 if (src->target && gfc_add_target (dest, where) == FAILURE)
1757 if (src->dummy && gfc_add_dummy (dest, NULL, where) == FAILURE)
1759 if (src->result && gfc_add_result (dest, NULL, where) == FAILURE)
1764 if (src->in_namelist && gfc_add_in_namelist (dest, NULL, where) == FAILURE)
1767 if (src->in_common && gfc_add_in_common (dest, NULL, where) == FAILURE)
1770 if (src->generic && gfc_add_generic (dest, NULL, where) == FAILURE)
1772 if (src->function && gfc_add_function (dest, NULL, where) == FAILURE)
1774 if (src->subroutine && gfc_add_subroutine (dest, NULL, where) == FAILURE)
1777 if (src->sequence && gfc_add_sequence (dest, NULL, where) == FAILURE)
1779 if (src->elemental && gfc_add_elemental (dest, where) == FAILURE)
1781 if (src->pure && gfc_add_pure (dest, where) == FAILURE)
1783 if (src->recursive && gfc_add_recursive (dest, where) == FAILURE)
1786 if (src->flavor != FL_UNKNOWN
1787 && gfc_add_flavor (dest, src->flavor, NULL, where) == FAILURE)
1790 if (src->intent != INTENT_UNKNOWN
1791 && gfc_add_intent (dest, src->intent, where) == FAILURE)
1794 if (src->access != ACCESS_UNKNOWN
1795 && gfc_add_access (dest, src->access, NULL, where) == FAILURE)
1798 if (gfc_missing_attr (dest, where) == FAILURE)
1801 if (src->cray_pointer && gfc_add_cray_pointer (dest, where) == FAILURE)
1803 if (src->cray_pointee && gfc_add_cray_pointee (dest, where) == FAILURE)
1806 is_proc_lang_bind_spec = (src->flavor == FL_PROCEDURE ? 1 : 0);
1808 && gfc_add_is_bind_c (dest, NULL, where, is_proc_lang_bind_spec)
1812 if (src->is_c_interop)
1813 dest->is_c_interop = 1;
1817 if (src->external && gfc_add_external (dest, where) == FAILURE)
1819 if (src->intrinsic && gfc_add_intrinsic (dest, where) == FAILURE)
1821 if (src->proc_pointer)
1822 dest->proc_pointer = 1;
1831 /************** Component name management ************/
1833 /* Component names of a derived type form their own little namespaces
1834 that are separate from all other spaces. The space is composed of
1835 a singly linked list of gfc_component structures whose head is
1836 located in the parent symbol. */
1839 /* Add a component name to a symbol. The call fails if the name is
1840 already present. On success, the component pointer is modified to
1841 point to the additional component structure. */
1844 gfc_add_component (gfc_symbol *sym, const char *name,
1845 gfc_component **component)
1847 gfc_component *p, *tail;
1851 for (p = sym->components; p; p = p->next)
1853 if (strcmp (p->name, name) == 0)
1855 gfc_error ("Component '%s' at %C already declared at %L",
1863 if (sym->attr.extension
1864 && gfc_find_component (sym->components->ts.u.derived, name, true, true))
1866 gfc_error ("Component '%s' at %C already in the parent type "
1867 "at %L", name, &sym->components->ts.u.derived->declared_at);
1871 /* Allocate a new component. */
1872 p = gfc_get_component ();
1875 sym->components = p;
1879 p->name = gfc_get_string (name);
1880 p->loc = gfc_current_locus;
1881 p->ts.type = BT_UNKNOWN;
1888 /* Recursive function to switch derived types of all symbol in a
1892 switch_types (gfc_symtree *st, gfc_symbol *from, gfc_symbol *to)
1900 if (sym->ts.type == BT_DERIVED && sym->ts.u.derived == from)
1901 sym->ts.u.derived = to;
1903 switch_types (st->left, from, to);
1904 switch_types (st->right, from, to);
1908 /* This subroutine is called when a derived type is used in order to
1909 make the final determination about which version to use. The
1910 standard requires that a type be defined before it is 'used', but
1911 such types can appear in IMPLICIT statements before the actual
1912 definition. 'Using' in this context means declaring a variable to
1913 be that type or using the type constructor.
1915 If a type is used and the components haven't been defined, then we
1916 have to have a derived type in a parent unit. We find the node in
1917 the other namespace and point the symtree node in this namespace to
1918 that node. Further reference to this name point to the correct
1919 node. If we can't find the node in a parent namespace, then we have
1922 This subroutine takes a pointer to a symbol node and returns a
1923 pointer to the translated node or NULL for an error. Usually there
1924 is no translation and we return the node we were passed. */
1927 gfc_use_derived (gfc_symbol *sym)
1934 if (sym->components != NULL || sym->attr.zero_comp)
1935 return sym; /* Already defined. */
1937 if (sym->ns->parent == NULL)
1940 if (gfc_find_symbol (sym->name, sym->ns->parent, 1, &s))
1942 gfc_error ("Symbol '%s' at %C is ambiguous", sym->name);
1946 if (s == NULL || s->attr.flavor != FL_DERIVED)
1949 /* Get rid of symbol sym, translating all references to s. */
1950 for (i = 0; i < GFC_LETTERS; i++)
1952 t = &sym->ns->default_type[i];
1953 if (t->u.derived == sym)
1957 st = gfc_find_symtree (sym->ns->sym_root, sym->name);
1962 /* Unlink from list of modified symbols. */
1963 gfc_commit_symbol (sym);
1965 switch_types (sym->ns->sym_root, sym, s);
1967 /* TODO: Also have to replace sym -> s in other lists like
1968 namelists, common lists and interface lists. */
1969 gfc_free_symbol (sym);
1974 gfc_error ("Derived type '%s' at %C is being used before it is defined",
1980 /* Given a derived type node and a component name, try to locate the
1981 component structure. Returns the NULL pointer if the component is
1982 not found or the components are private. If noaccess is set, no access
1986 gfc_find_component (gfc_symbol *sym, const char *name,
1987 bool noaccess, bool silent)
1994 sym = gfc_use_derived (sym);
1999 for (p = sym->components; p; p = p->next)
2000 if (strcmp (p->name, name) == 0)
2004 && sym->attr.extension
2005 && sym->components->ts.type == BT_DERIVED)
2007 p = gfc_find_component (sym->components->ts.u.derived, name,
2009 /* Do not overwrite the error. */
2014 if (p == NULL && !silent)
2015 gfc_error ("'%s' at %C is not a member of the '%s' structure",
2018 else if (sym->attr.use_assoc && !noaccess)
2020 bool is_parent_comp = sym->attr.extension && (p == sym->components);
2021 if (p->attr.access == ACCESS_PRIVATE ||
2022 (p->attr.access != ACCESS_PUBLIC
2023 && sym->component_access == ACCESS_PRIVATE
2024 && !is_parent_comp))
2027 gfc_error ("Component '%s' at %C is a PRIVATE component of '%s'",
2037 /* Given a symbol, free all of the component structures and everything
2041 free_components (gfc_component *p)
2049 gfc_free_array_spec (p->as);
2050 gfc_free_expr (p->initializer);
2052 gfc_free_formal_arglist (p->formal);
2053 gfc_free_namespace (p->formal_ns);
2060 /******************** Statement label management ********************/
2062 /* Comparison function for statement labels, used for managing the
2066 compare_st_labels (void *a1, void *b1)
2068 int a = ((gfc_st_label *) a1)->value;
2069 int b = ((gfc_st_label *) b1)->value;
2075 /* Free a single gfc_st_label structure, making sure the tree is not
2076 messed up. This function is called only when some parse error
2080 gfc_free_st_label (gfc_st_label *label)
2086 gfc_delete_bbt (&gfc_current_ns->st_labels, label, compare_st_labels);
2088 if (label->format != NULL)
2089 gfc_free_expr (label->format);
2095 /* Free a whole tree of gfc_st_label structures. */
2098 free_st_labels (gfc_st_label *label)
2104 free_st_labels (label->left);
2105 free_st_labels (label->right);
2107 if (label->format != NULL)
2108 gfc_free_expr (label->format);
2113 /* Given a label number, search for and return a pointer to the label
2114 structure, creating it if it does not exist. */
2117 gfc_get_st_label (int labelno)
2122 /* Find the namespace of the scoping unit:
2123 If we're in a BLOCK construct, jump to the parent namespace. */
2124 ns = gfc_current_ns;
2125 while (ns->proc_name && ns->proc_name->attr.flavor == FL_LABEL)
2128 /* First see if the label is already in this namespace. */
2132 if (lp->value == labelno)
2135 if (lp->value < labelno)
2141 lp = XCNEW (gfc_st_label);
2143 lp->value = labelno;
2144 lp->defined = ST_LABEL_UNKNOWN;
2145 lp->referenced = ST_LABEL_UNKNOWN;
2147 gfc_insert_bbt (&ns->st_labels, lp, compare_st_labels);
2153 /* Called when a statement with a statement label is about to be
2154 accepted. We add the label to the list of the current namespace,
2155 making sure it hasn't been defined previously and referenced
2159 gfc_define_st_label (gfc_st_label *lp, gfc_sl_type type, locus *label_locus)
2163 labelno = lp->value;
2165 if (lp->defined != ST_LABEL_UNKNOWN)
2166 gfc_error ("Duplicate statement label %d at %L and %L", labelno,
2167 &lp->where, label_locus);
2170 lp->where = *label_locus;
2174 case ST_LABEL_FORMAT:
2175 if (lp->referenced == ST_LABEL_TARGET)
2176 gfc_error ("Label %d at %C already referenced as branch target",
2179 lp->defined = ST_LABEL_FORMAT;
2183 case ST_LABEL_TARGET:
2184 if (lp->referenced == ST_LABEL_FORMAT)
2185 gfc_error ("Label %d at %C already referenced as a format label",
2188 lp->defined = ST_LABEL_TARGET;
2193 lp->defined = ST_LABEL_BAD_TARGET;
2194 lp->referenced = ST_LABEL_BAD_TARGET;
2200 /* Reference a label. Given a label and its type, see if that
2201 reference is consistent with what is known about that label,
2202 updating the unknown state. Returns FAILURE if something goes
2206 gfc_reference_st_label (gfc_st_label *lp, gfc_sl_type type)
2208 gfc_sl_type label_type;
2215 labelno = lp->value;
2217 if (lp->defined != ST_LABEL_UNKNOWN)
2218 label_type = lp->defined;
2221 label_type = lp->referenced;
2222 lp->where = gfc_current_locus;
2225 if (label_type == ST_LABEL_FORMAT && type == ST_LABEL_TARGET)
2227 gfc_error ("Label %d at %C previously used as a FORMAT label", labelno);
2232 if ((label_type == ST_LABEL_TARGET || label_type == ST_LABEL_BAD_TARGET)
2233 && type == ST_LABEL_FORMAT)
2235 gfc_error ("Label %d at %C previously used as branch target", labelno);
2240 lp->referenced = type;
2248 /*******A helper function for creating new expressions*************/
2252 gfc_lval_expr_from_sym (gfc_symbol *sym)
2255 lval = gfc_get_expr ();
2256 lval->expr_type = EXPR_VARIABLE;
2257 lval->where = sym->declared_at;
2259 lval->symtree = gfc_find_symtree (sym->ns->sym_root, sym->name);
2261 /* It will always be a full array. */
2262 lval->rank = sym->as ? sym->as->rank : 0;
2265 lval->ref = gfc_get_ref ();
2266 lval->ref->type = REF_ARRAY;
2267 lval->ref->u.ar.type = AR_FULL;
2268 lval->ref->u.ar.dimen = lval->rank;
2269 lval->ref->u.ar.where = sym->declared_at;
2270 lval->ref->u.ar.as = sym->as;
2277 /************** Symbol table management subroutines ****************/
2279 /* Basic details: Fortran 95 requires a potentially unlimited number
2280 of distinct namespaces when compiling a program unit. This case
2281 occurs during a compilation of internal subprograms because all of
2282 the internal subprograms must be read before we can start
2283 generating code for the host.
2285 Given the tricky nature of the Fortran grammar, we must be able to
2286 undo changes made to a symbol table if the current interpretation
2287 of a statement is found to be incorrect. Whenever a symbol is
2288 looked up, we make a copy of it and link to it. All of these
2289 symbols are kept in a singly linked list so that we can commit or
2290 undo the changes at a later time.
2292 A symtree may point to a symbol node outside of its namespace. In
2293 this case, that symbol has been used as a host associated variable
2294 at some previous time. */
2296 /* Allocate a new namespace structure. Copies the implicit types from
2297 PARENT if PARENT_TYPES is set. */
2300 gfc_get_namespace (gfc_namespace *parent, int parent_types)
2307 ns = XCNEW (gfc_namespace);
2308 ns->sym_root = NULL;
2309 ns->uop_root = NULL;
2310 ns->tb_sym_root = NULL;
2311 ns->finalizers = NULL;
2312 ns->default_access = ACCESS_UNKNOWN;
2313 ns->parent = parent;
2315 for (in = GFC_INTRINSIC_BEGIN; in != GFC_INTRINSIC_END; in++)
2317 ns->operator_access[in] = ACCESS_UNKNOWN;
2318 ns->tb_op[in] = NULL;
2321 /* Initialize default implicit types. */
2322 for (i = 'a'; i <= 'z'; i++)
2324 ns->set_flag[i - 'a'] = 0;
2325 ts = &ns->default_type[i - 'a'];
2327 if (parent_types && ns->parent != NULL)
2329 /* Copy parent settings. */
2330 *ts = ns->parent->default_type[i - 'a'];
2334 if (gfc_option.flag_implicit_none != 0)
2340 if ('i' <= i && i <= 'n')
2342 ts->type = BT_INTEGER;
2343 ts->kind = gfc_default_integer_kind;
2348 ts->kind = gfc_default_real_kind;
2358 /* Comparison function for symtree nodes. */
2361 compare_symtree (void *_st1, void *_st2)
2363 gfc_symtree *st1, *st2;
2365 st1 = (gfc_symtree *) _st1;
2366 st2 = (gfc_symtree *) _st2;
2368 return strcmp (st1->name, st2->name);
2372 /* Allocate a new symtree node and associate it with the new symbol. */
2375 gfc_new_symtree (gfc_symtree **root, const char *name)
2379 st = XCNEW (gfc_symtree);
2380 st->name = gfc_get_string (name);
2382 gfc_insert_bbt (root, st, compare_symtree);
2387 /* Delete a symbol from the tree. Does not free the symbol itself! */
2390 gfc_delete_symtree (gfc_symtree **root, const char *name)
2392 gfc_symtree st, *st0;
2394 st0 = gfc_find_symtree (*root, name);
2396 st.name = gfc_get_string (name);
2397 gfc_delete_bbt (root, &st, compare_symtree);
2403 /* Given a root symtree node and a name, try to find the symbol within
2404 the namespace. Returns NULL if the symbol is not found. */
2407 gfc_find_symtree (gfc_symtree *st, const char *name)
2413 c = strcmp (name, st->name);
2417 st = (c < 0) ? st->left : st->right;
2424 /* Return a symtree node with a name that is guaranteed to be unique
2425 within the namespace and corresponds to an illegal fortran name. */
2428 gfc_get_unique_symtree (gfc_namespace *ns)
2430 char name[GFC_MAX_SYMBOL_LEN + 1];
2431 static int serial = 0;
2433 sprintf (name, "@%d", serial++);
2434 return gfc_new_symtree (&ns->sym_root, name);
2438 /* Given a name find a user operator node, creating it if it doesn't
2439 exist. These are much simpler than symbols because they can't be
2440 ambiguous with one another. */
2443 gfc_get_uop (const char *name)
2448 st = gfc_find_symtree (gfc_current_ns->uop_root, name);
2452 st = gfc_new_symtree (&gfc_current_ns->uop_root, name);
2454 uop = st->n.uop = XCNEW (gfc_user_op);
2455 uop->name = gfc_get_string (name);
2456 uop->access = ACCESS_UNKNOWN;
2457 uop->ns = gfc_current_ns;
2463 /* Given a name find the user operator node. Returns NULL if it does
2467 gfc_find_uop (const char *name, gfc_namespace *ns)
2472 ns = gfc_current_ns;
2474 st = gfc_find_symtree (ns->uop_root, name);
2475 return (st == NULL) ? NULL : st->n.uop;
2479 /* Remove a gfc_symbol structure and everything it points to. */
2482 gfc_free_symbol (gfc_symbol *sym)
2488 gfc_free_array_spec (sym->as);
2490 free_components (sym->components);
2492 gfc_free_expr (sym->value);
2494 gfc_free_namelist (sym->namelist);
2496 gfc_free_namespace (sym->formal_ns);
2498 if (!sym->attr.generic_copy)
2499 gfc_free_interface (sym->generic);
2501 gfc_free_formal_arglist (sym->formal);
2503 gfc_free_namespace (sym->f2k_derived);
2509 /* Decrease the reference counter and free memory when we reach zero. */
2512 gfc_release_symbol (gfc_symbol *sym)
2517 if (sym->formal_ns != NULL && sym->refs == 2)
2519 /* As formal_ns contains a reference to sym, delete formal_ns just
2520 before the deletion of sym. */
2521 gfc_namespace *ns = sym->formal_ns;
2522 sym->formal_ns = NULL;
2523 gfc_free_namespace (ns);
2530 gcc_assert (sym->refs == 0);
2531 gfc_free_symbol (sym);
2535 /* Allocate and initialize a new symbol node. */
2538 gfc_new_symbol (const char *name, gfc_namespace *ns)
2542 p = XCNEW (gfc_symbol);
2544 gfc_clear_ts (&p->ts);
2545 gfc_clear_attr (&p->attr);
2548 p->declared_at = gfc_current_locus;
2550 if (strlen (name) > GFC_MAX_SYMBOL_LEN)
2551 gfc_internal_error ("new_symbol(): Symbol name too long");
2553 p->name = gfc_get_string (name);
2555 /* Make sure flags for symbol being C bound are clear initially. */
2556 p->attr.is_bind_c = 0;
2557 p->attr.is_iso_c = 0;
2558 /* Make sure the binding label field has a Nul char to start. */
2559 p->binding_label[0] = '\0';
2561 /* Clear the ptrs we may need. */
2562 p->common_block = NULL;
2563 p->f2k_derived = NULL;
2570 /* Generate an error if a symbol is ambiguous. */
2573 ambiguous_symbol (const char *name, gfc_symtree *st)
2576 if (st->n.sym->module)
2577 gfc_error ("Name '%s' at %C is an ambiguous reference to '%s' "
2578 "from module '%s'", name, st->n.sym->name, st->n.sym->module);
2580 gfc_error ("Name '%s' at %C is an ambiguous reference to '%s' "
2581 "from current program unit", name, st->n.sym->name);
2585 /* If we're in a SELECT TYPE block, check if the variable 'st' matches any
2586 selector on the stack. If yes, replace it by the corresponding temporary. */
2589 select_type_insert_tmp (gfc_symtree **st)
2591 gfc_select_type_stack *stack = select_type_stack;
2592 for (; stack; stack = stack->prev)
2593 if ((*st)->n.sym == stack->selector && stack->tmp)
2598 /* Look for a symtree in the current procedure -- that is, go up to
2599 parent namespaces but only if inside a BLOCK. Returns NULL if not found. */
2602 gfc_find_symtree_in_proc (const char* name, gfc_namespace* ns)
2606 gfc_symtree* st = gfc_find_symtree (ns->sym_root, name);
2610 if (!ns->construct_entities)
2619 /* Search for a symtree starting in the current namespace, resorting to
2620 any parent namespaces if requested by a nonzero parent_flag.
2621 Returns nonzero if the name is ambiguous. */
2624 gfc_find_sym_tree (const char *name, gfc_namespace *ns, int parent_flag,
2625 gfc_symtree **result)
2630 ns = gfc_current_ns;
2634 st = gfc_find_symtree (ns->sym_root, name);
2637 select_type_insert_tmp (&st);
2640 /* Ambiguous generic interfaces are permitted, as long
2641 as the specific interfaces are different. */
2642 if (st->ambiguous && !st->n.sym->attr.generic)
2644 ambiguous_symbol (name, st);
2663 /* Same, but returns the symbol instead. */
2666 gfc_find_symbol (const char *name, gfc_namespace *ns, int parent_flag,
2667 gfc_symbol **result)
2672 i = gfc_find_sym_tree (name, ns, parent_flag, &st);
2677 *result = st->n.sym;
2683 /* Save symbol with the information necessary to back it out. */
2686 save_symbol_data (gfc_symbol *sym)
2689 if (sym->gfc_new || sym->old_symbol != NULL)
2692 sym->old_symbol = XCNEW (gfc_symbol);
2693 *(sym->old_symbol) = *sym;
2695 sym->tlink = changed_syms;
2700 /* Given a name, find a symbol, or create it if it does not exist yet
2701 in the current namespace. If the symbol is found we make sure that
2704 The integer return code indicates
2706 1 The symbol name was ambiguous
2707 2 The name meant to be established was already host associated.
2709 So if the return value is nonzero, then an error was issued. */
2712 gfc_get_sym_tree (const char *name, gfc_namespace *ns, gfc_symtree **result,
2713 bool allow_subroutine)
2718 /* This doesn't usually happen during resolution. */
2720 ns = gfc_current_ns;
2722 /* Try to find the symbol in ns. */
2723 st = gfc_find_symtree (ns->sym_root, name);
2727 /* If not there, create a new symbol. */
2728 p = gfc_new_symbol (name, ns);
2730 /* Add to the list of tentative symbols. */
2731 p->old_symbol = NULL;
2732 p->tlink = changed_syms;
2737 st = gfc_new_symtree (&ns->sym_root, name);
2744 /* Make sure the existing symbol is OK. Ambiguous
2745 generic interfaces are permitted, as long as the
2746 specific interfaces are different. */
2747 if (st->ambiguous && !st->n.sym->attr.generic)
2749 ambiguous_symbol (name, st);
2754 if (p->ns != ns && (!p->attr.function || ns->proc_name != p)
2755 && !(allow_subroutine && p->attr.subroutine)
2756 && !(ns->proc_name && ns->proc_name->attr.if_source == IFSRC_IFBODY
2757 && (ns->has_import_set || p->attr.imported)))
2759 /* Symbol is from another namespace. */
2760 gfc_error ("Symbol '%s' at %C has already been host associated",
2767 /* Copy in case this symbol is changed. */
2768 save_symbol_data (p);
2777 gfc_get_symbol (const char *name, gfc_namespace *ns, gfc_symbol **result)
2782 i = gfc_get_sym_tree (name, ns, &st, false);
2787 *result = st->n.sym;
2794 /* Subroutine that searches for a symbol, creating it if it doesn't
2795 exist, but tries to host-associate the symbol if possible. */
2798 gfc_get_ha_sym_tree (const char *name, gfc_symtree **result)
2803 i = gfc_find_sym_tree (name, gfc_current_ns, 0, &st);
2807 save_symbol_data (st->n.sym);
2812 if (gfc_current_ns->parent != NULL)
2814 i = gfc_find_sym_tree (name, gfc_current_ns->parent, 1, &st);
2825 return gfc_get_sym_tree (name, gfc_current_ns, result, false);
2830 gfc_get_ha_symbol (const char *name, gfc_symbol **result)
2835 i = gfc_get_ha_sym_tree (name, &st);
2838 *result = st->n.sym;
2845 /* Return true if both symbols could refer to the same data object. Does
2846 not take account of aliasing due to equivalence statements. */
2849 gfc_symbols_could_alias (gfc_symbol *lsym, gfc_symbol *rsym)
2851 /* Aliasing isn't possible if the symbols have different base types. */
2852 if (gfc_compare_types (&lsym->ts, &rsym->ts) == 0)
2855 /* Pointers can point to other pointers, target objects and allocatable
2856 objects. Two allocatable objects cannot share the same storage. */
2857 if (lsym->attr.pointer
2858 && (rsym->attr.pointer || rsym->attr.allocatable || rsym->attr.target))
2860 if (lsym->attr.target && rsym->attr.pointer)
2862 if (lsym->attr.allocatable && rsym->attr.pointer)
2865 /* Special case: Argument association, cf. F90 12.4.1.6, F2003 12.4.1.7
2866 and F2008 12.5.2.13 items 3b and 4b. The pointer case (a) is already
2868 if (lsym->attr.target && rsym->attr.target
2869 && ((lsym->attr.dummy && !lsym->attr.contiguous
2870 && (!lsym->attr.dimension || lsym->as->type == AS_ASSUMED_SHAPE))
2871 || (rsym->attr.dummy && !rsym->attr.contiguous
2872 && (!rsym->attr.dimension
2873 || rsym->as->type == AS_ASSUMED_SHAPE))))
2880 /* Undoes all the changes made to symbols in the current statement.
2881 This subroutine is made simpler due to the fact that attributes are
2882 never removed once added. */
2885 gfc_undo_symbols (void)
2887 gfc_symbol *p, *q, *old;
2888 tentative_tbp *tbp, *tbq;
2890 for (p = changed_syms; p; p = q)
2896 /* Symbol was new. */
2897 if (p->attr.in_common && p->common_block && p->common_block->head)
2899 /* If the symbol was added to any common block, it
2900 needs to be removed to stop the resolver looking
2901 for a (possibly) dead symbol. */
2903 if (p->common_block->head == p)
2904 p->common_block->head = p->common_next;
2907 gfc_symbol *cparent, *csym;
2909 cparent = p->common_block->head;
2910 csym = cparent->common_next;
2915 csym = csym->common_next;
2918 gcc_assert(cparent->common_next == p);
2920 cparent->common_next = csym->common_next;
2924 gfc_delete_symtree (&p->ns->sym_root, p->name);
2926 gfc_release_symbol (p);
2930 /* Restore previous state of symbol. Just copy simple stuff. */
2932 old = p->old_symbol;
2934 p->ts.type = old->ts.type;
2935 p->ts.kind = old->ts.kind;
2937 p->attr = old->attr;
2939 if (p->value != old->value)
2941 gfc_free_expr (old->value);
2945 if (p->as != old->as)
2948 gfc_free_array_spec (p->as);
2952 p->generic = old->generic;
2953 p->component_access = old->component_access;
2955 if (p->namelist != NULL && old->namelist == NULL)
2957 gfc_free_namelist (p->namelist);
2962 if (p->namelist_tail != old->namelist_tail)
2964 gfc_free_namelist (old->namelist_tail);
2965 old->namelist_tail->next = NULL;
2969 p->namelist_tail = old->namelist_tail;
2971 if (p->formal != old->formal)
2973 gfc_free_formal_arglist (p->formal);
2974 p->formal = old->formal;
2977 gfc_free (p->old_symbol);
2978 p->old_symbol = NULL;
2982 changed_syms = NULL;
2984 for (tbp = tentative_tbp_list; tbp; tbp = tbq)
2987 /* Procedure is already marked `error' by default. */
2990 tentative_tbp_list = NULL;
2994 /* Free sym->old_symbol. sym->old_symbol is mostly a shallow copy of sym; the
2995 components of old_symbol that might need deallocation are the "allocatables"
2996 that are restored in gfc_undo_symbols(), with two exceptions: namelist and
2997 namelist_tail. In case these differ between old_symbol and sym, it's just
2998 because sym->namelist has gotten a few more items. */
3001 free_old_symbol (gfc_symbol *sym)
3004 if (sym->old_symbol == NULL)
3007 if (sym->old_symbol->as != sym->as)
3008 gfc_free_array_spec (sym->old_symbol->as);
3010 if (sym->old_symbol->value != sym->value)
3011 gfc_free_expr (sym->old_symbol->value);
3013 if (sym->old_symbol->formal != sym->formal)
3014 gfc_free_formal_arglist (sym->old_symbol->formal);
3016 gfc_free (sym->old_symbol);
3017 sym->old_symbol = NULL;
3021 /* Makes the changes made in the current statement permanent-- gets
3022 rid of undo information. */
3025 gfc_commit_symbols (void)
3028 tentative_tbp *tbp, *tbq;
3030 for (p = changed_syms; p; p = q)
3036 free_old_symbol (p);
3038 changed_syms = NULL;
3040 for (tbp = tentative_tbp_list; tbp; tbp = tbq)
3043 tbp->proc->error = 0;
3046 tentative_tbp_list = NULL;
3050 /* Makes the changes made in one symbol permanent -- gets rid of undo
3054 gfc_commit_symbol (gfc_symbol *sym)
3058 if (changed_syms == sym)
3059 changed_syms = sym->tlink;
3062 for (p = changed_syms; p; p = p->tlink)
3063 if (p->tlink == sym)
3065 p->tlink = sym->tlink;
3074 free_old_symbol (sym);
3078 /* Recursively free trees containing type-bound procedures. */
3081 free_tb_tree (gfc_symtree *t)
3086 free_tb_tree (t->left);
3087 free_tb_tree (t->right);
3089 /* TODO: Free type-bound procedure structs themselves; probably needs some
3090 sort of ref-counting mechanism. */
3096 /* Recursive function that deletes an entire tree and all the common
3097 head structures it points to. */
3100 free_common_tree (gfc_symtree * common_tree)
3102 if (common_tree == NULL)
3105 free_common_tree (common_tree->left);
3106 free_common_tree (common_tree->right);
3108 gfc_free (common_tree);
3112 /* Recursive function that deletes an entire tree and all the user
3113 operator nodes that it contains. */
3116 free_uop_tree (gfc_symtree *uop_tree)
3118 if (uop_tree == NULL)
3121 free_uop_tree (uop_tree->left);
3122 free_uop_tree (uop_tree->right);
3124 gfc_free_interface (uop_tree->n.uop->op);
3125 gfc_free (uop_tree->n.uop);
3126 gfc_free (uop_tree);
3130 /* Recursive function that deletes an entire tree and all the symbols
3131 that it contains. */
3134 free_sym_tree (gfc_symtree *sym_tree)
3136 if (sym_tree == NULL)
3139 free_sym_tree (sym_tree->left);
3140 free_sym_tree (sym_tree->right);
3142 gfc_release_symbol (sym_tree->n.sym);
3143 gfc_free (sym_tree);
3147 /* Free the derived type list. */
3150 gfc_free_dt_list (void)
3152 gfc_dt_list *dt, *n;
3154 for (dt = gfc_derived_types; dt; dt = n)
3160 gfc_derived_types = NULL;
3164 /* Free the gfc_equiv_info's. */
3167 gfc_free_equiv_infos (gfc_equiv_info *s)
3171 gfc_free_equiv_infos (s->next);
3176 /* Free the gfc_equiv_lists. */
3179 gfc_free_equiv_lists (gfc_equiv_list *l)
3183 gfc_free_equiv_lists (l->next);
3184 gfc_free_equiv_infos (l->equiv);
3189 /* Free a finalizer procedure list. */
3192 gfc_free_finalizer (gfc_finalizer* el)
3196 gfc_release_symbol (el->proc_sym);
3202 gfc_free_finalizer_list (gfc_finalizer* list)
3206 gfc_finalizer* current = list;
3208 gfc_free_finalizer (current);
3213 /* Create a new gfc_charlen structure and add it to a namespace.
3214 If 'old_cl' is given, the newly created charlen will be a copy of it. */
3217 gfc_new_charlen (gfc_namespace *ns, gfc_charlen *old_cl)
3220 cl = gfc_get_charlen ();
3222 /* Put into namespace. */
3223 cl->next = ns->cl_list;
3229 cl->length = gfc_copy_expr (old_cl->length);
3230 cl->length_from_typespec = old_cl->length_from_typespec;
3231 cl->backend_decl = old_cl->backend_decl;
3232 cl->passed_length = old_cl->passed_length;
3233 cl->resolved = old_cl->resolved;
3240 /* Free the charlen list from cl to end (end is not freed).
3241 Free the whole list if end is NULL. */
3243 void gfc_free_charlen (gfc_charlen *cl, gfc_charlen *end)
3247 for (; cl != end; cl = cl2)
3252 gfc_free_expr (cl->length);
3258 /* Free entry list structs. */
3261 free_entry_list (gfc_entry_list *el)
3263 gfc_entry_list *next;
3270 free_entry_list (next);
3274 /* Free a namespace structure and everything below it. Interface
3275 lists associated with intrinsic operators are not freed. These are
3276 taken care of when a specific name is freed. */
3279 gfc_free_namespace (gfc_namespace *ns)
3281 gfc_namespace *p, *q;
3290 gcc_assert (ns->refs == 0);
3292 gfc_free_statements (ns->code);
3294 free_sym_tree (ns->sym_root);
3295 free_uop_tree (ns->uop_root);
3296 free_common_tree (ns->common_root);
3297 free_tb_tree (ns->tb_sym_root);
3298 free_tb_tree (ns->tb_uop_root);
3299 gfc_free_finalizer_list (ns->finalizers);
3300 gfc_free_charlen (ns->cl_list, NULL);
3301 free_st_labels (ns->st_labels);
3303 free_entry_list (ns->entries);
3304 gfc_free_equiv (ns->equiv);
3305 gfc_free_equiv_lists (ns->equiv_lists);
3306 gfc_free_use_stmts (ns->use_stmts);
3308 for (i = GFC_INTRINSIC_BEGIN; i != GFC_INTRINSIC_END; i++)
3309 gfc_free_interface (ns->op[i]);
3311 gfc_free_data (ns->data);
3315 /* Recursively free any contained namespaces. */
3320 gfc_free_namespace (q);
3326 gfc_symbol_init_2 (void)
3329 gfc_current_ns = gfc_get_namespace (NULL, 0);
3334 gfc_symbol_done_2 (void)
3337 gfc_free_namespace (gfc_current_ns);
3338 gfc_current_ns = NULL;
3339 gfc_free_dt_list ();
3343 /* Clear mark bits from symbol nodes associated with a symtree node. */
3346 clear_sym_mark (gfc_symtree *st)
3349 st->n.sym->mark = 0;
3353 /* Recursively traverse the symtree nodes. */
3356 gfc_traverse_symtree (gfc_symtree *st, void (*func) (gfc_symtree *))
3361 gfc_traverse_symtree (st->left, func);
3363 gfc_traverse_symtree (st->right, func);
3367 /* Recursive namespace traversal function. */
3370 traverse_ns (gfc_symtree *st, void (*func) (gfc_symbol *))
3376 traverse_ns (st->left, func);
3378 if (st->n.sym->mark == 0)
3379 (*func) (st->n.sym);
3380 st->n.sym->mark = 1;
3382 traverse_ns (st->right, func);
3386 /* Call a given function for all symbols in the namespace. We take
3387 care that each gfc_symbol node is called exactly once. */
3390 gfc_traverse_ns (gfc_namespace *ns, void (*func) (gfc_symbol *))
3393 gfc_traverse_symtree (ns->sym_root, clear_sym_mark);
3395 traverse_ns (ns->sym_root, func);
3399 /* Return TRUE when name is the name of an intrinsic type. */
3402 gfc_is_intrinsic_typename (const char *name)
3404 if (strcmp (name, "integer") == 0
3405 || strcmp (name, "real") == 0
3406 || strcmp (name, "character") == 0
3407 || strcmp (name, "logical") == 0
3408 || strcmp (name, "complex") == 0
3409 || strcmp (name, "doubleprecision") == 0
3410 || strcmp (name, "doublecomplex") == 0)
3417 /* Return TRUE if the symbol is an automatic variable. */
3420 gfc_is_var_automatic (gfc_symbol *sym)
3422 /* Pointer and allocatable variables are never automatic. */
3423 if (sym->attr.pointer || sym->attr.allocatable)
3425 /* Check for arrays with non-constant size. */
3426 if (sym->attr.dimension && sym->as
3427 && !gfc_is_compile_time_shape (sym->as))
3429 /* Check for non-constant length character variables. */
3430 if (sym->ts.type == BT_CHARACTER
3432 && !gfc_is_constant_expr (sym->ts.u.cl->length))
3437 /* Given a symbol, mark it as SAVEd if it is allowed. */
3440 save_symbol (gfc_symbol *sym)
3443 if (sym->attr.use_assoc)
3446 if (sym->attr.in_common
3449 || sym->attr.flavor != FL_VARIABLE)
3451 /* Automatic objects are not saved. */
3452 if (gfc_is_var_automatic (sym))
3454 gfc_add_save (&sym->attr, SAVE_EXPLICIT, sym->name, &sym->declared_at);
3458 /* Mark those symbols which can be SAVEd as such. */
3461 gfc_save_all (gfc_namespace *ns)
3463 gfc_traverse_ns (ns, save_symbol);
3467 /* Make sure that no changes to symbols are pending. */
3470 gfc_enforce_clean_symbol_state(void)
3472 gcc_assert (changed_syms == NULL);
3476 /************** Global symbol handling ************/
3479 /* Search a tree for the global symbol. */
3482 gfc_find_gsymbol (gfc_gsymbol *symbol, const char *name)
3491 c = strcmp (name, symbol->name);
3495 symbol = (c < 0) ? symbol->left : symbol->right;
3502 /* Compare two global symbols. Used for managing the BB tree. */
3505 gsym_compare (void *_s1, void *_s2)
3507 gfc_gsymbol *s1, *s2;
3509 s1 = (gfc_gsymbol *) _s1;
3510 s2 = (gfc_gsymbol *) _s2;
3511 return strcmp (s1->name, s2->name);
3515 /* Get a global symbol, creating it if it doesn't exist. */
3518 gfc_get_gsymbol (const char *name)
3522 s = gfc_find_gsymbol (gfc_gsym_root, name);
3526 s = XCNEW (gfc_gsymbol);
3527 s->type = GSYM_UNKNOWN;
3528 s->name = gfc_get_string (name);
3530 gfc_insert_bbt (&gfc_gsym_root, s, gsym_compare);
3537 get_iso_c_binding_dt (int sym_id)
3539 gfc_dt_list *dt_list;
3541 dt_list = gfc_derived_types;
3543 /* Loop through the derived types in the name list, searching for
3544 the desired symbol from iso_c_binding. Search the parent namespaces
3545 if necessary and requested to (parent_flag). */
3546 while (dt_list != NULL)
3548 if (dt_list->derived->from_intmod != INTMOD_NONE
3549 && dt_list->derived->intmod_sym_id == sym_id)
3550 return dt_list->derived;
3552 dt_list = dt_list->next;
3559 /* Verifies that the given derived type symbol, derived_sym, is interoperable
3560 with C. This is necessary for any derived type that is BIND(C) and for
3561 derived types that are parameters to functions that are BIND(C). All
3562 fields of the derived type are required to be interoperable, and are tested
3563 for such. If an error occurs, the errors are reported here, allowing for
3564 multiple errors to be handled for a single derived type. */
3567 verify_bind_c_derived_type (gfc_symbol *derived_sym)
3569 gfc_component *curr_comp = NULL;
3570 gfc_try is_c_interop = FAILURE;
3571 gfc_try retval = SUCCESS;
3573 if (derived_sym == NULL)
3574 gfc_internal_error ("verify_bind_c_derived_type(): Given symbol is "
3575 "unexpectedly NULL");
3577 /* If we've already looked at this derived symbol, do not look at it again
3578 so we don't repeat warnings/errors. */
3579 if (derived_sym->ts.is_c_interop)
3582 /* The derived type must have the BIND attribute to be interoperable
3583 J3/04-007, Section 15.2.3. */
3584 if (derived_sym->attr.is_bind_c != 1)
3586 derived_sym->ts.is_c_interop = 0;
3587 gfc_error_now ("Derived type '%s' declared at %L must have the BIND "
3588 "attribute to be C interoperable", derived_sym->name,
3589 &(derived_sym->declared_at));
3593 curr_comp = derived_sym->components;
3595 /* TODO: is this really an error? */
3596 if (curr_comp == NULL)
3598 gfc_error ("Derived type '%s' at %L is empty",
3599 derived_sym->name, &(derived_sym->declared_at));
3603 /* Initialize the derived type as being C interoperable.
3604 If we find an error in the components, this will be set false. */
3605 derived_sym->ts.is_c_interop = 1;
3607 /* Loop through the list of components to verify that the kind of
3608 each is a C interoperable type. */
3611 /* The components cannot be pointers (fortran sense).
3612 J3/04-007, Section 15.2.3, C1505. */
3613 if (curr_comp->attr.pointer != 0)
3615 gfc_error ("Component '%s' at %L cannot have the "
3616 "POINTER attribute because it is a member "
3617 "of the BIND(C) derived type '%s' at %L",
3618 curr_comp->name, &(curr_comp->loc),
3619 derived_sym->name, &(derived_sym->declared_at));
3623 if (curr_comp->attr.proc_pointer != 0)
3625 gfc_error ("Procedure pointer component '%s' at %L cannot be a member"
3626 " of the BIND(C) derived type '%s' at %L", curr_comp->name,
3627 &curr_comp->loc, derived_sym->name,
3628 &derived_sym->declared_at);
3632 /* The components cannot be allocatable.
3633 J3/04-007, Section 15.2.3, C1505. */
3634 if (curr_comp->attr.allocatable != 0)
3636 gfc_error ("Component '%s' at %L cannot have the "
3637 "ALLOCATABLE attribute because it is a member "
3638 "of the BIND(C) derived type '%s' at %L",
3639 curr_comp->name, &(curr_comp->loc),
3640 derived_sym->name, &(derived_sym->declared_at));
3644 /* BIND(C) derived types must have interoperable components. */
3645 if (curr_comp->ts.type == BT_DERIVED
3646 && curr_comp->ts.u.derived->ts.is_iso_c != 1
3647 && curr_comp->ts.u.derived != derived_sym)
3649 /* This should be allowed; the draft says a derived-type can not
3650 have type parameters if it is has the BIND attribute. Type
3651 parameters seem to be for making parameterized derived types.
3652 There's no need to verify the type if it is c_ptr/c_funptr. */
3653 retval = verify_bind_c_derived_type (curr_comp->ts.u.derived);
3657 /* Grab the typespec for the given component and test the kind. */
3658 is_c_interop = verify_c_interop (&(curr_comp->ts));
3660 if (is_c_interop != SUCCESS)
3662 /* Report warning and continue since not fatal. The
3663 draft does specify a constraint that requires all fields
3664 to interoperate, but if the user says real(4), etc., it
3665 may interoperate with *something* in C, but the compiler
3666 most likely won't know exactly what. Further, it may not
3667 interoperate with the same data type(s) in C if the user
3668 recompiles with different flags (e.g., -m32 and -m64 on
3669 x86_64 and using integer(4) to claim interop with a
3671 if (derived_sym->attr.is_bind_c == 1)
3672 /* If the derived type is bind(c), all fields must be
3674 gfc_warning ("Component '%s' in derived type '%s' at %L "
3675 "may not be C interoperable, even though "
3676 "derived type '%s' is BIND(C)",
3677 curr_comp->name, derived_sym->name,
3678 &(curr_comp->loc), derived_sym->name);
3680 /* If derived type is param to bind(c) routine, or to one
3681 of the iso_c_binding procs, it must be interoperable, so
3682 all fields must interop too. */
3683 gfc_warning ("Component '%s' in derived type '%s' at %L "
3684 "may not be C interoperable",
3685 curr_comp->name, derived_sym->name,
3690 curr_comp = curr_comp->next;
3691 } while (curr_comp != NULL);
3694 /* Make sure we don't have conflicts with the attributes. */
3695 if (derived_sym->attr.access == ACCESS_PRIVATE)
3697 gfc_error ("Derived type '%s' at %L cannot be declared with both "
3698 "PRIVATE and BIND(C) attributes", derived_sym->name,
3699 &(derived_sym->declared_at));
3703 if (derived_sym->attr.sequence != 0)
3705 gfc_error ("Derived type '%s' at %L cannot have the SEQUENCE "
3706 "attribute because it is BIND(C)", derived_sym->name,
3707 &(derived_sym->declared_at));
3711 /* Mark the derived type as not being C interoperable if we found an
3712 error. If there were only warnings, proceed with the assumption
3713 it's interoperable. */
3714 if (retval == FAILURE)
3715 derived_sym->ts.is_c_interop = 0;
3721 /* Generate symbols for the named constants c_null_ptr and c_null_funptr. */
3724 gen_special_c_interop_ptr (int ptr_id, const char *ptr_name,
3725 const char *module_name)
3727 gfc_symtree *tmp_symtree;
3728 gfc_symbol *tmp_sym;
3731 tmp_symtree = gfc_find_symtree (gfc_current_ns->sym_root, ptr_name);
3733 if (tmp_symtree != NULL)
3734 tmp_sym = tmp_symtree->n.sym;
3738 gfc_internal_error ("gen_special_c_interop_ptr(): Unable to "
3739 "create symbol for %s", ptr_name);
3742 /* Set up the symbol's important fields. Save attr required so we can
3743 initialize the ptr to NULL. */
3744 tmp_sym->attr.save = SAVE_EXPLICIT;
3745 tmp_sym->ts.is_c_interop = 1;
3746 tmp_sym->attr.is_c_interop = 1;
3747 tmp_sym->ts.is_iso_c = 1;
3748 tmp_sym->ts.type = BT_DERIVED;
3750 /* The c_ptr and c_funptr derived types will provide the
3751 definition for c_null_ptr and c_null_funptr, respectively. */
3752 if (ptr_id == ISOCBINDING_NULL_PTR)
3753 tmp_sym->ts.u.derived = get_iso_c_binding_dt (ISOCBINDING_PTR);
3755 tmp_sym->ts.u.derived = get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
3756 if (tmp_sym->ts.u.derived == NULL)
3758 /* This can occur if the user forgot to declare c_ptr or
3759 c_funptr and they're trying to use one of the procedures
3760 that has arg(s) of the missing type. In this case, a
3761 regular version of the thing should have been put in the
3763 generate_isocbinding_symbol (module_name, ptr_id == ISOCBINDING_NULL_PTR
3764 ? ISOCBINDING_PTR : ISOCBINDING_FUNPTR,
3765 (const char *) (ptr_id == ISOCBINDING_NULL_PTR
3766 ? "_gfortran_iso_c_binding_c_ptr"
3767 : "_gfortran_iso_c_binding_c_funptr"));
3769 tmp_sym->ts.u.derived =
3770 get_iso_c_binding_dt (ptr_id == ISOCBINDING_NULL_PTR
3771 ? ISOCBINDING_PTR : ISOCBINDING_FUNPTR);
3774 /* Module name is some mangled version of iso_c_binding. */
3775 tmp_sym->module = gfc_get_string (module_name);
3777 /* Say it's from the iso_c_binding module. */
3778 tmp_sym->attr.is_iso_c = 1;
3780 tmp_sym->attr.use_assoc = 1;
3781 tmp_sym->attr.is_bind_c = 1;
3782 /* Set the binding_label. */
3783 sprintf (tmp_sym->binding_label, "%s_%s", module_name, tmp_sym->name);
3785 /* Set the c_address field of c_null_ptr and c_null_funptr to
3786 the value of NULL. */
3787 tmp_sym->value = gfc_get_expr ();
3788 tmp_sym->value->expr_type = EXPR_STRUCTURE;
3789 tmp_sym->value->ts.type = BT_DERIVED;
3790 tmp_sym->value->ts.u.derived = tmp_sym->ts.u.derived;
3791 gfc_constructor_append_expr (&tmp_sym->value->value.constructor, NULL, NULL);
3792 c = gfc_constructor_first (tmp_sym->value->value.constructor);
3793 c->expr = gfc_get_expr ();
3794 c->expr->expr_type = EXPR_NULL;
3795 c->expr->ts.is_iso_c = 1;
3796 /* Must declare c_null_ptr and c_null_funptr as having the
3797 PARAMETER attribute so they can be used in init expressions. */
3798 tmp_sym->attr.flavor = FL_PARAMETER;
3804 /* Add a formal argument, gfc_formal_arglist, to the
3805 end of the given list of arguments. Set the reference to the
3806 provided symbol, param_sym, in the argument. */
3809 add_formal_arg (gfc_formal_arglist **head,
3810 gfc_formal_arglist **tail,
3811 gfc_formal_arglist *formal_arg,
3812 gfc_symbol *param_sym)
3814 /* Put in list, either as first arg or at the tail (curr arg). */
3816 *head = *tail = formal_arg;
3819 (*tail)->next = formal_arg;
3820 (*tail) = formal_arg;
3823 (*tail)->sym = param_sym;
3824 (*tail)->next = NULL;
3830 /* Generates a symbol representing the CPTR argument to an
3831 iso_c_binding procedure. Also, create a gfc_formal_arglist for the
3832 CPTR and add it to the provided argument list. */
3835 gen_cptr_param (gfc_formal_arglist **head,
3836 gfc_formal_arglist **tail,
3837 const char *module_name,
3838 gfc_namespace *ns, const char *c_ptr_name,
3841 gfc_symbol *param_sym = NULL;
3842 gfc_symbol *c_ptr_sym = NULL;
3843 gfc_symtree *param_symtree = NULL;
3844 gfc_formal_arglist *formal_arg = NULL;
3845 const char *c_ptr_in;
3846 const char *c_ptr_type = NULL;
3848 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3849 c_ptr_type = "_gfortran_iso_c_binding_c_funptr";
3851 c_ptr_type = "_gfortran_iso_c_binding_c_ptr";
3853 if(c_ptr_name == NULL)
3854 c_ptr_in = "gfc_cptr__";
3856 c_ptr_in = c_ptr_name;
3857 gfc_get_sym_tree (c_ptr_in, ns, ¶m_symtree, false);
3858 if (param_symtree != NULL)
3859 param_sym = param_symtree->n.sym;
3861 gfc_internal_error ("gen_cptr_param(): Unable to "
3862 "create symbol for %s", c_ptr_in);
3864 /* Set up the appropriate fields for the new c_ptr param sym. */
3866 param_sym->attr.flavor = FL_DERIVED;
3867 param_sym->ts.type = BT_DERIVED;
3868 param_sym->attr.intent = INTENT_IN;
3869 param_sym->attr.dummy = 1;
3871 /* This will pass the ptr to the iso_c routines as a (void *). */
3872 param_sym->attr.value = 1;
3873 param_sym->attr.use_assoc = 1;
3875 /* Get the symbol for c_ptr or c_funptr, no matter what it's name is
3877 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3878 c_ptr_sym = get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
3880 c_ptr_sym = get_iso_c_binding_dt (ISOCBINDING_PTR);
3881 if (c_ptr_sym == NULL)
3883 /* This can happen if the user did not define c_ptr but they are
3884 trying to use one of the iso_c_binding functions that need it. */
3885 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3886 generate_isocbinding_symbol (module_name, ISOCBINDING_FUNPTR,
3887 (const char *)c_ptr_type);
3889 generate_isocbinding_symbol (module_name, ISOCBINDING_PTR,
3890 (const char *)c_ptr_type);
3892 gfc_get_ha_symbol (c_ptr_type, &(c_ptr_sym));
3895 param_sym->ts.u.derived = c_ptr_sym;
3896 param_sym->module = gfc_get_string (module_name);
3898 /* Make new formal arg. */
3899 formal_arg = gfc_get_formal_arglist ();
3900 /* Add arg to list of formal args (the CPTR arg). */
3901 add_formal_arg (head, tail, formal_arg, param_sym);
3903 /* Validate changes. */
3904 gfc_commit_symbol (param_sym);
3908 /* Generates a symbol representing the FPTR argument to an
3909 iso_c_binding procedure. Also, create a gfc_formal_arglist for the
3910 FPTR and add it to the provided argument list. */
3913 gen_fptr_param (gfc_formal_arglist **head,
3914 gfc_formal_arglist **tail,
3915 const char *module_name,
3916 gfc_namespace *ns, const char *f_ptr_name, int proc)
3918 gfc_symbol *param_sym = NULL;
3919 gfc_symtree *param_symtree = NULL;
3920 gfc_formal_arglist *formal_arg = NULL;
3921 const char *f_ptr_out = "gfc_fptr__";
3923 if (f_ptr_name != NULL)
3924 f_ptr_out = f_ptr_name;
3926 gfc_get_sym_tree (f_ptr_out, ns, ¶m_symtree, false);
3927 if (param_symtree != NULL)
3928 param_sym = param_symtree->n.sym;
3930 gfc_internal_error ("generateFPtrParam(): Unable to "
3931 "create symbol for %s", f_ptr_out);
3933 /* Set up the necessary fields for the fptr output param sym. */
3936 param_sym->attr.proc_pointer = 1;
3938 param_sym->attr.pointer = 1;
3939 param_sym->attr.dummy = 1;
3940 param_sym->attr.use_assoc = 1;
3942 /* ISO C Binding type to allow any pointer type as actual param. */
3943 param_sym->ts.type = BT_VOID;
3944 param_sym->module = gfc_get_string (module_name);
3947 formal_arg = gfc_get_formal_arglist ();
3948 /* Add arg to list of formal args. */
3949 add_formal_arg (head, tail, formal_arg, param_sym);
3951 /* Validate changes. */
3952 gfc_commit_symbol (param_sym);
3956 /* Generates a symbol representing the optional SHAPE argument for the
3957 iso_c_binding c_f_pointer() procedure. Also, create a
3958 gfc_formal_arglist for the SHAPE and add it to the provided
3962 gen_shape_param (gfc_formal_arglist **head,
3963 gfc_formal_arglist **tail,
3964 const char *module_name,
3965 gfc_namespace *ns, const char *shape_param_name)
3967 gfc_symbol *param_sym = NULL;
3968 gfc_symtree *param_symtree = NULL;
3969 gfc_formal_arglist *formal_arg = NULL;
3970 const char *shape_param = "gfc_shape_array__";
3972 if (shape_param_name != NULL)
3973 shape_param = shape_param_name;
3975 gfc_get_sym_tree (shape_param, ns, ¶m_symtree, false);
3976 if (param_symtree != NULL)
3977 param_sym = param_symtree->n.sym;
3979 gfc_internal_error ("generateShapeParam(): Unable to "
3980 "create symbol for %s", shape_param);
3982 /* Set up the necessary fields for the shape input param sym. */
3984 param_sym->attr.dummy = 1;
3985 param_sym->attr.use_assoc = 1;
3987 /* Integer array, rank 1, describing the shape of the object. Make it's
3988 type BT_VOID initially so we can accept any type/kind combination of
3989 integer. During gfc_iso_c_sub_interface (resolve.c), we'll make it
3990 of BT_INTEGER type. */
3991 param_sym->ts.type = BT_VOID;
3993 /* Initialize the kind to default integer. However, it will be overridden
3994 during resolution to match the kind of the SHAPE parameter given as
3995 the actual argument (to allow for any valid integer kind). */
3996 param_sym->ts.kind = gfc_default_integer_kind;
3997 param_sym->as = gfc_get_array_spec ();
3999 param_sym->as->rank = 1;
4000 param_sym->as->lower[0] = gfc_get_int_expr (gfc_default_integer_kind,
4003 /* The extent is unknown until we get it. The length give us
4004 the rank the incoming pointer. */
4005 param_sym->as->type = AS_ASSUMED_SHAPE;
4007 /* The arg is also optional; it is required iff the second arg
4008 (fptr) is to an array, otherwise, it's ignored. */
4009 param_sym->attr.optional = 1;
4010 param_sym->attr.intent = INTENT_IN;
4011 param_sym->attr.dimension = 1;
4012 param_sym->module = gfc_get_string (module_name);
4015 formal_arg = gfc_get_formal_arglist ();
4016 /* Add arg to list of formal args. */
4017 add_formal_arg (head, tail, formal_arg, param_sym);
4019 /* Validate changes. */
4020 gfc_commit_symbol (param_sym);
4024 /* Add a procedure interface to the given symbol (i.e., store a
4025 reference to the list of formal arguments). */
4028 add_proc_interface (gfc_symbol *sym, ifsrc source,
4029 gfc_formal_arglist *formal)
4032 sym->formal = formal;
4033 sym->attr.if_source = source;
4037 /* Copy the formal args from an existing symbol, src, into a new
4038 symbol, dest. New formal args are created, and the description of
4039 each arg is set according to the existing ones. This function is
4040 used when creating procedure declaration variables from a procedure
4041 declaration statement (see match_proc_decl()) to create the formal
4042 args based on the args of a given named interface. */
4045 gfc_copy_formal_args (gfc_symbol *dest, gfc_symbol *src)
4047 gfc_formal_arglist *head = NULL;
4048 gfc_formal_arglist *tail = NULL;
4049 gfc_formal_arglist *formal_arg = NULL;
4050 gfc_formal_arglist *curr_arg = NULL;
4051 gfc_formal_arglist *formal_prev = NULL;
4052 /* Save current namespace so we can change it for formal args. */
4053 gfc_namespace *parent_ns = gfc_current_ns;
4055 /* Create a new namespace, which will be the formal ns (namespace
4056 of the formal args). */
4057 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4058 gfc_current_ns->proc_name = dest;
4060 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4062 formal_arg = gfc_get_formal_arglist ();
4063 gfc_get_symbol (curr_arg->sym->name, gfc_current_ns, &(formal_arg->sym));
4065 /* May need to copy more info for the symbol. */
4066 formal_arg->sym->attr = curr_arg->sym->attr;
4067 formal_arg->sym->ts = curr_arg->sym->ts;
4068 formal_arg->sym->as = gfc_copy_array_spec (curr_arg->sym->as);
4069 gfc_copy_formal_args (formal_arg->sym, curr_arg->sym);
4071 /* If this isn't the first arg, set up the next ptr. For the
4072 last arg built, the formal_arg->next will never get set to
4073 anything other than NULL. */
4074 if (formal_prev != NULL)
4075 formal_prev->next = formal_arg;
4077 formal_arg->next = NULL;
4079 formal_prev = formal_arg;
4081 /* Add arg to list of formal args. */
4082 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4084 /* Validate changes. */
4085 gfc_commit_symbol (formal_arg->sym);
4088 /* Add the interface to the symbol. */
4089 add_proc_interface (dest, IFSRC_DECL, head);
4091 /* Store the formal namespace information. */
4092 if (dest->formal != NULL)
4093 /* The current ns should be that for the dest proc. */
4094 dest->formal_ns = gfc_current_ns;
4095 /* Restore the current namespace to what it was on entry. */
4096 gfc_current_ns = parent_ns;
4101 gfc_copy_formal_args_intr (gfc_symbol *dest, gfc_intrinsic_sym *src)
4103 gfc_formal_arglist *head = NULL;
4104 gfc_formal_arglist *tail = NULL;
4105 gfc_formal_arglist *formal_arg = NULL;
4106 gfc_intrinsic_arg *curr_arg = NULL;
4107 gfc_formal_arglist *formal_prev = NULL;
4108 /* Save current namespace so we can change it for formal args. */
4109 gfc_namespace *parent_ns = gfc_current_ns;
4111 /* Create a new namespace, which will be the formal ns (namespace
4112 of the formal args). */
4113 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4114 gfc_current_ns->proc_name = dest;
4116 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4118 formal_arg = gfc_get_formal_arglist ();
4119 gfc_get_symbol (curr_arg->name, gfc_current_ns, &(formal_arg->sym));
4121 /* May need to copy more info for the symbol. */
4122 formal_arg->sym->ts = curr_arg->ts;
4123 formal_arg->sym->attr.optional = curr_arg->optional;
4124 formal_arg->sym->attr.value = curr_arg->value;
4125 formal_arg->sym->attr.intent = curr_arg->intent;
4126 formal_arg->sym->attr.flavor = FL_VARIABLE;
4127 formal_arg->sym->attr.dummy = 1;
4129 if (formal_arg->sym->ts.type == BT_CHARACTER)
4130 formal_arg->sym->ts.u.cl = gfc_new_charlen (gfc_current_ns, NULL);
4132 /* If this isn't the first arg, set up the next ptr. For the
4133 last arg built, the formal_arg->next will never get set to
4134 anything other than NULL. */
4135 if (formal_prev != NULL)
4136 formal_prev->next = formal_arg;
4138 formal_arg->next = NULL;
4140 formal_prev = formal_arg;
4142 /* Add arg to list of formal args. */
4143 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4145 /* Validate changes. */
4146 gfc_commit_symbol (formal_arg->sym);
4149 /* Add the interface to the symbol. */
4150 add_proc_interface (dest, IFSRC_DECL, head);
4152 /* Store the formal namespace information. */
4153 if (dest->formal != NULL)
4154 /* The current ns should be that for the dest proc. */
4155 dest->formal_ns = gfc_current_ns;
4156 /* Restore the current namespace to what it was on entry. */
4157 gfc_current_ns = parent_ns;
4162 gfc_copy_formal_args_ppc (gfc_component *dest, gfc_symbol *src)
4164 gfc_formal_arglist *head = NULL;
4165 gfc_formal_arglist *tail = NULL;
4166 gfc_formal_arglist *formal_arg = NULL;
4167 gfc_formal_arglist *curr_arg = NULL;
4168 gfc_formal_arglist *formal_prev = NULL;
4169 /* Save current namespace so we can change it for formal args. */
4170 gfc_namespace *parent_ns = gfc_current_ns;
4172 /* Create a new namespace, which will be the formal ns (namespace
4173 of the formal args). */
4174 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4175 /* TODO: gfc_current_ns->proc_name = dest;*/
4177 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4179 formal_arg = gfc_get_formal_arglist ();
4180 gfc_get_symbol (curr_arg->sym->name, gfc_current_ns, &(formal_arg->sym));
4182 /* May need to copy more info for the symbol. */
4183 formal_arg->sym->attr = curr_arg->sym->attr;
4184 formal_arg->sym->ts = curr_arg->sym->ts;
4185 formal_arg->sym->as = gfc_copy_array_spec (curr_arg->sym->as);
4186 gfc_copy_formal_args (formal_arg->sym, curr_arg->sym);
4188 /* If this isn't the first arg, set up the next ptr. For the
4189 last arg built, the formal_arg->next will never get set to
4190 anything other than NULL. */
4191 if (formal_prev != NULL)
4192 formal_prev->next = formal_arg;
4194 formal_arg->next = NULL;
4196 formal_prev = formal_arg;
4198 /* Add arg to list of formal args. */
4199 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4201 /* Validate changes. */
4202 gfc_commit_symbol (formal_arg->sym);
4205 /* Add the interface to the symbol. */
4206 dest->formal = head;
4207 dest->attr.if_source = IFSRC_DECL;
4209 /* Store the formal namespace information. */
4210 if (dest->formal != NULL)
4211 /* The current ns should be that for the dest proc. */
4212 dest->formal_ns = gfc_current_ns;
4213 /* Restore the current namespace to what it was on entry. */
4214 gfc_current_ns = parent_ns;
4218 /* Builds the parameter list for the iso_c_binding procedure
4219 c_f_pointer or c_f_procpointer. The old_sym typically refers to a
4220 generic version of either the c_f_pointer or c_f_procpointer
4221 functions. The new_proc_sym represents a "resolved" version of the
4222 symbol. The functions are resolved to match the types of their
4223 parameters; for example, c_f_pointer(cptr, fptr) would resolve to
4224 something similar to c_f_pointer_i4 if the type of data object fptr
4225 pointed to was a default integer. The actual name of the resolved
4226 procedure symbol is further mangled with the module name, etc., but
4227 the idea holds true. */
4230 build_formal_args (gfc_symbol *new_proc_sym,
4231 gfc_symbol *old_sym, int add_optional_arg)
4233 gfc_formal_arglist *head = NULL, *tail = NULL;
4234 gfc_namespace *parent_ns = NULL;
4236 parent_ns = gfc_current_ns;
4237 /* Create a new namespace, which will be the formal ns (namespace
4238 of the formal args). */
4239 gfc_current_ns = gfc_get_namespace(parent_ns, 0);
4240 gfc_current_ns->proc_name = new_proc_sym;
4242 /* Generate the params. */
4243 if (old_sym->intmod_sym_id == ISOCBINDING_F_PROCPOINTER)
4245 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4246 gfc_current_ns, "cptr", old_sym->intmod_sym_id);
4247 gen_fptr_param (&head, &tail, (const char *) new_proc_sym->module,
4248 gfc_current_ns, "fptr", 1);
4250 else if (old_sym->intmod_sym_id == ISOCBINDING_F_POINTER)
4252 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4253 gfc_current_ns, "cptr", old_sym->intmod_sym_id);
4254 gen_fptr_param (&head, &tail, (const char *) new_proc_sym->module,
4255 gfc_current_ns, "fptr", 0);
4256 /* If we're dealing with c_f_pointer, it has an optional third arg. */
4257 gen_shape_param (&head, &tail,(const char *) new_proc_sym->module,
4258 gfc_current_ns, "shape");
4261 else if (old_sym->intmod_sym_id == ISOCBINDING_ASSOCIATED)
4263 /* c_associated has one required arg and one optional; both
4265 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4266 gfc_current_ns, "c_ptr_1", ISOCBINDING_ASSOCIATED);
4267 if (add_optional_arg)
4269 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4270 gfc_current_ns, "c_ptr_2", ISOCBINDING_ASSOCIATED);
4271 /* The last param is optional so mark it as such. */
4272 tail->sym->attr.optional = 1;
4276 /* Add the interface (store formal args to new_proc_sym). */
4277 add_proc_interface (new_proc_sym, IFSRC_DECL, head);
4279 /* Set up the formal_ns pointer to the one created for the
4280 new procedure so it'll get cleaned up during gfc_free_symbol(). */
4281 new_proc_sym->formal_ns = gfc_current_ns;
4283 gfc_current_ns = parent_ns;
4287 std_for_isocbinding_symbol (int id)
4291 #define NAMED_INTCST(a,b,c,d) \
4294 #include "iso-c-binding.def"
4297 #define NAMED_FUNCTION(a,b,c,d) \
4300 #include "iso-c-binding.def"
4301 #undef NAMED_FUNCTION
4304 return GFC_STD_F2003;
4308 /* Generate the given set of C interoperable kind objects, or all
4309 interoperable kinds. This function will only be given kind objects
4310 for valid iso_c_binding defined types because this is verified when
4311 the 'use' statement is parsed. If the user gives an 'only' clause,
4312 the specific kinds are looked up; if they don't exist, an error is
4313 reported. If the user does not give an 'only' clause, all
4314 iso_c_binding symbols are generated. If a list of specific kinds
4315 is given, it must have a NULL in the first empty spot to mark the
4320 generate_isocbinding_symbol (const char *mod_name, iso_c_binding_symbol s,
4321 const char *local_name)
4323 const char *const name = (local_name && local_name[0]) ? local_name
4324 : c_interop_kinds_table[s].name;
4325 gfc_symtree *tmp_symtree = NULL;
4326 gfc_symbol *tmp_sym = NULL;
4327 gfc_dt_list **dt_list_ptr = NULL;
4328 gfc_component *tmp_comp = NULL;
4329 char comp_name[(GFC_MAX_SYMBOL_LEN * 2) + 1];
4332 if (gfc_notification_std (std_for_isocbinding_symbol (s)) == ERROR)
4334 tmp_symtree = gfc_find_symtree (gfc_current_ns->sym_root, name);
4336 /* Already exists in this scope so don't re-add it.
4337 TODO: we should probably check that it's really the same symbol. */
4338 if (tmp_symtree != NULL)
4341 /* Create the sym tree in the current ns. */
4342 gfc_get_sym_tree (name, gfc_current_ns, &tmp_symtree, false);
4344 tmp_sym = tmp_symtree->n.sym;
4346 gfc_internal_error ("generate_isocbinding_symbol(): Unable to "
4349 /* Say what module this symbol belongs to. */
4350 tmp_sym->module = gfc_get_string (mod_name);
4351 tmp_sym->from_intmod = INTMOD_ISO_C_BINDING;
4352 tmp_sym->intmod_sym_id = s;
4357 #define NAMED_INTCST(a,b,c,d) case a :
4358 #define NAMED_REALCST(a,b,c) case a :
4359 #define NAMED_CMPXCST(a,b,c) case a :
4360 #define NAMED_LOGCST(a,b,c) case a :
4361 #define NAMED_CHARKNDCST(a,b,c) case a :
4362 #include "iso-c-binding.def"
4364 tmp_sym->value = gfc_get_int_expr (gfc_default_integer_kind, NULL,
4365 c_interop_kinds_table[s].value);
4367 /* Initialize an integer constant expression node. */
4368 tmp_sym->attr.flavor = FL_PARAMETER;
4369 tmp_sym->ts.type = BT_INTEGER;
4370 tmp_sym->ts.kind = gfc_default_integer_kind;
4372 /* Mark this type as a C interoperable one. */
4373 tmp_sym->ts.is_c_interop = 1;
4374 tmp_sym->ts.is_iso_c = 1;
4375 tmp_sym->value->ts.is_c_interop = 1;
4376 tmp_sym->value->ts.is_iso_c = 1;
4377 tmp_sym->attr.is_c_interop = 1;
4379 /* Tell what f90 type this c interop kind is valid. */
4380 tmp_sym->ts.f90_type = c_interop_kinds_table[s].f90_type;
4382 /* Say it's from the iso_c_binding module. */
4383 tmp_sym->attr.is_iso_c = 1;
4385 /* Make it use associated. */
4386 tmp_sym->attr.use_assoc = 1;
4390 #define NAMED_CHARCST(a,b,c) case a :
4391 #include "iso-c-binding.def"
4393 /* Initialize an integer constant expression node for the
4394 length of the character. */
4395 tmp_sym->value = gfc_get_character_expr (gfc_default_character_kind,
4396 &gfc_current_locus, NULL, 1);
4397 tmp_sym->value->ts.is_c_interop = 1;
4398 tmp_sym->value->ts.is_iso_c = 1;
4399 tmp_sym->value->value.character.length = 1;
4400 tmp_sym->value->value.character.string[0]
4401 = (gfc_char_t) c_interop_kinds_table[s].value;
4402 tmp_sym->ts.u.cl = gfc_new_charlen (gfc_current_ns, NULL);
4403 tmp_sym->ts.u.cl->length = gfc_get_int_expr (gfc_default_integer_kind,
4406 /* May not need this in both attr and ts, but do need in
4407 attr for writing module file. */
4408 tmp_sym->attr.is_c_interop = 1;
4410 tmp_sym->attr.flavor = FL_PARAMETER;
4411 tmp_sym->ts.type = BT_CHARACTER;
4413 /* Need to set it to the C_CHAR kind. */
4414 tmp_sym->ts.kind = gfc_default_character_kind;
4416 /* Mark this type as a C interoperable one. */
4417 tmp_sym->ts.is_c_interop = 1;
4418 tmp_sym->ts.is_iso_c = 1;
4420 /* Tell what f90 type this c interop kind is valid. */
4421 tmp_sym->ts.f90_type = BT_CHARACTER;
4423 /* Say it's from the iso_c_binding module. */
4424 tmp_sym->attr.is_iso_c = 1;
4426 /* Make it use associated. */
4427 tmp_sym->attr.use_assoc = 1;
4430 case ISOCBINDING_PTR:
4431 case ISOCBINDING_FUNPTR:
4433 /* Initialize an integer constant expression node. */
4434 tmp_sym->attr.flavor = FL_DERIVED;
4435 tmp_sym->ts.is_c_interop = 1;
4436 tmp_sym->attr.is_c_interop = 1;
4437 tmp_sym->attr.is_iso_c = 1;
4438 tmp_sym->ts.is_iso_c = 1;
4439 tmp_sym->ts.type = BT_DERIVED;
4441 /* A derived type must have the bind attribute to be
4442 interoperable (J3/04-007, Section 15.2.3), even though
4443 the binding label is not used. */
4444 tmp_sym->attr.is_bind_c = 1;
4446 tmp_sym->attr.referenced = 1;
4448 tmp_sym->ts.u.derived = tmp_sym;
4450 /* Add the symbol created for the derived type to the current ns. */
4451 dt_list_ptr = &(gfc_derived_types);
4452 while (*dt_list_ptr != NULL && (*dt_list_ptr)->next != NULL)
4453 dt_list_ptr = &((*dt_list_ptr)->next);
4455 /* There is already at least one derived type in the list, so append
4456 the one we're currently building for c_ptr or c_funptr. */
4457 if (*dt_list_ptr != NULL)
4458 dt_list_ptr = &((*dt_list_ptr)->next);
4459 (*dt_list_ptr) = gfc_get_dt_list ();
4460 (*dt_list_ptr)->derived = tmp_sym;
4461 (*dt_list_ptr)->next = NULL;
4463 /* Set up the component of the derived type, which will be
4464 an integer with kind equal to c_ptr_size. Mangle the name of
4465 the field for the c_address to prevent the curious user from
4466 trying to access it from Fortran. */
4467 sprintf (comp_name, "__%s_%s", tmp_sym->name, "c_address");
4468 gfc_add_component (tmp_sym, comp_name, &tmp_comp);
4469 if (tmp_comp == NULL)
4470 gfc_internal_error ("generate_isocbinding_symbol(): Unable to "
4471 "create component for c_address");
4473 tmp_comp->ts.type = BT_INTEGER;
4475 /* Set this because the module will need to read/write this field. */
4476 tmp_comp->ts.f90_type = BT_INTEGER;
4478 /* The kinds for c_ptr and c_funptr are the same. */
4479 index = get_c_kind ("c_ptr", c_interop_kinds_table);
4480 tmp_comp->ts.kind = c_interop_kinds_table[index].value;
4482 tmp_comp->attr.pointer = 0;
4483 tmp_comp->attr.dimension = 0;
4485 /* Mark the component as C interoperable. */
4486 tmp_comp->ts.is_c_interop = 1;
4488 /* Make it use associated (iso_c_binding module). */
4489 tmp_sym->attr.use_assoc = 1;
4492 case ISOCBINDING_NULL_PTR:
4493 case ISOCBINDING_NULL_FUNPTR:
4494 gen_special_c_interop_ptr (s, name, mod_name);
4497 case ISOCBINDING_F_POINTER:
4498 case ISOCBINDING_ASSOCIATED:
4499 case ISOCBINDING_LOC:
4500 case ISOCBINDING_FUNLOC:
4501 case ISOCBINDING_F_PROCPOINTER:
4503 tmp_sym->attr.proc = PROC_MODULE;
4505 /* Use the procedure's name as it is in the iso_c_binding module for
4506 setting the binding label in case the user renamed the symbol. */
4507 sprintf (tmp_sym->binding_label, "%s_%s", mod_name,
4508 c_interop_kinds_table[s].name);
4509 tmp_sym->attr.is_iso_c = 1;
4510 if (s == ISOCBINDING_F_POINTER || s == ISOCBINDING_F_PROCPOINTER)
4511 tmp_sym->attr.subroutine = 1;
4514 /* TODO! This needs to be finished more for the expr of the
4515 function or something!
4516 This may not need to be here, because trying to do c_loc
4518 if (s == ISOCBINDING_ASSOCIATED)
4520 tmp_sym->attr.function = 1;
4521 tmp_sym->ts.type = BT_LOGICAL;
4522 tmp_sym->ts.kind = gfc_default_logical_kind;
4523 tmp_sym->result = tmp_sym;
4527 /* Here, we're taking the simple approach. We're defining
4528 c_loc as an external identifier so the compiler will put
4529 what we expect on the stack for the address we want the
4531 tmp_sym->ts.type = BT_DERIVED;
4532 if (s == ISOCBINDING_LOC)
4533 tmp_sym->ts.u.derived =
4534 get_iso_c_binding_dt (ISOCBINDING_PTR);
4536 tmp_sym->ts.u.derived =
4537 get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
4539 if (tmp_sym->ts.u.derived == NULL)
4541 /* Create the necessary derived type so we can continue
4542 processing the file. */
4543 generate_isocbinding_symbol
4544 (mod_name, s == ISOCBINDING_FUNLOC
4545 ? ISOCBINDING_FUNPTR : ISOCBINDING_PTR,
4546 (const char *)(s == ISOCBINDING_FUNLOC
4547 ? "_gfortran_iso_c_binding_c_funptr"
4548 : "_gfortran_iso_c_binding_c_ptr"));
4549 tmp_sym->ts.u.derived =
4550 get_iso_c_binding_dt (s == ISOCBINDING_FUNLOC
4551 ? ISOCBINDING_FUNPTR
4555 /* The function result is itself (no result clause). */
4556 tmp_sym->result = tmp_sym;
4557 tmp_sym->attr.external = 1;
4558 tmp_sym->attr.use_assoc = 0;
4559 tmp_sym->attr.pure = 1;
4560 tmp_sym->attr.if_source = IFSRC_UNKNOWN;
4561 tmp_sym->attr.proc = PROC_UNKNOWN;
4565 tmp_sym->attr.flavor = FL_PROCEDURE;
4566 tmp_sym->attr.contained = 0;
4568 /* Try using this builder routine, with the new and old symbols
4569 both being the generic iso_c proc sym being created. This
4570 will create the formal args (and the new namespace for them).
4571 Don't build an arg list for c_loc because we're going to treat
4572 c_loc as an external procedure. */
4573 if (s != ISOCBINDING_LOC && s != ISOCBINDING_FUNLOC)
4574 /* The 1 says to add any optional args, if applicable. */
4575 build_formal_args (tmp_sym, tmp_sym, 1);
4577 /* Set this after setting up the symbol, to prevent error messages. */
4578 tmp_sym->attr.use_assoc = 1;
4580 /* This symbol will not be referenced directly. It will be
4581 resolved to the implementation for the given f90 kind. */
4582 tmp_sym->attr.referenced = 0;
4589 gfc_commit_symbol (tmp_sym);
4593 /* Creates a new symbol based off of an old iso_c symbol, with a new
4594 binding label. This function can be used to create a new,
4595 resolved, version of a procedure symbol for c_f_pointer or
4596 c_f_procpointer that is based on the generic symbols. A new
4597 parameter list is created for the new symbol using
4598 build_formal_args(). The add_optional_flag specifies whether the
4599 to add the optional SHAPE argument. The new symbol is
4603 get_iso_c_sym (gfc_symbol *old_sym, char *new_name,
4604 char *new_binding_label, int add_optional_arg)
4606 gfc_symtree *new_symtree = NULL;
4608 /* See if we have a symbol by that name already available, looking
4609 through any parent namespaces. */
4610 gfc_find_sym_tree (new_name, gfc_current_ns, 1, &new_symtree);
4611 if (new_symtree != NULL)
4612 /* Return the existing symbol. */
4613 return new_symtree->n.sym;
4615 /* Create the symtree/symbol, with attempted host association. */
4616 gfc_get_ha_sym_tree (new_name, &new_symtree);
4617 if (new_symtree == NULL)
4618 gfc_internal_error ("get_iso_c_sym(): Unable to create "
4619 "symtree for '%s'", new_name);
4621 /* Now fill in the fields of the resolved symbol with the old sym. */
4622 strcpy (new_symtree->n.sym->binding_label, new_binding_label);
4623 new_symtree->n.sym->attr = old_sym->attr;
4624 new_symtree->n.sym->ts = old_sym->ts;
4625 new_symtree->n.sym->module = gfc_get_string (old_sym->module);
4626 new_symtree->n.sym->from_intmod = old_sym->from_intmod;
4627 new_symtree->n.sym->intmod_sym_id = old_sym->intmod_sym_id;
4628 if (old_sym->attr.function)
4629 new_symtree->n.sym->result = new_symtree->n.sym;
4630 /* Build the formal arg list. */
4631 build_formal_args (new_symtree->n.sym, old_sym, add_optional_arg);
4633 gfc_commit_symbol (new_symtree->n.sym);
4635 return new_symtree->n.sym;
4639 /* Check that a symbol is already typed. If strict is not set, an untyped
4640 symbol is acceptable for non-standard-conforming mode. */
4643 gfc_check_symbol_typed (gfc_symbol* sym, gfc_namespace* ns,
4644 bool strict, locus where)
4648 if (gfc_matching_prefix)
4651 /* Check for the type and try to give it an implicit one. */
4652 if (sym->ts.type == BT_UNKNOWN
4653 && gfc_set_default_type (sym, 0, ns) == FAILURE)
4657 gfc_error ("Symbol '%s' is used before it is typed at %L",
4662 if (gfc_notify_std (GFC_STD_GNU,
4663 "Extension: Symbol '%s' is used before"
4664 " it is typed at %L", sym->name, &where) == FAILURE)
4668 /* Everything is ok. */
4673 /* Construct a typebound-procedure structure. Those are stored in a tentative
4674 list and marked `error' until symbols are committed. */
4677 gfc_get_typebound_proc (gfc_typebound_proc *tb0)
4679 gfc_typebound_proc *result;
4680 tentative_tbp *list_node;
4682 result = XCNEW (gfc_typebound_proc);
4687 list_node = XCNEW (tentative_tbp);
4688 list_node->next = tentative_tbp_list;
4689 list_node->proc = result;
4690 tentative_tbp_list = list_node;
4696 /* Get the super-type of a given derived type. */
4699 gfc_get_derived_super_type (gfc_symbol* derived)
4701 if (!derived->attr.extension)
4704 gcc_assert (derived->components);
4705 gcc_assert (derived->components->ts.type == BT_DERIVED);
4706 gcc_assert (derived->components->ts.u.derived);
4708 return derived->components->ts.u.derived;
4712 /* Get the ultimate super-type of a given derived type. */
4715 gfc_get_ultimate_derived_super_type (gfc_symbol* derived)
4717 if (!derived->attr.extension)
4720 derived = gfc_get_derived_super_type (derived);
4722 if (derived->attr.extension)
4723 return gfc_get_ultimate_derived_super_type (derived);
4729 /* Check if a derived type t2 is an extension of (or equal to) a type t1. */
4732 gfc_type_is_extension_of (gfc_symbol *t1, gfc_symbol *t2)
4734 while (!gfc_compare_derived_types (t1, t2) && t2->attr.extension)
4735 t2 = gfc_get_derived_super_type (t2);
4736 return gfc_compare_derived_types (t1, t2);
4740 /* Check if two typespecs are type compatible (F03:5.1.1.2):
4741 If ts1 is nonpolymorphic, ts2 must be the same type.
4742 If ts1 is polymorphic (CLASS), ts2 must be an extension of ts1. */
4745 gfc_type_compatible (gfc_typespec *ts1, gfc_typespec *ts2)
4747 bool is_class1 = (ts1->type == BT_CLASS);
4748 bool is_class2 = (ts2->type == BT_CLASS);
4749 bool is_derived1 = (ts1->type == BT_DERIVED);
4750 bool is_derived2 = (ts2->type == BT_DERIVED);
4752 if (!is_derived1 && !is_derived2 && !is_class1 && !is_class2)
4753 return (ts1->type == ts2->type);
4755 if (is_derived1 && is_derived2)
4756 return gfc_compare_derived_types (ts1->u.derived, ts2->u.derived);
4758 if (is_class1 && is_derived2)
4759 return gfc_type_is_extension_of (ts1->u.derived->components->ts.u.derived,
4761 else if (is_class1 && is_class2)
4762 return gfc_type_is_extension_of (ts1->u.derived->components->ts.u.derived,
4763 ts2->u.derived->components->ts.u.derived);
4769 /* Find the parent-namespace of the current function. If we're inside
4770 BLOCK constructs, it may not be the current one. */
4773 gfc_find_proc_namespace (gfc_namespace* ns)
4775 while (ns->construct_entities)
4785 /* Check if an associate-variable should be translated as an `implicit' pointer
4786 internally (if it is associated to a variable and not an array with
4790 gfc_is_associate_pointer (gfc_symbol* sym)
4795 if (!sym->assoc->variable)
4798 if (sym->attr.dimension && sym->as->type != AS_EXPLICIT)