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);
2057 /******************** Statement label management ********************/
2059 /* Comparison function for statement labels, used for managing the
2063 compare_st_labels (void *a1, void *b1)
2065 int a = ((gfc_st_label *) a1)->value;
2066 int b = ((gfc_st_label *) b1)->value;
2072 /* Free a single gfc_st_label structure, making sure the tree is not
2073 messed up. This function is called only when some parse error
2077 gfc_free_st_label (gfc_st_label *label)
2083 gfc_delete_bbt (&gfc_current_ns->st_labels, label, compare_st_labels);
2085 if (label->format != NULL)
2086 gfc_free_expr (label->format);
2092 /* Free a whole tree of gfc_st_label structures. */
2095 free_st_labels (gfc_st_label *label)
2101 free_st_labels (label->left);
2102 free_st_labels (label->right);
2104 if (label->format != NULL)
2105 gfc_free_expr (label->format);
2110 /* Given a label number, search for and return a pointer to the label
2111 structure, creating it if it does not exist. */
2114 gfc_get_st_label (int labelno)
2119 /* Find the namespace of the scoping unit:
2120 If we're in a BLOCK construct, jump to the parent namespace. */
2121 ns = gfc_current_ns;
2122 while (ns->proc_name && ns->proc_name->attr.flavor == FL_LABEL)
2125 /* First see if the label is already in this namespace. */
2129 if (lp->value == labelno)
2132 if (lp->value < labelno)
2138 lp = XCNEW (gfc_st_label);
2140 lp->value = labelno;
2141 lp->defined = ST_LABEL_UNKNOWN;
2142 lp->referenced = ST_LABEL_UNKNOWN;
2144 gfc_insert_bbt (&ns->st_labels, lp, compare_st_labels);
2150 /* Called when a statement with a statement label is about to be
2151 accepted. We add the label to the list of the current namespace,
2152 making sure it hasn't been defined previously and referenced
2156 gfc_define_st_label (gfc_st_label *lp, gfc_sl_type type, locus *label_locus)
2160 labelno = lp->value;
2162 if (lp->defined != ST_LABEL_UNKNOWN)
2163 gfc_error ("Duplicate statement label %d at %L and %L", labelno,
2164 &lp->where, label_locus);
2167 lp->where = *label_locus;
2171 case ST_LABEL_FORMAT:
2172 if (lp->referenced == ST_LABEL_TARGET)
2173 gfc_error ("Label %d at %C already referenced as branch target",
2176 lp->defined = ST_LABEL_FORMAT;
2180 case ST_LABEL_TARGET:
2181 if (lp->referenced == ST_LABEL_FORMAT)
2182 gfc_error ("Label %d at %C already referenced as a format label",
2185 lp->defined = ST_LABEL_TARGET;
2190 lp->defined = ST_LABEL_BAD_TARGET;
2191 lp->referenced = ST_LABEL_BAD_TARGET;
2197 /* Reference a label. Given a label and its type, see if that
2198 reference is consistent with what is known about that label,
2199 updating the unknown state. Returns FAILURE if something goes
2203 gfc_reference_st_label (gfc_st_label *lp, gfc_sl_type type)
2205 gfc_sl_type label_type;
2212 labelno = lp->value;
2214 if (lp->defined != ST_LABEL_UNKNOWN)
2215 label_type = lp->defined;
2218 label_type = lp->referenced;
2219 lp->where = gfc_current_locus;
2222 if (label_type == ST_LABEL_FORMAT && type == ST_LABEL_TARGET)
2224 gfc_error ("Label %d at %C previously used as a FORMAT label", labelno);
2229 if ((label_type == ST_LABEL_TARGET || label_type == ST_LABEL_BAD_TARGET)
2230 && type == ST_LABEL_FORMAT)
2232 gfc_error ("Label %d at %C previously used as branch target", labelno);
2237 lp->referenced = type;
2245 /*******A helper function for creating new expressions*************/
2249 gfc_lval_expr_from_sym (gfc_symbol *sym)
2252 lval = gfc_get_expr ();
2253 lval->expr_type = EXPR_VARIABLE;
2254 lval->where = sym->declared_at;
2256 lval->symtree = gfc_find_symtree (sym->ns->sym_root, sym->name);
2258 /* It will always be a full array. */
2259 lval->rank = sym->as ? sym->as->rank : 0;
2262 lval->ref = gfc_get_ref ();
2263 lval->ref->type = REF_ARRAY;
2264 lval->ref->u.ar.type = AR_FULL;
2265 lval->ref->u.ar.dimen = lval->rank;
2266 lval->ref->u.ar.where = sym->declared_at;
2267 lval->ref->u.ar.as = sym->as;
2274 /************** Symbol table management subroutines ****************/
2276 /* Basic details: Fortran 95 requires a potentially unlimited number
2277 of distinct namespaces when compiling a program unit. This case
2278 occurs during a compilation of internal subprograms because all of
2279 the internal subprograms must be read before we can start
2280 generating code for the host.
2282 Given the tricky nature of the Fortran grammar, we must be able to
2283 undo changes made to a symbol table if the current interpretation
2284 of a statement is found to be incorrect. Whenever a symbol is
2285 looked up, we make a copy of it and link to it. All of these
2286 symbols are kept in a singly linked list so that we can commit or
2287 undo the changes at a later time.
2289 A symtree may point to a symbol node outside of its namespace. In
2290 this case, that symbol has been used as a host associated variable
2291 at some previous time. */
2293 /* Allocate a new namespace structure. Copies the implicit types from
2294 PARENT if PARENT_TYPES is set. */
2297 gfc_get_namespace (gfc_namespace *parent, int parent_types)
2304 ns = XCNEW (gfc_namespace);
2305 ns->sym_root = NULL;
2306 ns->uop_root = NULL;
2307 ns->tb_sym_root = NULL;
2308 ns->finalizers = NULL;
2309 ns->default_access = ACCESS_UNKNOWN;
2310 ns->parent = parent;
2312 for (in = GFC_INTRINSIC_BEGIN; in != GFC_INTRINSIC_END; in++)
2314 ns->operator_access[in] = ACCESS_UNKNOWN;
2315 ns->tb_op[in] = NULL;
2318 /* Initialize default implicit types. */
2319 for (i = 'a'; i <= 'z'; i++)
2321 ns->set_flag[i - 'a'] = 0;
2322 ts = &ns->default_type[i - 'a'];
2324 if (parent_types && ns->parent != NULL)
2326 /* Copy parent settings. */
2327 *ts = ns->parent->default_type[i - 'a'];
2331 if (gfc_option.flag_implicit_none != 0)
2337 if ('i' <= i && i <= 'n')
2339 ts->type = BT_INTEGER;
2340 ts->kind = gfc_default_integer_kind;
2345 ts->kind = gfc_default_real_kind;
2355 /* Comparison function for symtree nodes. */
2358 compare_symtree (void *_st1, void *_st2)
2360 gfc_symtree *st1, *st2;
2362 st1 = (gfc_symtree *) _st1;
2363 st2 = (gfc_symtree *) _st2;
2365 return strcmp (st1->name, st2->name);
2369 /* Allocate a new symtree node and associate it with the new symbol. */
2372 gfc_new_symtree (gfc_symtree **root, const char *name)
2376 st = XCNEW (gfc_symtree);
2377 st->name = gfc_get_string (name);
2379 gfc_insert_bbt (root, st, compare_symtree);
2384 /* Delete a symbol from the tree. Does not free the symbol itself! */
2387 gfc_delete_symtree (gfc_symtree **root, const char *name)
2389 gfc_symtree st, *st0;
2391 st0 = gfc_find_symtree (*root, name);
2393 st.name = gfc_get_string (name);
2394 gfc_delete_bbt (root, &st, compare_symtree);
2400 /* Given a root symtree node and a name, try to find the symbol within
2401 the namespace. Returns NULL if the symbol is not found. */
2404 gfc_find_symtree (gfc_symtree *st, const char *name)
2410 c = strcmp (name, st->name);
2414 st = (c < 0) ? st->left : st->right;
2421 /* Return a symtree node with a name that is guaranteed to be unique
2422 within the namespace and corresponds to an illegal fortran name. */
2425 gfc_get_unique_symtree (gfc_namespace *ns)
2427 char name[GFC_MAX_SYMBOL_LEN + 1];
2428 static int serial = 0;
2430 sprintf (name, "@%d", serial++);
2431 return gfc_new_symtree (&ns->sym_root, name);
2435 /* Given a name find a user operator node, creating it if it doesn't
2436 exist. These are much simpler than symbols because they can't be
2437 ambiguous with one another. */
2440 gfc_get_uop (const char *name)
2445 st = gfc_find_symtree (gfc_current_ns->uop_root, name);
2449 st = gfc_new_symtree (&gfc_current_ns->uop_root, name);
2451 uop = st->n.uop = XCNEW (gfc_user_op);
2452 uop->name = gfc_get_string (name);
2453 uop->access = ACCESS_UNKNOWN;
2454 uop->ns = gfc_current_ns;
2460 /* Given a name find the user operator node. Returns NULL if it does
2464 gfc_find_uop (const char *name, gfc_namespace *ns)
2469 ns = gfc_current_ns;
2471 st = gfc_find_symtree (ns->uop_root, name);
2472 return (st == NULL) ? NULL : st->n.uop;
2476 /* Remove a gfc_symbol structure and everything it points to. */
2479 gfc_free_symbol (gfc_symbol *sym)
2485 gfc_free_array_spec (sym->as);
2487 free_components (sym->components);
2489 gfc_free_expr (sym->value);
2491 gfc_free_namelist (sym->namelist);
2493 gfc_free_namespace (sym->formal_ns);
2495 if (!sym->attr.generic_copy)
2496 gfc_free_interface (sym->generic);
2498 gfc_free_formal_arglist (sym->formal);
2500 gfc_free_namespace (sym->f2k_derived);
2506 /* Decrease the reference counter and free memory when we reach zero. */
2509 gfc_release_symbol (gfc_symbol *sym)
2514 if (sym->formal_ns != NULL && sym->refs == 2)
2516 /* As formal_ns contains a reference to sym, delete formal_ns just
2517 before the deletion of sym. */
2518 gfc_namespace *ns = sym->formal_ns;
2519 sym->formal_ns = NULL;
2520 gfc_free_namespace (ns);
2527 gcc_assert (sym->refs == 0);
2528 gfc_free_symbol (sym);
2532 /* Allocate and initialize a new symbol node. */
2535 gfc_new_symbol (const char *name, gfc_namespace *ns)
2539 p = XCNEW (gfc_symbol);
2541 gfc_clear_ts (&p->ts);
2542 gfc_clear_attr (&p->attr);
2545 p->declared_at = gfc_current_locus;
2547 if (strlen (name) > GFC_MAX_SYMBOL_LEN)
2548 gfc_internal_error ("new_symbol(): Symbol name too long");
2550 p->name = gfc_get_string (name);
2552 /* Make sure flags for symbol being C bound are clear initially. */
2553 p->attr.is_bind_c = 0;
2554 p->attr.is_iso_c = 0;
2555 /* Make sure the binding label field has a Nul char to start. */
2556 p->binding_label[0] = '\0';
2558 /* Clear the ptrs we may need. */
2559 p->common_block = NULL;
2560 p->f2k_derived = NULL;
2567 /* Generate an error if a symbol is ambiguous. */
2570 ambiguous_symbol (const char *name, gfc_symtree *st)
2573 if (st->n.sym->module)
2574 gfc_error ("Name '%s' at %C is an ambiguous reference to '%s' "
2575 "from module '%s'", name, st->n.sym->name, st->n.sym->module);
2577 gfc_error ("Name '%s' at %C is an ambiguous reference to '%s' "
2578 "from current program unit", name, st->n.sym->name);
2582 /* If we're in a SELECT TYPE block, check if the variable 'st' matches any
2583 selector on the stack. If yes, replace it by the corresponding temporary. */
2586 select_type_insert_tmp (gfc_symtree **st)
2588 gfc_select_type_stack *stack = select_type_stack;
2589 for (; stack; stack = stack->prev)
2590 if ((*st)->n.sym == stack->selector && stack->tmp)
2595 /* Look for a symtree in the current procedure -- that is, go up to
2596 parent namespaces but only if inside a BLOCK. Returns NULL if not found. */
2599 gfc_find_symtree_in_proc (const char* name, gfc_namespace* ns)
2603 gfc_symtree* st = gfc_find_symtree (ns->sym_root, name);
2607 if (!ns->construct_entities)
2616 /* Search for a symtree starting in the current namespace, resorting to
2617 any parent namespaces if requested by a nonzero parent_flag.
2618 Returns nonzero if the name is ambiguous. */
2621 gfc_find_sym_tree (const char *name, gfc_namespace *ns, int parent_flag,
2622 gfc_symtree **result)
2627 ns = gfc_current_ns;
2631 st = gfc_find_symtree (ns->sym_root, name);
2634 select_type_insert_tmp (&st);
2637 /* Ambiguous generic interfaces are permitted, as long
2638 as the specific interfaces are different. */
2639 if (st->ambiguous && !st->n.sym->attr.generic)
2641 ambiguous_symbol (name, st);
2660 /* Same, but returns the symbol instead. */
2663 gfc_find_symbol (const char *name, gfc_namespace *ns, int parent_flag,
2664 gfc_symbol **result)
2669 i = gfc_find_sym_tree (name, ns, parent_flag, &st);
2674 *result = st->n.sym;
2680 /* Save symbol with the information necessary to back it out. */
2683 save_symbol_data (gfc_symbol *sym)
2686 if (sym->gfc_new || sym->old_symbol != NULL)
2689 sym->old_symbol = XCNEW (gfc_symbol);
2690 *(sym->old_symbol) = *sym;
2692 sym->tlink = changed_syms;
2697 /* Given a name, find a symbol, or create it if it does not exist yet
2698 in the current namespace. If the symbol is found we make sure that
2701 The integer return code indicates
2703 1 The symbol name was ambiguous
2704 2 The name meant to be established was already host associated.
2706 So if the return value is nonzero, then an error was issued. */
2709 gfc_get_sym_tree (const char *name, gfc_namespace *ns, gfc_symtree **result,
2710 bool allow_subroutine)
2715 /* This doesn't usually happen during resolution. */
2717 ns = gfc_current_ns;
2719 /* Try to find the symbol in ns. */
2720 st = gfc_find_symtree (ns->sym_root, name);
2724 /* If not there, create a new symbol. */
2725 p = gfc_new_symbol (name, ns);
2727 /* Add to the list of tentative symbols. */
2728 p->old_symbol = NULL;
2729 p->tlink = changed_syms;
2734 st = gfc_new_symtree (&ns->sym_root, name);
2741 /* Make sure the existing symbol is OK. Ambiguous
2742 generic interfaces are permitted, as long as the
2743 specific interfaces are different. */
2744 if (st->ambiguous && !st->n.sym->attr.generic)
2746 ambiguous_symbol (name, st);
2751 if (p->ns != ns && (!p->attr.function || ns->proc_name != p)
2752 && !(allow_subroutine && p->attr.subroutine)
2753 && !(ns->proc_name && ns->proc_name->attr.if_source == IFSRC_IFBODY
2754 && (ns->has_import_set || p->attr.imported)))
2756 /* Symbol is from another namespace. */
2757 gfc_error ("Symbol '%s' at %C has already been host associated",
2764 /* Copy in case this symbol is changed. */
2765 save_symbol_data (p);
2774 gfc_get_symbol (const char *name, gfc_namespace *ns, gfc_symbol **result)
2779 i = gfc_get_sym_tree (name, ns, &st, false);
2784 *result = st->n.sym;
2791 /* Subroutine that searches for a symbol, creating it if it doesn't
2792 exist, but tries to host-associate the symbol if possible. */
2795 gfc_get_ha_sym_tree (const char *name, gfc_symtree **result)
2800 i = gfc_find_sym_tree (name, gfc_current_ns, 0, &st);
2804 save_symbol_data (st->n.sym);
2809 if (gfc_current_ns->parent != NULL)
2811 i = gfc_find_sym_tree (name, gfc_current_ns->parent, 1, &st);
2822 return gfc_get_sym_tree (name, gfc_current_ns, result, false);
2827 gfc_get_ha_symbol (const char *name, gfc_symbol **result)
2832 i = gfc_get_ha_sym_tree (name, &st);
2835 *result = st->n.sym;
2842 /* Return true if both symbols could refer to the same data object. Does
2843 not take account of aliasing due to equivalence statements. */
2846 gfc_symbols_could_alias (gfc_symbol *lsym, gfc_symbol *rsym)
2848 /* Aliasing isn't possible if the symbols have different base types. */
2849 if (gfc_compare_types (&lsym->ts, &rsym->ts) == 0)
2852 /* Pointers can point to other pointers, target objects and allocatable
2853 objects. Two allocatable objects cannot share the same storage. */
2854 if (lsym->attr.pointer
2855 && (rsym->attr.pointer || rsym->attr.allocatable || rsym->attr.target))
2857 if (lsym->attr.target && rsym->attr.pointer)
2859 if (lsym->attr.allocatable && rsym->attr.pointer)
2862 /* Special case: Argument association, cf. F90 12.4.1.6, F2003 12.4.1.7
2863 and F2008 12.5.2.13 items 3b and 4b. The pointer case (a) is already
2865 if (lsym->attr.target && rsym->attr.target
2866 && ((lsym->attr.dummy && !lsym->attr.contiguous
2867 && (!lsym->attr.dimension || lsym->as->type == AS_ASSUMED_SHAPE))
2868 || (rsym->attr.dummy && !rsym->attr.contiguous
2869 && (!rsym->attr.dimension
2870 || rsym->as->type == AS_ASSUMED_SHAPE))))
2877 /* Undoes all the changes made to symbols in the current statement.
2878 This subroutine is made simpler due to the fact that attributes are
2879 never removed once added. */
2882 gfc_undo_symbols (void)
2884 gfc_symbol *p, *q, *old;
2885 tentative_tbp *tbp, *tbq;
2887 for (p = changed_syms; p; p = q)
2893 /* Symbol was new. */
2894 if (p->attr.in_common && p->common_block && p->common_block->head)
2896 /* If the symbol was added to any common block, it
2897 needs to be removed to stop the resolver looking
2898 for a (possibly) dead symbol. */
2900 if (p->common_block->head == p)
2901 p->common_block->head = p->common_next;
2904 gfc_symbol *cparent, *csym;
2906 cparent = p->common_block->head;
2907 csym = cparent->common_next;
2912 csym = csym->common_next;
2915 gcc_assert(cparent->common_next == p);
2917 cparent->common_next = csym->common_next;
2921 gfc_delete_symtree (&p->ns->sym_root, p->name);
2923 gfc_release_symbol (p);
2927 /* Restore previous state of symbol. Just copy simple stuff. */
2929 old = p->old_symbol;
2931 p->ts.type = old->ts.type;
2932 p->ts.kind = old->ts.kind;
2934 p->attr = old->attr;
2936 if (p->value != old->value)
2938 gfc_free_expr (old->value);
2942 if (p->as != old->as)
2945 gfc_free_array_spec (p->as);
2949 p->generic = old->generic;
2950 p->component_access = old->component_access;
2952 if (p->namelist != NULL && old->namelist == NULL)
2954 gfc_free_namelist (p->namelist);
2959 if (p->namelist_tail != old->namelist_tail)
2961 gfc_free_namelist (old->namelist_tail);
2962 old->namelist_tail->next = NULL;
2966 p->namelist_tail = old->namelist_tail;
2968 if (p->formal != old->formal)
2970 gfc_free_formal_arglist (p->formal);
2971 p->formal = old->formal;
2974 gfc_free (p->old_symbol);
2975 p->old_symbol = NULL;
2979 changed_syms = NULL;
2981 for (tbp = tentative_tbp_list; tbp; tbp = tbq)
2984 /* Procedure is already marked `error' by default. */
2987 tentative_tbp_list = NULL;
2991 /* Free sym->old_symbol. sym->old_symbol is mostly a shallow copy of sym; the
2992 components of old_symbol that might need deallocation are the "allocatables"
2993 that are restored in gfc_undo_symbols(), with two exceptions: namelist and
2994 namelist_tail. In case these differ between old_symbol and sym, it's just
2995 because sym->namelist has gotten a few more items. */
2998 free_old_symbol (gfc_symbol *sym)
3001 if (sym->old_symbol == NULL)
3004 if (sym->old_symbol->as != sym->as)
3005 gfc_free_array_spec (sym->old_symbol->as);
3007 if (sym->old_symbol->value != sym->value)
3008 gfc_free_expr (sym->old_symbol->value);
3010 if (sym->old_symbol->formal != sym->formal)
3011 gfc_free_formal_arglist (sym->old_symbol->formal);
3013 gfc_free (sym->old_symbol);
3014 sym->old_symbol = NULL;
3018 /* Makes the changes made in the current statement permanent-- gets
3019 rid of undo information. */
3022 gfc_commit_symbols (void)
3025 tentative_tbp *tbp, *tbq;
3027 for (p = changed_syms; p; p = q)
3033 free_old_symbol (p);
3035 changed_syms = NULL;
3037 for (tbp = tentative_tbp_list; tbp; tbp = tbq)
3040 tbp->proc->error = 0;
3043 tentative_tbp_list = NULL;
3047 /* Makes the changes made in one symbol permanent -- gets rid of undo
3051 gfc_commit_symbol (gfc_symbol *sym)
3055 if (changed_syms == sym)
3056 changed_syms = sym->tlink;
3059 for (p = changed_syms; p; p = p->tlink)
3060 if (p->tlink == sym)
3062 p->tlink = sym->tlink;
3071 free_old_symbol (sym);
3075 /* Recursively free trees containing type-bound procedures. */
3078 free_tb_tree (gfc_symtree *t)
3083 free_tb_tree (t->left);
3084 free_tb_tree (t->right);
3086 /* TODO: Free type-bound procedure structs themselves; probably needs some
3087 sort of ref-counting mechanism. */
3093 /* Recursive function that deletes an entire tree and all the common
3094 head structures it points to. */
3097 free_common_tree (gfc_symtree * common_tree)
3099 if (common_tree == NULL)
3102 free_common_tree (common_tree->left);
3103 free_common_tree (common_tree->right);
3105 gfc_free (common_tree);
3109 /* Recursive function that deletes an entire tree and all the user
3110 operator nodes that it contains. */
3113 free_uop_tree (gfc_symtree *uop_tree)
3115 if (uop_tree == NULL)
3118 free_uop_tree (uop_tree->left);
3119 free_uop_tree (uop_tree->right);
3121 gfc_free_interface (uop_tree->n.uop->op);
3122 gfc_free (uop_tree->n.uop);
3123 gfc_free (uop_tree);
3127 /* Recursive function that deletes an entire tree and all the symbols
3128 that it contains. */
3131 free_sym_tree (gfc_symtree *sym_tree)
3133 if (sym_tree == NULL)
3136 free_sym_tree (sym_tree->left);
3137 free_sym_tree (sym_tree->right);
3139 gfc_release_symbol (sym_tree->n.sym);
3140 gfc_free (sym_tree);
3144 /* Free the derived type list. */
3147 gfc_free_dt_list (void)
3149 gfc_dt_list *dt, *n;
3151 for (dt = gfc_derived_types; dt; dt = n)
3157 gfc_derived_types = NULL;
3161 /* Free the gfc_equiv_info's. */
3164 gfc_free_equiv_infos (gfc_equiv_info *s)
3168 gfc_free_equiv_infos (s->next);
3173 /* Free the gfc_equiv_lists. */
3176 gfc_free_equiv_lists (gfc_equiv_list *l)
3180 gfc_free_equiv_lists (l->next);
3181 gfc_free_equiv_infos (l->equiv);
3186 /* Free a finalizer procedure list. */
3189 gfc_free_finalizer (gfc_finalizer* el)
3193 gfc_release_symbol (el->proc_sym);
3199 gfc_free_finalizer_list (gfc_finalizer* list)
3203 gfc_finalizer* current = list;
3205 gfc_free_finalizer (current);
3210 /* Create a new gfc_charlen structure and add it to a namespace.
3211 If 'old_cl' is given, the newly created charlen will be a copy of it. */
3214 gfc_new_charlen (gfc_namespace *ns, gfc_charlen *old_cl)
3217 cl = gfc_get_charlen ();
3219 /* Put into namespace. */
3220 cl->next = ns->cl_list;
3226 cl->length = gfc_copy_expr (old_cl->length);
3227 cl->length_from_typespec = old_cl->length_from_typespec;
3228 cl->backend_decl = old_cl->backend_decl;
3229 cl->passed_length = old_cl->passed_length;
3230 cl->resolved = old_cl->resolved;
3237 /* Free the charlen list from cl to end (end is not freed).
3238 Free the whole list if end is NULL. */
3240 void gfc_free_charlen (gfc_charlen *cl, gfc_charlen *end)
3244 for (; cl != end; cl = cl2)
3249 gfc_free_expr (cl->length);
3255 /* Free a namespace structure and everything below it. Interface
3256 lists associated with intrinsic operators are not freed. These are
3257 taken care of when a specific name is freed. */
3260 gfc_free_namespace (gfc_namespace *ns)
3262 gfc_namespace *p, *q;
3271 gcc_assert (ns->refs == 0);
3273 gfc_free_statements (ns->code);
3275 free_sym_tree (ns->sym_root);
3276 free_uop_tree (ns->uop_root);
3277 free_common_tree (ns->common_root);
3278 free_tb_tree (ns->tb_sym_root);
3279 free_tb_tree (ns->tb_uop_root);
3280 gfc_free_finalizer_list (ns->finalizers);
3281 gfc_free_charlen (ns->cl_list, NULL);
3282 free_st_labels (ns->st_labels);
3284 gfc_free_equiv (ns->equiv);
3285 gfc_free_equiv_lists (ns->equiv_lists);
3286 gfc_free_use_stmts (ns->use_stmts);
3288 for (i = GFC_INTRINSIC_BEGIN; i != GFC_INTRINSIC_END; i++)
3289 gfc_free_interface (ns->op[i]);
3291 gfc_free_data (ns->data);
3295 /* Recursively free any contained namespaces. */
3300 gfc_free_namespace (q);
3306 gfc_symbol_init_2 (void)
3309 gfc_current_ns = gfc_get_namespace (NULL, 0);
3314 gfc_symbol_done_2 (void)
3317 gfc_free_namespace (gfc_current_ns);
3318 gfc_current_ns = NULL;
3319 gfc_free_dt_list ();
3323 /* Clear mark bits from symbol nodes associated with a symtree node. */
3326 clear_sym_mark (gfc_symtree *st)
3329 st->n.sym->mark = 0;
3333 /* Recursively traverse the symtree nodes. */
3336 gfc_traverse_symtree (gfc_symtree *st, void (*func) (gfc_symtree *))
3341 gfc_traverse_symtree (st->left, func);
3343 gfc_traverse_symtree (st->right, func);
3347 /* Recursive namespace traversal function. */
3350 traverse_ns (gfc_symtree *st, void (*func) (gfc_symbol *))
3356 traverse_ns (st->left, func);
3358 if (st->n.sym->mark == 0)
3359 (*func) (st->n.sym);
3360 st->n.sym->mark = 1;
3362 traverse_ns (st->right, func);
3366 /* Call a given function for all symbols in the namespace. We take
3367 care that each gfc_symbol node is called exactly once. */
3370 gfc_traverse_ns (gfc_namespace *ns, void (*func) (gfc_symbol *))
3373 gfc_traverse_symtree (ns->sym_root, clear_sym_mark);
3375 traverse_ns (ns->sym_root, func);
3379 /* Return TRUE when name is the name of an intrinsic type. */
3382 gfc_is_intrinsic_typename (const char *name)
3384 if (strcmp (name, "integer") == 0
3385 || strcmp (name, "real") == 0
3386 || strcmp (name, "character") == 0
3387 || strcmp (name, "logical") == 0
3388 || strcmp (name, "complex") == 0
3389 || strcmp (name, "doubleprecision") == 0
3390 || strcmp (name, "doublecomplex") == 0)
3397 /* Return TRUE if the symbol is an automatic variable. */
3400 gfc_is_var_automatic (gfc_symbol *sym)
3402 /* Pointer and allocatable variables are never automatic. */
3403 if (sym->attr.pointer || sym->attr.allocatable)
3405 /* Check for arrays with non-constant size. */
3406 if (sym->attr.dimension && sym->as
3407 && !gfc_is_compile_time_shape (sym->as))
3409 /* Check for non-constant length character variables. */
3410 if (sym->ts.type == BT_CHARACTER
3412 && !gfc_is_constant_expr (sym->ts.u.cl->length))
3417 /* Given a symbol, mark it as SAVEd if it is allowed. */
3420 save_symbol (gfc_symbol *sym)
3423 if (sym->attr.use_assoc)
3426 if (sym->attr.in_common
3429 || sym->attr.flavor != FL_VARIABLE)
3431 /* Automatic objects are not saved. */
3432 if (gfc_is_var_automatic (sym))
3434 gfc_add_save (&sym->attr, SAVE_EXPLICIT, sym->name, &sym->declared_at);
3438 /* Mark those symbols which can be SAVEd as such. */
3441 gfc_save_all (gfc_namespace *ns)
3443 gfc_traverse_ns (ns, save_symbol);
3447 /* Make sure that no changes to symbols are pending. */
3450 gfc_enforce_clean_symbol_state(void)
3452 gcc_assert (changed_syms == NULL);
3456 /************** Global symbol handling ************/
3459 /* Search a tree for the global symbol. */
3462 gfc_find_gsymbol (gfc_gsymbol *symbol, const char *name)
3471 c = strcmp (name, symbol->name);
3475 symbol = (c < 0) ? symbol->left : symbol->right;
3482 /* Compare two global symbols. Used for managing the BB tree. */
3485 gsym_compare (void *_s1, void *_s2)
3487 gfc_gsymbol *s1, *s2;
3489 s1 = (gfc_gsymbol *) _s1;
3490 s2 = (gfc_gsymbol *) _s2;
3491 return strcmp (s1->name, s2->name);
3495 /* Get a global symbol, creating it if it doesn't exist. */
3498 gfc_get_gsymbol (const char *name)
3502 s = gfc_find_gsymbol (gfc_gsym_root, name);
3506 s = XCNEW (gfc_gsymbol);
3507 s->type = GSYM_UNKNOWN;
3508 s->name = gfc_get_string (name);
3510 gfc_insert_bbt (&gfc_gsym_root, s, gsym_compare);
3517 get_iso_c_binding_dt (int sym_id)
3519 gfc_dt_list *dt_list;
3521 dt_list = gfc_derived_types;
3523 /* Loop through the derived types in the name list, searching for
3524 the desired symbol from iso_c_binding. Search the parent namespaces
3525 if necessary and requested to (parent_flag). */
3526 while (dt_list != NULL)
3528 if (dt_list->derived->from_intmod != INTMOD_NONE
3529 && dt_list->derived->intmod_sym_id == sym_id)
3530 return dt_list->derived;
3532 dt_list = dt_list->next;
3539 /* Verifies that the given derived type symbol, derived_sym, is interoperable
3540 with C. This is necessary for any derived type that is BIND(C) and for
3541 derived types that are parameters to functions that are BIND(C). All
3542 fields of the derived type are required to be interoperable, and are tested
3543 for such. If an error occurs, the errors are reported here, allowing for
3544 multiple errors to be handled for a single derived type. */
3547 verify_bind_c_derived_type (gfc_symbol *derived_sym)
3549 gfc_component *curr_comp = NULL;
3550 gfc_try is_c_interop = FAILURE;
3551 gfc_try retval = SUCCESS;
3553 if (derived_sym == NULL)
3554 gfc_internal_error ("verify_bind_c_derived_type(): Given symbol is "
3555 "unexpectedly NULL");
3557 /* If we've already looked at this derived symbol, do not look at it again
3558 so we don't repeat warnings/errors. */
3559 if (derived_sym->ts.is_c_interop)
3562 /* The derived type must have the BIND attribute to be interoperable
3563 J3/04-007, Section 15.2.3. */
3564 if (derived_sym->attr.is_bind_c != 1)
3566 derived_sym->ts.is_c_interop = 0;
3567 gfc_error_now ("Derived type '%s' declared at %L must have the BIND "
3568 "attribute to be C interoperable", derived_sym->name,
3569 &(derived_sym->declared_at));
3573 curr_comp = derived_sym->components;
3575 /* TODO: is this really an error? */
3576 if (curr_comp == NULL)
3578 gfc_error ("Derived type '%s' at %L is empty",
3579 derived_sym->name, &(derived_sym->declared_at));
3583 /* Initialize the derived type as being C interoperable.
3584 If we find an error in the components, this will be set false. */
3585 derived_sym->ts.is_c_interop = 1;
3587 /* Loop through the list of components to verify that the kind of
3588 each is a C interoperable type. */
3591 /* The components cannot be pointers (fortran sense).
3592 J3/04-007, Section 15.2.3, C1505. */
3593 if (curr_comp->attr.pointer != 0)
3595 gfc_error ("Component '%s' at %L cannot have the "
3596 "POINTER attribute because it is a member "
3597 "of the BIND(C) derived type '%s' at %L",
3598 curr_comp->name, &(curr_comp->loc),
3599 derived_sym->name, &(derived_sym->declared_at));
3603 if (curr_comp->attr.proc_pointer != 0)
3605 gfc_error ("Procedure pointer component '%s' at %L cannot be a member"
3606 " of the BIND(C) derived type '%s' at %L", curr_comp->name,
3607 &curr_comp->loc, derived_sym->name,
3608 &derived_sym->declared_at);
3612 /* The components cannot be allocatable.
3613 J3/04-007, Section 15.2.3, C1505. */
3614 if (curr_comp->attr.allocatable != 0)
3616 gfc_error ("Component '%s' at %L cannot have the "
3617 "ALLOCATABLE attribute because it is a member "
3618 "of the BIND(C) derived type '%s' at %L",
3619 curr_comp->name, &(curr_comp->loc),
3620 derived_sym->name, &(derived_sym->declared_at));
3624 /* BIND(C) derived types must have interoperable components. */
3625 if (curr_comp->ts.type == BT_DERIVED
3626 && curr_comp->ts.u.derived->ts.is_iso_c != 1
3627 && curr_comp->ts.u.derived != derived_sym)
3629 /* This should be allowed; the draft says a derived-type can not
3630 have type parameters if it is has the BIND attribute. Type
3631 parameters seem to be for making parameterized derived types.
3632 There's no need to verify the type if it is c_ptr/c_funptr. */
3633 retval = verify_bind_c_derived_type (curr_comp->ts.u.derived);
3637 /* Grab the typespec for the given component and test the kind. */
3638 is_c_interop = verify_c_interop (&(curr_comp->ts));
3640 if (is_c_interop != SUCCESS)
3642 /* Report warning and continue since not fatal. The
3643 draft does specify a constraint that requires all fields
3644 to interoperate, but if the user says real(4), etc., it
3645 may interoperate with *something* in C, but the compiler
3646 most likely won't know exactly what. Further, it may not
3647 interoperate with the same data type(s) in C if the user
3648 recompiles with different flags (e.g., -m32 and -m64 on
3649 x86_64 and using integer(4) to claim interop with a
3651 if (derived_sym->attr.is_bind_c == 1)
3652 /* If the derived type is bind(c), all fields must be
3654 gfc_warning ("Component '%s' in derived type '%s' at %L "
3655 "may not be C interoperable, even though "
3656 "derived type '%s' is BIND(C)",
3657 curr_comp->name, derived_sym->name,
3658 &(curr_comp->loc), derived_sym->name);
3660 /* If derived type is param to bind(c) routine, or to one
3661 of the iso_c_binding procs, it must be interoperable, so
3662 all fields must interop too. */
3663 gfc_warning ("Component '%s' in derived type '%s' at %L "
3664 "may not be C interoperable",
3665 curr_comp->name, derived_sym->name,
3670 curr_comp = curr_comp->next;
3671 } while (curr_comp != NULL);
3674 /* Make sure we don't have conflicts with the attributes. */
3675 if (derived_sym->attr.access == ACCESS_PRIVATE)
3677 gfc_error ("Derived type '%s' at %L cannot be declared with both "
3678 "PRIVATE and BIND(C) attributes", derived_sym->name,
3679 &(derived_sym->declared_at));
3683 if (derived_sym->attr.sequence != 0)
3685 gfc_error ("Derived type '%s' at %L cannot have the SEQUENCE "
3686 "attribute because it is BIND(C)", derived_sym->name,
3687 &(derived_sym->declared_at));
3691 /* Mark the derived type as not being C interoperable if we found an
3692 error. If there were only warnings, proceed with the assumption
3693 it's interoperable. */
3694 if (retval == FAILURE)
3695 derived_sym->ts.is_c_interop = 0;
3701 /* Generate symbols for the named constants c_null_ptr and c_null_funptr. */
3704 gen_special_c_interop_ptr (int ptr_id, const char *ptr_name,
3705 const char *module_name)
3707 gfc_symtree *tmp_symtree;
3708 gfc_symbol *tmp_sym;
3711 tmp_symtree = gfc_find_symtree (gfc_current_ns->sym_root, ptr_name);
3713 if (tmp_symtree != NULL)
3714 tmp_sym = tmp_symtree->n.sym;
3718 gfc_internal_error ("gen_special_c_interop_ptr(): Unable to "
3719 "create symbol for %s", ptr_name);
3722 /* Set up the symbol's important fields. Save attr required so we can
3723 initialize the ptr to NULL. */
3724 tmp_sym->attr.save = SAVE_EXPLICIT;
3725 tmp_sym->ts.is_c_interop = 1;
3726 tmp_sym->attr.is_c_interop = 1;
3727 tmp_sym->ts.is_iso_c = 1;
3728 tmp_sym->ts.type = BT_DERIVED;
3730 /* The c_ptr and c_funptr derived types will provide the
3731 definition for c_null_ptr and c_null_funptr, respectively. */
3732 if (ptr_id == ISOCBINDING_NULL_PTR)
3733 tmp_sym->ts.u.derived = get_iso_c_binding_dt (ISOCBINDING_PTR);
3735 tmp_sym->ts.u.derived = get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
3736 if (tmp_sym->ts.u.derived == NULL)
3738 /* This can occur if the user forgot to declare c_ptr or
3739 c_funptr and they're trying to use one of the procedures
3740 that has arg(s) of the missing type. In this case, a
3741 regular version of the thing should have been put in the
3743 generate_isocbinding_symbol (module_name, ptr_id == ISOCBINDING_NULL_PTR
3744 ? ISOCBINDING_PTR : ISOCBINDING_FUNPTR,
3745 (const char *) (ptr_id == ISOCBINDING_NULL_PTR
3746 ? "_gfortran_iso_c_binding_c_ptr"
3747 : "_gfortran_iso_c_binding_c_funptr"));
3749 tmp_sym->ts.u.derived =
3750 get_iso_c_binding_dt (ptr_id == ISOCBINDING_NULL_PTR
3751 ? ISOCBINDING_PTR : ISOCBINDING_FUNPTR);
3754 /* Module name is some mangled version of iso_c_binding. */
3755 tmp_sym->module = gfc_get_string (module_name);
3757 /* Say it's from the iso_c_binding module. */
3758 tmp_sym->attr.is_iso_c = 1;
3760 tmp_sym->attr.use_assoc = 1;
3761 tmp_sym->attr.is_bind_c = 1;
3762 /* Set the binding_label. */
3763 sprintf (tmp_sym->binding_label, "%s_%s", module_name, tmp_sym->name);
3765 /* Set the c_address field of c_null_ptr and c_null_funptr to
3766 the value of NULL. */
3767 tmp_sym->value = gfc_get_expr ();
3768 tmp_sym->value->expr_type = EXPR_STRUCTURE;
3769 tmp_sym->value->ts.type = BT_DERIVED;
3770 tmp_sym->value->ts.u.derived = tmp_sym->ts.u.derived;
3771 gfc_constructor_append_expr (&tmp_sym->value->value.constructor, NULL, NULL);
3772 c = gfc_constructor_first (tmp_sym->value->value.constructor);
3773 c->expr = gfc_get_expr ();
3774 c->expr->expr_type = EXPR_NULL;
3775 c->expr->ts.is_iso_c = 1;
3776 /* Must declare c_null_ptr and c_null_funptr as having the
3777 PARAMETER attribute so they can be used in init expressions. */
3778 tmp_sym->attr.flavor = FL_PARAMETER;
3784 /* Add a formal argument, gfc_formal_arglist, to the
3785 end of the given list of arguments. Set the reference to the
3786 provided symbol, param_sym, in the argument. */
3789 add_formal_arg (gfc_formal_arglist **head,
3790 gfc_formal_arglist **tail,
3791 gfc_formal_arglist *formal_arg,
3792 gfc_symbol *param_sym)
3794 /* Put in list, either as first arg or at the tail (curr arg). */
3796 *head = *tail = formal_arg;
3799 (*tail)->next = formal_arg;
3800 (*tail) = formal_arg;
3803 (*tail)->sym = param_sym;
3804 (*tail)->next = NULL;
3810 /* Generates a symbol representing the CPTR argument to an
3811 iso_c_binding procedure. Also, create a gfc_formal_arglist for the
3812 CPTR and add it to the provided argument list. */
3815 gen_cptr_param (gfc_formal_arglist **head,
3816 gfc_formal_arglist **tail,
3817 const char *module_name,
3818 gfc_namespace *ns, const char *c_ptr_name,
3821 gfc_symbol *param_sym = NULL;
3822 gfc_symbol *c_ptr_sym = NULL;
3823 gfc_symtree *param_symtree = NULL;
3824 gfc_formal_arglist *formal_arg = NULL;
3825 const char *c_ptr_in;
3826 const char *c_ptr_type = NULL;
3828 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3829 c_ptr_type = "_gfortran_iso_c_binding_c_funptr";
3831 c_ptr_type = "_gfortran_iso_c_binding_c_ptr";
3833 if(c_ptr_name == NULL)
3834 c_ptr_in = "gfc_cptr__";
3836 c_ptr_in = c_ptr_name;
3837 gfc_get_sym_tree (c_ptr_in, ns, ¶m_symtree, false);
3838 if (param_symtree != NULL)
3839 param_sym = param_symtree->n.sym;
3841 gfc_internal_error ("gen_cptr_param(): Unable to "
3842 "create symbol for %s", c_ptr_in);
3844 /* Set up the appropriate fields for the new c_ptr param sym. */
3846 param_sym->attr.flavor = FL_DERIVED;
3847 param_sym->ts.type = BT_DERIVED;
3848 param_sym->attr.intent = INTENT_IN;
3849 param_sym->attr.dummy = 1;
3851 /* This will pass the ptr to the iso_c routines as a (void *). */
3852 param_sym->attr.value = 1;
3853 param_sym->attr.use_assoc = 1;
3855 /* Get the symbol for c_ptr or c_funptr, no matter what it's name is
3857 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3858 c_ptr_sym = get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
3860 c_ptr_sym = get_iso_c_binding_dt (ISOCBINDING_PTR);
3861 if (c_ptr_sym == NULL)
3863 /* This can happen if the user did not define c_ptr but they are
3864 trying to use one of the iso_c_binding functions that need it. */
3865 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3866 generate_isocbinding_symbol (module_name, ISOCBINDING_FUNPTR,
3867 (const char *)c_ptr_type);
3869 generate_isocbinding_symbol (module_name, ISOCBINDING_PTR,
3870 (const char *)c_ptr_type);
3872 gfc_get_ha_symbol (c_ptr_type, &(c_ptr_sym));
3875 param_sym->ts.u.derived = c_ptr_sym;
3876 param_sym->module = gfc_get_string (module_name);
3878 /* Make new formal arg. */
3879 formal_arg = gfc_get_formal_arglist ();
3880 /* Add arg to list of formal args (the CPTR arg). */
3881 add_formal_arg (head, tail, formal_arg, param_sym);
3883 /* Validate changes. */
3884 gfc_commit_symbol (param_sym);
3888 /* Generates a symbol representing the FPTR argument to an
3889 iso_c_binding procedure. Also, create a gfc_formal_arglist for the
3890 FPTR and add it to the provided argument list. */
3893 gen_fptr_param (gfc_formal_arglist **head,
3894 gfc_formal_arglist **tail,
3895 const char *module_name,
3896 gfc_namespace *ns, const char *f_ptr_name, int proc)
3898 gfc_symbol *param_sym = NULL;
3899 gfc_symtree *param_symtree = NULL;
3900 gfc_formal_arglist *formal_arg = NULL;
3901 const char *f_ptr_out = "gfc_fptr__";
3903 if (f_ptr_name != NULL)
3904 f_ptr_out = f_ptr_name;
3906 gfc_get_sym_tree (f_ptr_out, ns, ¶m_symtree, false);
3907 if (param_symtree != NULL)
3908 param_sym = param_symtree->n.sym;
3910 gfc_internal_error ("generateFPtrParam(): Unable to "
3911 "create symbol for %s", f_ptr_out);
3913 /* Set up the necessary fields for the fptr output param sym. */
3916 param_sym->attr.proc_pointer = 1;
3918 param_sym->attr.pointer = 1;
3919 param_sym->attr.dummy = 1;
3920 param_sym->attr.use_assoc = 1;
3922 /* ISO C Binding type to allow any pointer type as actual param. */
3923 param_sym->ts.type = BT_VOID;
3924 param_sym->module = gfc_get_string (module_name);
3927 formal_arg = gfc_get_formal_arglist ();
3928 /* Add arg to list of formal args. */
3929 add_formal_arg (head, tail, formal_arg, param_sym);
3931 /* Validate changes. */
3932 gfc_commit_symbol (param_sym);
3936 /* Generates a symbol representing the optional SHAPE argument for the
3937 iso_c_binding c_f_pointer() procedure. Also, create a
3938 gfc_formal_arglist for the SHAPE and add it to the provided
3942 gen_shape_param (gfc_formal_arglist **head,
3943 gfc_formal_arglist **tail,
3944 const char *module_name,
3945 gfc_namespace *ns, const char *shape_param_name)
3947 gfc_symbol *param_sym = NULL;
3948 gfc_symtree *param_symtree = NULL;
3949 gfc_formal_arglist *formal_arg = NULL;
3950 const char *shape_param = "gfc_shape_array__";
3953 if (shape_param_name != NULL)
3954 shape_param = shape_param_name;
3956 gfc_get_sym_tree (shape_param, ns, ¶m_symtree, false);
3957 if (param_symtree != NULL)
3958 param_sym = param_symtree->n.sym;
3960 gfc_internal_error ("generateShapeParam(): Unable to "
3961 "create symbol for %s", shape_param);
3963 /* Set up the necessary fields for the shape input param sym. */
3965 param_sym->attr.dummy = 1;
3966 param_sym->attr.use_assoc = 1;
3968 /* Integer array, rank 1, describing the shape of the object. Make it's
3969 type BT_VOID initially so we can accept any type/kind combination of
3970 integer. During gfc_iso_c_sub_interface (resolve.c), we'll make it
3971 of BT_INTEGER type. */
3972 param_sym->ts.type = BT_VOID;
3974 /* Initialize the kind to default integer. However, it will be overridden
3975 during resolution to match the kind of the SHAPE parameter given as
3976 the actual argument (to allow for any valid integer kind). */
3977 param_sym->ts.kind = gfc_default_integer_kind;
3978 param_sym->as = gfc_get_array_spec ();
3980 /* Clear out the dimension info for the array. */
3981 for (i = 0; i < GFC_MAX_DIMENSIONS; i++)
3983 param_sym->as->lower[i] = NULL;
3984 param_sym->as->upper[i] = NULL;
3986 param_sym->as->rank = 1;
3987 param_sym->as->lower[0] = gfc_get_int_expr (gfc_default_integer_kind,
3990 /* The extent is unknown until we get it. The length give us
3991 the rank the incoming pointer. */
3992 param_sym->as->type = AS_ASSUMED_SHAPE;
3994 /* The arg is also optional; it is required iff the second arg
3995 (fptr) is to an array, otherwise, it's ignored. */
3996 param_sym->attr.optional = 1;
3997 param_sym->attr.intent = INTENT_IN;
3998 param_sym->attr.dimension = 1;
3999 param_sym->module = gfc_get_string (module_name);
4002 formal_arg = gfc_get_formal_arglist ();
4003 /* Add arg to list of formal args. */
4004 add_formal_arg (head, tail, formal_arg, param_sym);
4006 /* Validate changes. */
4007 gfc_commit_symbol (param_sym);
4011 /* Add a procedure interface to the given symbol (i.e., store a
4012 reference to the list of formal arguments). */
4015 add_proc_interface (gfc_symbol *sym, ifsrc source,
4016 gfc_formal_arglist *formal)
4019 sym->formal = formal;
4020 sym->attr.if_source = source;
4024 /* Copy the formal args from an existing symbol, src, into a new
4025 symbol, dest. New formal args are created, and the description of
4026 each arg is set according to the existing ones. This function is
4027 used when creating procedure declaration variables from a procedure
4028 declaration statement (see match_proc_decl()) to create the formal
4029 args based on the args of a given named interface. */
4032 gfc_copy_formal_args (gfc_symbol *dest, gfc_symbol *src)
4034 gfc_formal_arglist *head = NULL;
4035 gfc_formal_arglist *tail = NULL;
4036 gfc_formal_arglist *formal_arg = NULL;
4037 gfc_formal_arglist *curr_arg = NULL;
4038 gfc_formal_arglist *formal_prev = NULL;
4039 /* Save current namespace so we can change it for formal args. */
4040 gfc_namespace *parent_ns = gfc_current_ns;
4042 /* Create a new namespace, which will be the formal ns (namespace
4043 of the formal args). */
4044 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4045 gfc_current_ns->proc_name = dest;
4047 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4049 formal_arg = gfc_get_formal_arglist ();
4050 gfc_get_symbol (curr_arg->sym->name, gfc_current_ns, &(formal_arg->sym));
4052 /* May need to copy more info for the symbol. */
4053 formal_arg->sym->attr = curr_arg->sym->attr;
4054 formal_arg->sym->ts = curr_arg->sym->ts;
4055 formal_arg->sym->as = gfc_copy_array_spec (curr_arg->sym->as);
4056 gfc_copy_formal_args (formal_arg->sym, curr_arg->sym);
4058 /* If this isn't the first arg, set up the next ptr. For the
4059 last arg built, the formal_arg->next will never get set to
4060 anything other than NULL. */
4061 if (formal_prev != NULL)
4062 formal_prev->next = formal_arg;
4064 formal_arg->next = NULL;
4066 formal_prev = formal_arg;
4068 /* Add arg to list of formal args. */
4069 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4071 /* Validate changes. */
4072 gfc_commit_symbol (formal_arg->sym);
4075 /* Add the interface to the symbol. */
4076 add_proc_interface (dest, IFSRC_DECL, head);
4078 /* Store the formal namespace information. */
4079 if (dest->formal != NULL)
4080 /* The current ns should be that for the dest proc. */
4081 dest->formal_ns = gfc_current_ns;
4082 /* Restore the current namespace to what it was on entry. */
4083 gfc_current_ns = parent_ns;
4088 gfc_copy_formal_args_intr (gfc_symbol *dest, gfc_intrinsic_sym *src)
4090 gfc_formal_arglist *head = NULL;
4091 gfc_formal_arglist *tail = NULL;
4092 gfc_formal_arglist *formal_arg = NULL;
4093 gfc_intrinsic_arg *curr_arg = NULL;
4094 gfc_formal_arglist *formal_prev = NULL;
4095 /* Save current namespace so we can change it for formal args. */
4096 gfc_namespace *parent_ns = gfc_current_ns;
4098 /* Create a new namespace, which will be the formal ns (namespace
4099 of the formal args). */
4100 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4101 gfc_current_ns->proc_name = dest;
4103 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4105 formal_arg = gfc_get_formal_arglist ();
4106 gfc_get_symbol (curr_arg->name, gfc_current_ns, &(formal_arg->sym));
4108 /* May need to copy more info for the symbol. */
4109 formal_arg->sym->ts = curr_arg->ts;
4110 formal_arg->sym->attr.optional = curr_arg->optional;
4111 formal_arg->sym->attr.value = curr_arg->value;
4112 formal_arg->sym->attr.intent = curr_arg->intent;
4113 formal_arg->sym->attr.flavor = FL_VARIABLE;
4114 formal_arg->sym->attr.dummy = 1;
4116 if (formal_arg->sym->ts.type == BT_CHARACTER)
4117 formal_arg->sym->ts.u.cl = gfc_new_charlen (gfc_current_ns, NULL);
4119 /* If this isn't the first arg, set up the next ptr. For the
4120 last arg built, the formal_arg->next will never get set to
4121 anything other than NULL. */
4122 if (formal_prev != NULL)
4123 formal_prev->next = formal_arg;
4125 formal_arg->next = NULL;
4127 formal_prev = formal_arg;
4129 /* Add arg to list of formal args. */
4130 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4132 /* Validate changes. */
4133 gfc_commit_symbol (formal_arg->sym);
4136 /* Add the interface to the symbol. */
4137 add_proc_interface (dest, IFSRC_DECL, head);
4139 /* Store the formal namespace information. */
4140 if (dest->formal != NULL)
4141 /* The current ns should be that for the dest proc. */
4142 dest->formal_ns = gfc_current_ns;
4143 /* Restore the current namespace to what it was on entry. */
4144 gfc_current_ns = parent_ns;
4149 gfc_copy_formal_args_ppc (gfc_component *dest, gfc_symbol *src)
4151 gfc_formal_arglist *head = NULL;
4152 gfc_formal_arglist *tail = NULL;
4153 gfc_formal_arglist *formal_arg = NULL;
4154 gfc_formal_arglist *curr_arg = NULL;
4155 gfc_formal_arglist *formal_prev = NULL;
4156 /* Save current namespace so we can change it for formal args. */
4157 gfc_namespace *parent_ns = gfc_current_ns;
4159 /* Create a new namespace, which will be the formal ns (namespace
4160 of the formal args). */
4161 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4162 /* TODO: gfc_current_ns->proc_name = dest;*/
4164 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4166 formal_arg = gfc_get_formal_arglist ();
4167 gfc_get_symbol (curr_arg->sym->name, gfc_current_ns, &(formal_arg->sym));
4169 /* May need to copy more info for the symbol. */
4170 formal_arg->sym->attr = curr_arg->sym->attr;
4171 formal_arg->sym->ts = curr_arg->sym->ts;
4172 formal_arg->sym->as = gfc_copy_array_spec (curr_arg->sym->as);
4173 gfc_copy_formal_args (formal_arg->sym, curr_arg->sym);
4175 /* If this isn't the first arg, set up the next ptr. For the
4176 last arg built, the formal_arg->next will never get set to
4177 anything other than NULL. */
4178 if (formal_prev != NULL)
4179 formal_prev->next = formal_arg;
4181 formal_arg->next = NULL;
4183 formal_prev = formal_arg;
4185 /* Add arg to list of formal args. */
4186 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4188 /* Validate changes. */
4189 gfc_commit_symbol (formal_arg->sym);
4192 /* Add the interface to the symbol. */
4193 dest->formal = head;
4194 dest->attr.if_source = IFSRC_DECL;
4196 /* Store the formal namespace information. */
4197 if (dest->formal != NULL)
4198 /* The current ns should be that for the dest proc. */
4199 dest->formal_ns = gfc_current_ns;
4200 /* Restore the current namespace to what it was on entry. */
4201 gfc_current_ns = parent_ns;
4205 /* Builds the parameter list for the iso_c_binding procedure
4206 c_f_pointer or c_f_procpointer. The old_sym typically refers to a
4207 generic version of either the c_f_pointer or c_f_procpointer
4208 functions. The new_proc_sym represents a "resolved" version of the
4209 symbol. The functions are resolved to match the types of their
4210 parameters; for example, c_f_pointer(cptr, fptr) would resolve to
4211 something similar to c_f_pointer_i4 if the type of data object fptr
4212 pointed to was a default integer. The actual name of the resolved
4213 procedure symbol is further mangled with the module name, etc., but
4214 the idea holds true. */
4217 build_formal_args (gfc_symbol *new_proc_sym,
4218 gfc_symbol *old_sym, int add_optional_arg)
4220 gfc_formal_arglist *head = NULL, *tail = NULL;
4221 gfc_namespace *parent_ns = NULL;
4223 parent_ns = gfc_current_ns;
4224 /* Create a new namespace, which will be the formal ns (namespace
4225 of the formal args). */
4226 gfc_current_ns = gfc_get_namespace(parent_ns, 0);
4227 gfc_current_ns->proc_name = new_proc_sym;
4229 /* Generate the params. */
4230 if (old_sym->intmod_sym_id == ISOCBINDING_F_PROCPOINTER)
4232 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4233 gfc_current_ns, "cptr", old_sym->intmod_sym_id);
4234 gen_fptr_param (&head, &tail, (const char *) new_proc_sym->module,
4235 gfc_current_ns, "fptr", 1);
4237 else if (old_sym->intmod_sym_id == ISOCBINDING_F_POINTER)
4239 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4240 gfc_current_ns, "cptr", old_sym->intmod_sym_id);
4241 gen_fptr_param (&head, &tail, (const char *) new_proc_sym->module,
4242 gfc_current_ns, "fptr", 0);
4243 /* If we're dealing with c_f_pointer, it has an optional third arg. */
4244 gen_shape_param (&head, &tail,(const char *) new_proc_sym->module,
4245 gfc_current_ns, "shape");
4248 else if (old_sym->intmod_sym_id == ISOCBINDING_ASSOCIATED)
4250 /* c_associated has one required arg and one optional; both
4252 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4253 gfc_current_ns, "c_ptr_1", ISOCBINDING_ASSOCIATED);
4254 if (add_optional_arg)
4256 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4257 gfc_current_ns, "c_ptr_2", ISOCBINDING_ASSOCIATED);
4258 /* The last param is optional so mark it as such. */
4259 tail->sym->attr.optional = 1;
4263 /* Add the interface (store formal args to new_proc_sym). */
4264 add_proc_interface (new_proc_sym, IFSRC_DECL, head);
4266 /* Set up the formal_ns pointer to the one created for the
4267 new procedure so it'll get cleaned up during gfc_free_symbol(). */
4268 new_proc_sym->formal_ns = gfc_current_ns;
4270 gfc_current_ns = parent_ns;
4274 std_for_isocbinding_symbol (int id)
4278 #define NAMED_INTCST(a,b,c,d) \
4281 #include "iso-c-binding.def"
4284 #define NAMED_FUNCTION(a,b,c,d) \
4287 #include "iso-c-binding.def"
4288 #undef NAMED_FUNCTION
4291 return GFC_STD_F2003;
4295 /* Generate the given set of C interoperable kind objects, or all
4296 interoperable kinds. This function will only be given kind objects
4297 for valid iso_c_binding defined types because this is verified when
4298 the 'use' statement is parsed. If the user gives an 'only' clause,
4299 the specific kinds are looked up; if they don't exist, an error is
4300 reported. If the user does not give an 'only' clause, all
4301 iso_c_binding symbols are generated. If a list of specific kinds
4302 is given, it must have a NULL in the first empty spot to mark the
4307 generate_isocbinding_symbol (const char *mod_name, iso_c_binding_symbol s,
4308 const char *local_name)
4310 const char *const name = (local_name && local_name[0]) ? local_name
4311 : c_interop_kinds_table[s].name;
4312 gfc_symtree *tmp_symtree = NULL;
4313 gfc_symbol *tmp_sym = NULL;
4314 gfc_dt_list **dt_list_ptr = NULL;
4315 gfc_component *tmp_comp = NULL;
4316 char comp_name[(GFC_MAX_SYMBOL_LEN * 2) + 1];
4319 if (gfc_notification_std (std_for_isocbinding_symbol (s)) == ERROR)
4321 tmp_symtree = gfc_find_symtree (gfc_current_ns->sym_root, name);
4323 /* Already exists in this scope so don't re-add it.
4324 TODO: we should probably check that it's really the same symbol. */
4325 if (tmp_symtree != NULL)
4328 /* Create the sym tree in the current ns. */
4329 gfc_get_sym_tree (name, gfc_current_ns, &tmp_symtree, false);
4331 tmp_sym = tmp_symtree->n.sym;
4333 gfc_internal_error ("generate_isocbinding_symbol(): Unable to "
4336 /* Say what module this symbol belongs to. */
4337 tmp_sym->module = gfc_get_string (mod_name);
4338 tmp_sym->from_intmod = INTMOD_ISO_C_BINDING;
4339 tmp_sym->intmod_sym_id = s;
4344 #define NAMED_INTCST(a,b,c,d) case a :
4345 #define NAMED_REALCST(a,b,c) case a :
4346 #define NAMED_CMPXCST(a,b,c) case a :
4347 #define NAMED_LOGCST(a,b,c) case a :
4348 #define NAMED_CHARKNDCST(a,b,c) case a :
4349 #include "iso-c-binding.def"
4351 tmp_sym->value = gfc_get_int_expr (gfc_default_integer_kind, NULL,
4352 c_interop_kinds_table[s].value);
4354 /* Initialize an integer constant expression node. */
4355 tmp_sym->attr.flavor = FL_PARAMETER;
4356 tmp_sym->ts.type = BT_INTEGER;
4357 tmp_sym->ts.kind = gfc_default_integer_kind;
4359 /* Mark this type as a C interoperable one. */
4360 tmp_sym->ts.is_c_interop = 1;
4361 tmp_sym->ts.is_iso_c = 1;
4362 tmp_sym->value->ts.is_c_interop = 1;
4363 tmp_sym->value->ts.is_iso_c = 1;
4364 tmp_sym->attr.is_c_interop = 1;
4366 /* Tell what f90 type this c interop kind is valid. */
4367 tmp_sym->ts.f90_type = c_interop_kinds_table[s].f90_type;
4369 /* Say it's from the iso_c_binding module. */
4370 tmp_sym->attr.is_iso_c = 1;
4372 /* Make it use associated. */
4373 tmp_sym->attr.use_assoc = 1;
4377 #define NAMED_CHARCST(a,b,c) case a :
4378 #include "iso-c-binding.def"
4380 /* Initialize an integer constant expression node for the
4381 length of the character. */
4382 tmp_sym->value = gfc_get_character_expr (gfc_default_character_kind,
4383 &gfc_current_locus, NULL, 1);
4384 tmp_sym->value->ts.is_c_interop = 1;
4385 tmp_sym->value->ts.is_iso_c = 1;
4386 tmp_sym->value->value.character.length = 1;
4387 tmp_sym->value->value.character.string[0]
4388 = (gfc_char_t) c_interop_kinds_table[s].value;
4389 tmp_sym->ts.u.cl = gfc_new_charlen (gfc_current_ns, NULL);
4390 tmp_sym->ts.u.cl->length = gfc_get_int_expr (gfc_default_integer_kind,
4393 /* May not need this in both attr and ts, but do need in
4394 attr for writing module file. */
4395 tmp_sym->attr.is_c_interop = 1;
4397 tmp_sym->attr.flavor = FL_PARAMETER;
4398 tmp_sym->ts.type = BT_CHARACTER;
4400 /* Need to set it to the C_CHAR kind. */
4401 tmp_sym->ts.kind = gfc_default_character_kind;
4403 /* Mark this type as a C interoperable one. */
4404 tmp_sym->ts.is_c_interop = 1;
4405 tmp_sym->ts.is_iso_c = 1;
4407 /* Tell what f90 type this c interop kind is valid. */
4408 tmp_sym->ts.f90_type = BT_CHARACTER;
4410 /* Say it's from the iso_c_binding module. */
4411 tmp_sym->attr.is_iso_c = 1;
4413 /* Make it use associated. */
4414 tmp_sym->attr.use_assoc = 1;
4417 case ISOCBINDING_PTR:
4418 case ISOCBINDING_FUNPTR:
4420 /* Initialize an integer constant expression node. */
4421 tmp_sym->attr.flavor = FL_DERIVED;
4422 tmp_sym->ts.is_c_interop = 1;
4423 tmp_sym->attr.is_c_interop = 1;
4424 tmp_sym->attr.is_iso_c = 1;
4425 tmp_sym->ts.is_iso_c = 1;
4426 tmp_sym->ts.type = BT_DERIVED;
4428 /* A derived type must have the bind attribute to be
4429 interoperable (J3/04-007, Section 15.2.3), even though
4430 the binding label is not used. */
4431 tmp_sym->attr.is_bind_c = 1;
4433 tmp_sym->attr.referenced = 1;
4435 tmp_sym->ts.u.derived = tmp_sym;
4437 /* Add the symbol created for the derived type to the current ns. */
4438 dt_list_ptr = &(gfc_derived_types);
4439 while (*dt_list_ptr != NULL && (*dt_list_ptr)->next != NULL)
4440 dt_list_ptr = &((*dt_list_ptr)->next);
4442 /* There is already at least one derived type in the list, so append
4443 the one we're currently building for c_ptr or c_funptr. */
4444 if (*dt_list_ptr != NULL)
4445 dt_list_ptr = &((*dt_list_ptr)->next);
4446 (*dt_list_ptr) = gfc_get_dt_list ();
4447 (*dt_list_ptr)->derived = tmp_sym;
4448 (*dt_list_ptr)->next = NULL;
4450 /* Set up the component of the derived type, which will be
4451 an integer with kind equal to c_ptr_size. Mangle the name of
4452 the field for the c_address to prevent the curious user from
4453 trying to access it from Fortran. */
4454 sprintf (comp_name, "__%s_%s", tmp_sym->name, "c_address");
4455 gfc_add_component (tmp_sym, comp_name, &tmp_comp);
4456 if (tmp_comp == NULL)
4457 gfc_internal_error ("generate_isocbinding_symbol(): Unable to "
4458 "create component for c_address");
4460 tmp_comp->ts.type = BT_INTEGER;
4462 /* Set this because the module will need to read/write this field. */
4463 tmp_comp->ts.f90_type = BT_INTEGER;
4465 /* The kinds for c_ptr and c_funptr are the same. */
4466 index = get_c_kind ("c_ptr", c_interop_kinds_table);
4467 tmp_comp->ts.kind = c_interop_kinds_table[index].value;
4469 tmp_comp->attr.pointer = 0;
4470 tmp_comp->attr.dimension = 0;
4472 /* Mark the component as C interoperable. */
4473 tmp_comp->ts.is_c_interop = 1;
4475 /* Make it use associated (iso_c_binding module). */
4476 tmp_sym->attr.use_assoc = 1;
4479 case ISOCBINDING_NULL_PTR:
4480 case ISOCBINDING_NULL_FUNPTR:
4481 gen_special_c_interop_ptr (s, name, mod_name);
4484 case ISOCBINDING_F_POINTER:
4485 case ISOCBINDING_ASSOCIATED:
4486 case ISOCBINDING_LOC:
4487 case ISOCBINDING_FUNLOC:
4488 case ISOCBINDING_F_PROCPOINTER:
4490 tmp_sym->attr.proc = PROC_MODULE;
4492 /* Use the procedure's name as it is in the iso_c_binding module for
4493 setting the binding label in case the user renamed the symbol. */
4494 sprintf (tmp_sym->binding_label, "%s_%s", mod_name,
4495 c_interop_kinds_table[s].name);
4496 tmp_sym->attr.is_iso_c = 1;
4497 if (s == ISOCBINDING_F_POINTER || s == ISOCBINDING_F_PROCPOINTER)
4498 tmp_sym->attr.subroutine = 1;
4501 /* TODO! This needs to be finished more for the expr of the
4502 function or something!
4503 This may not need to be here, because trying to do c_loc
4505 if (s == ISOCBINDING_ASSOCIATED)
4507 tmp_sym->attr.function = 1;
4508 tmp_sym->ts.type = BT_LOGICAL;
4509 tmp_sym->ts.kind = gfc_default_logical_kind;
4510 tmp_sym->result = tmp_sym;
4514 /* Here, we're taking the simple approach. We're defining
4515 c_loc as an external identifier so the compiler will put
4516 what we expect on the stack for the address we want the
4518 tmp_sym->ts.type = BT_DERIVED;
4519 if (s == ISOCBINDING_LOC)
4520 tmp_sym->ts.u.derived =
4521 get_iso_c_binding_dt (ISOCBINDING_PTR);
4523 tmp_sym->ts.u.derived =
4524 get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
4526 if (tmp_sym->ts.u.derived == NULL)
4528 /* Create the necessary derived type so we can continue
4529 processing the file. */
4530 generate_isocbinding_symbol
4531 (mod_name, s == ISOCBINDING_FUNLOC
4532 ? ISOCBINDING_FUNPTR : ISOCBINDING_PTR,
4533 (const char *)(s == ISOCBINDING_FUNLOC
4534 ? "_gfortran_iso_c_binding_c_funptr"
4535 : "_gfortran_iso_c_binding_c_ptr"));
4536 tmp_sym->ts.u.derived =
4537 get_iso_c_binding_dt (s == ISOCBINDING_FUNLOC
4538 ? ISOCBINDING_FUNPTR
4542 /* The function result is itself (no result clause). */
4543 tmp_sym->result = tmp_sym;
4544 tmp_sym->attr.external = 1;
4545 tmp_sym->attr.use_assoc = 0;
4546 tmp_sym->attr.pure = 1;
4547 tmp_sym->attr.if_source = IFSRC_UNKNOWN;
4548 tmp_sym->attr.proc = PROC_UNKNOWN;
4552 tmp_sym->attr.flavor = FL_PROCEDURE;
4553 tmp_sym->attr.contained = 0;
4555 /* Try using this builder routine, with the new and old symbols
4556 both being the generic iso_c proc sym being created. This
4557 will create the formal args (and the new namespace for them).
4558 Don't build an arg list for c_loc because we're going to treat
4559 c_loc as an external procedure. */
4560 if (s != ISOCBINDING_LOC && s != ISOCBINDING_FUNLOC)
4561 /* The 1 says to add any optional args, if applicable. */
4562 build_formal_args (tmp_sym, tmp_sym, 1);
4564 /* Set this after setting up the symbol, to prevent error messages. */
4565 tmp_sym->attr.use_assoc = 1;
4567 /* This symbol will not be referenced directly. It will be
4568 resolved to the implementation for the given f90 kind. */
4569 tmp_sym->attr.referenced = 0;
4576 gfc_commit_symbol (tmp_sym);
4580 /* Creates a new symbol based off of an old iso_c symbol, with a new
4581 binding label. This function can be used to create a new,
4582 resolved, version of a procedure symbol for c_f_pointer or
4583 c_f_procpointer that is based on the generic symbols. A new
4584 parameter list is created for the new symbol using
4585 build_formal_args(). The add_optional_flag specifies whether the
4586 to add the optional SHAPE argument. The new symbol is
4590 get_iso_c_sym (gfc_symbol *old_sym, char *new_name,
4591 char *new_binding_label, int add_optional_arg)
4593 gfc_symtree *new_symtree = NULL;
4595 /* See if we have a symbol by that name already available, looking
4596 through any parent namespaces. */
4597 gfc_find_sym_tree (new_name, gfc_current_ns, 1, &new_symtree);
4598 if (new_symtree != NULL)
4599 /* Return the existing symbol. */
4600 return new_symtree->n.sym;
4602 /* Create the symtree/symbol, with attempted host association. */
4603 gfc_get_ha_sym_tree (new_name, &new_symtree);
4604 if (new_symtree == NULL)
4605 gfc_internal_error ("get_iso_c_sym(): Unable to create "
4606 "symtree for '%s'", new_name);
4608 /* Now fill in the fields of the resolved symbol with the old sym. */
4609 strcpy (new_symtree->n.sym->binding_label, new_binding_label);
4610 new_symtree->n.sym->attr = old_sym->attr;
4611 new_symtree->n.sym->ts = old_sym->ts;
4612 new_symtree->n.sym->module = gfc_get_string (old_sym->module);
4613 new_symtree->n.sym->from_intmod = old_sym->from_intmod;
4614 new_symtree->n.sym->intmod_sym_id = old_sym->intmod_sym_id;
4615 if (old_sym->attr.function)
4616 new_symtree->n.sym->result = new_symtree->n.sym;
4617 /* Build the formal arg list. */
4618 build_formal_args (new_symtree->n.sym, old_sym, add_optional_arg);
4620 gfc_commit_symbol (new_symtree->n.sym);
4622 return new_symtree->n.sym;
4626 /* Check that a symbol is already typed. If strict is not set, an untyped
4627 symbol is acceptable for non-standard-conforming mode. */
4630 gfc_check_symbol_typed (gfc_symbol* sym, gfc_namespace* ns,
4631 bool strict, locus where)
4635 if (gfc_matching_prefix)
4638 /* Check for the type and try to give it an implicit one. */
4639 if (sym->ts.type == BT_UNKNOWN
4640 && gfc_set_default_type (sym, 0, ns) == FAILURE)
4644 gfc_error ("Symbol '%s' is used before it is typed at %L",
4649 if (gfc_notify_std (GFC_STD_GNU,
4650 "Extension: Symbol '%s' is used before"
4651 " it is typed at %L", sym->name, &where) == FAILURE)
4655 /* Everything is ok. */
4660 /* Construct a typebound-procedure structure. Those are stored in a tentative
4661 list and marked `error' until symbols are committed. */
4664 gfc_get_typebound_proc (gfc_typebound_proc *tb0)
4666 gfc_typebound_proc *result;
4667 tentative_tbp *list_node;
4669 result = XCNEW (gfc_typebound_proc);
4674 list_node = XCNEW (tentative_tbp);
4675 list_node->next = tentative_tbp_list;
4676 list_node->proc = result;
4677 tentative_tbp_list = list_node;
4683 /* Get the super-type of a given derived type. */
4686 gfc_get_derived_super_type (gfc_symbol* derived)
4688 if (!derived->attr.extension)
4691 gcc_assert (derived->components);
4692 gcc_assert (derived->components->ts.type == BT_DERIVED);
4693 gcc_assert (derived->components->ts.u.derived);
4695 return derived->components->ts.u.derived;
4699 /* Get the ultimate super-type of a given derived type. */
4702 gfc_get_ultimate_derived_super_type (gfc_symbol* derived)
4704 if (!derived->attr.extension)
4707 derived = gfc_get_derived_super_type (derived);
4709 if (derived->attr.extension)
4710 return gfc_get_ultimate_derived_super_type (derived);
4716 /* Check if a derived type t2 is an extension of (or equal to) a type t1. */
4719 gfc_type_is_extension_of (gfc_symbol *t1, gfc_symbol *t2)
4721 while (!gfc_compare_derived_types (t1, t2) && t2->attr.extension)
4722 t2 = gfc_get_derived_super_type (t2);
4723 return gfc_compare_derived_types (t1, t2);
4727 /* Check if two typespecs are type compatible (F03:5.1.1.2):
4728 If ts1 is nonpolymorphic, ts2 must be the same type.
4729 If ts1 is polymorphic (CLASS), ts2 must be an extension of ts1. */
4732 gfc_type_compatible (gfc_typespec *ts1, gfc_typespec *ts2)
4734 bool is_class1 = (ts1->type == BT_CLASS);
4735 bool is_class2 = (ts2->type == BT_CLASS);
4736 bool is_derived1 = (ts1->type == BT_DERIVED);
4737 bool is_derived2 = (ts2->type == BT_DERIVED);
4739 if (!is_derived1 && !is_derived2 && !is_class1 && !is_class2)
4740 return (ts1->type == ts2->type);
4742 if (is_derived1 && is_derived2)
4743 return gfc_compare_derived_types (ts1->u.derived, ts2->u.derived);
4745 if (is_class1 && is_derived2)
4746 return gfc_type_is_extension_of (ts1->u.derived->components->ts.u.derived,
4748 else if (is_class1 && is_class2)
4749 return gfc_type_is_extension_of (ts1->u.derived->components->ts.u.derived,
4750 ts2->u.derived->components->ts.u.derived);
4756 /* Find the parent-namespace of the current function. If we're inside
4757 BLOCK constructs, it may not be the current one. */
4760 gfc_find_proc_namespace (gfc_namespace* ns)
4762 while (ns->construct_entities)
4772 /* Check if an associate-variable should be translated as an `implicit' pointer
4773 internally (if it is associated to a variable and not an array with
4777 gfc_is_associate_pointer (gfc_symbol* sym)
4782 if (!sym->assoc->variable)
4785 if (sym->attr.dimension && sym->as->type != AS_EXPLICIT)