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, const char *name, locus *where)
1101 if (check_used (attr, name, where))
1104 if (gfc_pure (NULL))
1107 ("SAVE attribute at %L cannot be specified in a PURE procedure",
1112 if (attr->save == SAVE_EXPLICIT && !attr->vtab)
1114 if (gfc_notify_std (GFC_STD_LEGACY,
1115 "Duplicate SAVE attribute specified at %L",
1121 attr->save = SAVE_EXPLICIT;
1122 return check_conflict (attr, name, where);
1127 gfc_add_value (symbol_attribute *attr, const char *name, locus *where)
1130 if (check_used (attr, name, where))
1135 if (gfc_notify_std (GFC_STD_LEGACY,
1136 "Duplicate VALUE attribute specified at %L",
1143 return check_conflict (attr, name, where);
1148 gfc_add_volatile (symbol_attribute *attr, const char *name, locus *where)
1150 /* No check_used needed as 11.2.1 of the F2003 standard allows
1151 that the local identifier made accessible by a use statement can be
1152 given a VOLATILE attribute - unless it is a coarray (F2008, C560). */
1154 if (attr->volatile_ && attr->volatile_ns == gfc_current_ns)
1155 if (gfc_notify_std (GFC_STD_LEGACY,
1156 "Duplicate VOLATILE attribute specified at %L", where)
1160 attr->volatile_ = 1;
1161 attr->volatile_ns = gfc_current_ns;
1162 return check_conflict (attr, name, where);
1167 gfc_add_asynchronous (symbol_attribute *attr, const char *name, locus *where)
1169 /* No check_used needed as 11.2.1 of the F2003 standard allows
1170 that the local identifier made accessible by a use statement can be
1171 given a ASYNCHRONOUS attribute. */
1173 if (attr->asynchronous && attr->asynchronous_ns == gfc_current_ns)
1174 if (gfc_notify_std (GFC_STD_LEGACY,
1175 "Duplicate ASYNCHRONOUS attribute specified at %L",
1179 attr->asynchronous = 1;
1180 attr->asynchronous_ns = gfc_current_ns;
1181 return check_conflict (attr, name, where);
1186 gfc_add_threadprivate (symbol_attribute *attr, const char *name, locus *where)
1189 if (check_used (attr, name, where))
1192 if (attr->threadprivate)
1194 duplicate_attr ("THREADPRIVATE", where);
1198 attr->threadprivate = 1;
1199 return check_conflict (attr, name, where);
1204 gfc_add_target (symbol_attribute *attr, locus *where)
1207 if (check_used (attr, NULL, where))
1212 duplicate_attr ("TARGET", where);
1217 return check_conflict (attr, NULL, where);
1222 gfc_add_dummy (symbol_attribute *attr, const char *name, locus *where)
1225 if (check_used (attr, name, where))
1228 /* Duplicate dummy arguments are allowed due to ENTRY statements. */
1230 return check_conflict (attr, name, where);
1235 gfc_add_in_common (symbol_attribute *attr, const char *name, locus *where)
1238 if (check_used (attr, name, where))
1241 /* Duplicate attribute already checked for. */
1242 attr->in_common = 1;
1243 return check_conflict (attr, name, where);
1248 gfc_add_in_equivalence (symbol_attribute *attr, const char *name, locus *where)
1251 /* Duplicate attribute already checked for. */
1252 attr->in_equivalence = 1;
1253 if (check_conflict (attr, name, where) == FAILURE)
1256 if (attr->flavor == FL_VARIABLE)
1259 return gfc_add_flavor (attr, FL_VARIABLE, name, where);
1264 gfc_add_data (symbol_attribute *attr, const char *name, locus *where)
1267 if (check_used (attr, name, where))
1271 return check_conflict (attr, name, where);
1276 gfc_add_in_namelist (symbol_attribute *attr, const char *name, locus *where)
1279 attr->in_namelist = 1;
1280 return check_conflict (attr, name, where);
1285 gfc_add_sequence (symbol_attribute *attr, const char *name, locus *where)
1288 if (check_used (attr, name, where))
1292 return check_conflict (attr, name, where);
1297 gfc_add_elemental (symbol_attribute *attr, locus *where)
1300 if (check_used (attr, NULL, where))
1303 if (attr->elemental)
1305 duplicate_attr ("ELEMENTAL", where);
1309 attr->elemental = 1;
1310 return check_conflict (attr, NULL, where);
1315 gfc_add_pure (symbol_attribute *attr, locus *where)
1318 if (check_used (attr, NULL, where))
1323 duplicate_attr ("PURE", where);
1328 return check_conflict (attr, NULL, where);
1333 gfc_add_recursive (symbol_attribute *attr, locus *where)
1336 if (check_used (attr, NULL, where))
1339 if (attr->recursive)
1341 duplicate_attr ("RECURSIVE", where);
1345 attr->recursive = 1;
1346 return check_conflict (attr, NULL, where);
1351 gfc_add_entry (symbol_attribute *attr, const char *name, locus *where)
1354 if (check_used (attr, name, where))
1359 duplicate_attr ("ENTRY", where);
1364 return check_conflict (attr, name, where);
1369 gfc_add_function (symbol_attribute *attr, const char *name, locus *where)
1372 if (attr->flavor != FL_PROCEDURE
1373 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1377 return check_conflict (attr, name, where);
1382 gfc_add_subroutine (symbol_attribute *attr, const char *name, locus *where)
1385 if (attr->flavor != FL_PROCEDURE
1386 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1389 attr->subroutine = 1;
1390 return check_conflict (attr, name, where);
1395 gfc_add_generic (symbol_attribute *attr, const char *name, locus *where)
1398 if (attr->flavor != FL_PROCEDURE
1399 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1403 return check_conflict (attr, name, where);
1408 gfc_add_proc (symbol_attribute *attr, const char *name, locus *where)
1411 if (check_used (attr, NULL, where))
1414 if (attr->flavor != FL_PROCEDURE
1415 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1418 if (attr->procedure)
1420 duplicate_attr ("PROCEDURE", where);
1424 attr->procedure = 1;
1426 return check_conflict (attr, NULL, where);
1431 gfc_add_abstract (symbol_attribute* attr, locus* where)
1435 duplicate_attr ("ABSTRACT", where);
1444 /* Flavors are special because some flavors are not what Fortran
1445 considers attributes and can be reaffirmed multiple times. */
1448 gfc_add_flavor (symbol_attribute *attr, sym_flavor f, const char *name,
1452 if ((f == FL_PROGRAM || f == FL_BLOCK_DATA || f == FL_MODULE
1453 || f == FL_PARAMETER || f == FL_LABEL || f == FL_DERIVED
1454 || f == FL_NAMELIST) && check_used (attr, name, where))
1457 if (attr->flavor == f && f == FL_VARIABLE)
1460 if (attr->flavor != FL_UNKNOWN)
1463 where = &gfc_current_locus;
1466 gfc_error ("%s attribute of '%s' conflicts with %s attribute at %L",
1467 gfc_code2string (flavors, attr->flavor), name,
1468 gfc_code2string (flavors, f), where);
1470 gfc_error ("%s attribute conflicts with %s attribute at %L",
1471 gfc_code2string (flavors, attr->flavor),
1472 gfc_code2string (flavors, f), where);
1479 return check_conflict (attr, name, where);
1484 gfc_add_procedure (symbol_attribute *attr, procedure_type t,
1485 const char *name, locus *where)
1488 if (check_used (attr, name, where))
1491 if (attr->flavor != FL_PROCEDURE
1492 && gfc_add_flavor (attr, FL_PROCEDURE, name, where) == FAILURE)
1496 where = &gfc_current_locus;
1498 if (attr->proc != PROC_UNKNOWN)
1500 gfc_error ("%s procedure at %L is already declared as %s procedure",
1501 gfc_code2string (procedures, t), where,
1502 gfc_code2string (procedures, attr->proc));
1509 /* Statement functions are always scalar and functions. */
1510 if (t == PROC_ST_FUNCTION
1511 && ((!attr->function && gfc_add_function (attr, name, where) == FAILURE)
1512 || attr->dimension))
1515 return check_conflict (attr, name, where);
1520 gfc_add_intent (symbol_attribute *attr, sym_intent intent, locus *where)
1523 if (check_used (attr, NULL, where))
1526 if (attr->intent == INTENT_UNKNOWN)
1528 attr->intent = intent;
1529 return check_conflict (attr, NULL, where);
1533 where = &gfc_current_locus;
1535 gfc_error ("INTENT (%s) conflicts with INTENT(%s) at %L",
1536 gfc_intent_string (attr->intent),
1537 gfc_intent_string (intent), where);
1543 /* No checks for use-association in public and private statements. */
1546 gfc_add_access (symbol_attribute *attr, gfc_access access,
1547 const char *name, locus *where)
1550 if (attr->access == ACCESS_UNKNOWN
1551 || (attr->use_assoc && attr->access != ACCESS_PRIVATE))
1553 attr->access = access;
1554 return check_conflict (attr, name, where);
1558 where = &gfc_current_locus;
1559 gfc_error ("ACCESS specification at %L was already specified", where);
1565 /* Set the is_bind_c field for the given symbol_attribute. */
1568 gfc_add_is_bind_c (symbol_attribute *attr, const char *name, locus *where,
1569 int is_proc_lang_bind_spec)
1572 if (is_proc_lang_bind_spec == 0 && attr->flavor == FL_PROCEDURE)
1573 gfc_error_now ("BIND(C) attribute at %L can only be used for "
1574 "variables or common blocks", where);
1575 else if (attr->is_bind_c)
1576 gfc_error_now ("Duplicate BIND attribute specified at %L", where);
1578 attr->is_bind_c = 1;
1581 where = &gfc_current_locus;
1583 if (gfc_notify_std (GFC_STD_F2003, "Fortran 2003: BIND(C) at %L", where)
1587 return check_conflict (attr, name, where);
1591 /* Set the extension field for the given symbol_attribute. */
1594 gfc_add_extension (symbol_attribute *attr, locus *where)
1597 where = &gfc_current_locus;
1599 if (attr->extension)
1600 gfc_error_now ("Duplicate EXTENDS attribute specified at %L", where);
1602 attr->extension = 1;
1604 if (gfc_notify_std (GFC_STD_F2003, "Fortran 2003: EXTENDS at %L", where)
1613 gfc_add_explicit_interface (gfc_symbol *sym, ifsrc source,
1614 gfc_formal_arglist * formal, locus *where)
1617 if (check_used (&sym->attr, sym->name, where))
1621 where = &gfc_current_locus;
1623 if (sym->attr.if_source != IFSRC_UNKNOWN
1624 && sym->attr.if_source != IFSRC_DECL)
1626 gfc_error ("Symbol '%s' at %L already has an explicit interface",
1631 if (source == IFSRC_IFBODY && (sym->attr.dimension || sym->attr.allocatable))
1633 gfc_error ("'%s' at %L has attributes specified outside its INTERFACE "
1634 "body", sym->name, where);
1638 sym->formal = formal;
1639 sym->attr.if_source = source;
1645 /* Add a type to a symbol. */
1648 gfc_add_type (gfc_symbol *sym, gfc_typespec *ts, locus *where)
1654 where = &gfc_current_locus;
1657 type = sym->result->ts.type;
1659 type = sym->ts.type;
1661 if (sym->attr.result && type == BT_UNKNOWN && sym->ns->proc_name)
1662 type = sym->ns->proc_name->ts.type;
1664 if (type != BT_UNKNOWN && !(sym->attr.function && sym->attr.implicit_type))
1666 gfc_error ("Symbol '%s' at %L already has basic type of %s", sym->name,
1667 where, gfc_basic_typename (type));
1671 if (sym->attr.procedure && sym->ts.interface)
1673 gfc_error ("Procedure '%s' at %L may not have basic type of %s",
1674 sym->name, where, gfc_basic_typename (ts->type));
1678 flavor = sym->attr.flavor;
1680 if (flavor == FL_PROGRAM || flavor == FL_BLOCK_DATA || flavor == FL_MODULE
1681 || flavor == FL_LABEL
1682 || (flavor == FL_PROCEDURE && sym->attr.subroutine)
1683 || flavor == FL_DERIVED || flavor == FL_NAMELIST)
1685 gfc_error ("Symbol '%s' at %L cannot have a type", sym->name, where);
1694 /* Clears all attributes. */
1697 gfc_clear_attr (symbol_attribute *attr)
1699 memset (attr, 0, sizeof (symbol_attribute));
1703 /* Check for missing attributes in the new symbol. Currently does
1704 nothing, but it's not clear that it is unnecessary yet. */
1707 gfc_missing_attr (symbol_attribute *attr ATTRIBUTE_UNUSED,
1708 locus *where ATTRIBUTE_UNUSED)
1715 /* Copy an attribute to a symbol attribute, bit by bit. Some
1716 attributes have a lot of side-effects but cannot be present given
1717 where we are called from, so we ignore some bits. */
1720 gfc_copy_attr (symbol_attribute *dest, symbol_attribute *src, locus *where)
1722 int is_proc_lang_bind_spec;
1724 /* In line with the other attributes, we only add bits but do not remove
1725 them; cf. also PR 41034. */
1726 dest->ext_attr |= src->ext_attr;
1728 if (src->allocatable && gfc_add_allocatable (dest, where) == FAILURE)
1731 if (src->dimension && gfc_add_dimension (dest, NULL, where) == FAILURE)
1733 if (src->codimension && gfc_add_codimension (dest, NULL, where) == FAILURE)
1735 if (src->contiguous && gfc_add_contiguous (dest, NULL, where) == FAILURE)
1737 if (src->optional && gfc_add_optional (dest, where) == FAILURE)
1739 if (src->pointer && gfc_add_pointer (dest, where) == FAILURE)
1741 if (src->is_protected && gfc_add_protected (dest, NULL, where) == FAILURE)
1743 if (src->save && gfc_add_save (dest, NULL, where) == FAILURE)
1745 if (src->value && gfc_add_value (dest, NULL, where) == FAILURE)
1747 if (src->volatile_ && gfc_add_volatile (dest, NULL, where) == FAILURE)
1749 if (src->asynchronous && gfc_add_asynchronous (dest, NULL, where) == FAILURE)
1751 if (src->threadprivate
1752 && gfc_add_threadprivate (dest, NULL, where) == FAILURE)
1754 if (src->target && gfc_add_target (dest, where) == FAILURE)
1756 if (src->dummy && gfc_add_dummy (dest, NULL, where) == FAILURE)
1758 if (src->result && gfc_add_result (dest, NULL, where) == FAILURE)
1763 if (src->in_namelist && gfc_add_in_namelist (dest, NULL, where) == FAILURE)
1766 if (src->in_common && gfc_add_in_common (dest, NULL, where) == FAILURE)
1769 if (src->generic && gfc_add_generic (dest, NULL, where) == FAILURE)
1771 if (src->function && gfc_add_function (dest, NULL, where) == FAILURE)
1773 if (src->subroutine && gfc_add_subroutine (dest, NULL, where) == FAILURE)
1776 if (src->sequence && gfc_add_sequence (dest, NULL, where) == FAILURE)
1778 if (src->elemental && gfc_add_elemental (dest, where) == FAILURE)
1780 if (src->pure && gfc_add_pure (dest, where) == FAILURE)
1782 if (src->recursive && gfc_add_recursive (dest, where) == FAILURE)
1785 if (src->flavor != FL_UNKNOWN
1786 && gfc_add_flavor (dest, src->flavor, NULL, where) == FAILURE)
1789 if (src->intent != INTENT_UNKNOWN
1790 && gfc_add_intent (dest, src->intent, where) == FAILURE)
1793 if (src->access != ACCESS_UNKNOWN
1794 && gfc_add_access (dest, src->access, NULL, where) == FAILURE)
1797 if (gfc_missing_attr (dest, where) == FAILURE)
1800 if (src->cray_pointer && gfc_add_cray_pointer (dest, where) == FAILURE)
1802 if (src->cray_pointee && gfc_add_cray_pointee (dest, where) == FAILURE)
1805 is_proc_lang_bind_spec = (src->flavor == FL_PROCEDURE ? 1 : 0);
1807 && gfc_add_is_bind_c (dest, NULL, where, is_proc_lang_bind_spec)
1811 if (src->is_c_interop)
1812 dest->is_c_interop = 1;
1816 if (src->external && gfc_add_external (dest, where) == FAILURE)
1818 if (src->intrinsic && gfc_add_intrinsic (dest, where) == FAILURE)
1820 if (src->proc_pointer)
1821 dest->proc_pointer = 1;
1830 /************** Component name management ************/
1832 /* Component names of a derived type form their own little namespaces
1833 that are separate from all other spaces. The space is composed of
1834 a singly linked list of gfc_component structures whose head is
1835 located in the parent symbol. */
1838 /* Add a component name to a symbol. The call fails if the name is
1839 already present. On success, the component pointer is modified to
1840 point to the additional component structure. */
1843 gfc_add_component (gfc_symbol *sym, const char *name,
1844 gfc_component **component)
1846 gfc_component *p, *tail;
1850 for (p = sym->components; p; p = p->next)
1852 if (strcmp (p->name, name) == 0)
1854 gfc_error ("Component '%s' at %C already declared at %L",
1862 if (sym->attr.extension
1863 && gfc_find_component (sym->components->ts.u.derived, name, true, true))
1865 gfc_error ("Component '%s' at %C already in the parent type "
1866 "at %L", name, &sym->components->ts.u.derived->declared_at);
1870 /* Allocate a new component. */
1871 p = gfc_get_component ();
1874 sym->components = p;
1878 p->name = gfc_get_string (name);
1879 p->loc = gfc_current_locus;
1880 p->ts.type = BT_UNKNOWN;
1887 /* Recursive function to switch derived types of all symbol in a
1891 switch_types (gfc_symtree *st, gfc_symbol *from, gfc_symbol *to)
1899 if (sym->ts.type == BT_DERIVED && sym->ts.u.derived == from)
1900 sym->ts.u.derived = to;
1902 switch_types (st->left, from, to);
1903 switch_types (st->right, from, to);
1907 /* This subroutine is called when a derived type is used in order to
1908 make the final determination about which version to use. The
1909 standard requires that a type be defined before it is 'used', but
1910 such types can appear in IMPLICIT statements before the actual
1911 definition. 'Using' in this context means declaring a variable to
1912 be that type or using the type constructor.
1914 If a type is used and the components haven't been defined, then we
1915 have to have a derived type in a parent unit. We find the node in
1916 the other namespace and point the symtree node in this namespace to
1917 that node. Further reference to this name point to the correct
1918 node. If we can't find the node in a parent namespace, then we have
1921 This subroutine takes a pointer to a symbol node and returns a
1922 pointer to the translated node or NULL for an error. Usually there
1923 is no translation and we return the node we were passed. */
1926 gfc_use_derived (gfc_symbol *sym)
1933 if (sym->components != NULL || sym->attr.zero_comp)
1934 return sym; /* Already defined. */
1936 if (sym->ns->parent == NULL)
1939 if (gfc_find_symbol (sym->name, sym->ns->parent, 1, &s))
1941 gfc_error ("Symbol '%s' at %C is ambiguous", sym->name);
1945 if (s == NULL || s->attr.flavor != FL_DERIVED)
1948 /* Get rid of symbol sym, translating all references to s. */
1949 for (i = 0; i < GFC_LETTERS; i++)
1951 t = &sym->ns->default_type[i];
1952 if (t->u.derived == sym)
1956 st = gfc_find_symtree (sym->ns->sym_root, sym->name);
1961 /* Unlink from list of modified symbols. */
1962 gfc_commit_symbol (sym);
1964 switch_types (sym->ns->sym_root, sym, s);
1966 /* TODO: Also have to replace sym -> s in other lists like
1967 namelists, common lists and interface lists. */
1968 gfc_free_symbol (sym);
1973 gfc_error ("Derived type '%s' at %C is being used before it is defined",
1979 /* Given a derived type node and a component name, try to locate the
1980 component structure. Returns the NULL pointer if the component is
1981 not found or the components are private. If noaccess is set, no access
1985 gfc_find_component (gfc_symbol *sym, const char *name,
1986 bool noaccess, bool silent)
1993 sym = gfc_use_derived (sym);
1998 for (p = sym->components; p; p = p->next)
1999 if (strcmp (p->name, name) == 0)
2003 && sym->attr.extension
2004 && sym->components->ts.type == BT_DERIVED)
2006 p = gfc_find_component (sym->components->ts.u.derived, name,
2008 /* Do not overwrite the error. */
2013 if (p == NULL && !silent)
2014 gfc_error ("'%s' at %C is not a member of the '%s' structure",
2017 else if (sym->attr.use_assoc && !noaccess)
2019 bool is_parent_comp = sym->attr.extension && (p == sym->components);
2020 if (p->attr.access == ACCESS_PRIVATE ||
2021 (p->attr.access != ACCESS_PUBLIC
2022 && sym->component_access == ACCESS_PRIVATE
2023 && !is_parent_comp))
2026 gfc_error ("Component '%s' at %C is a PRIVATE component of '%s'",
2036 /* Given a symbol, free all of the component structures and everything
2040 free_components (gfc_component *p)
2048 gfc_free_array_spec (p->as);
2049 gfc_free_expr (p->initializer);
2056 /******************** Statement label management ********************/
2058 /* Comparison function for statement labels, used for managing the
2062 compare_st_labels (void *a1, void *b1)
2064 int a = ((gfc_st_label *) a1)->value;
2065 int b = ((gfc_st_label *) b1)->value;
2071 /* Free a single gfc_st_label structure, making sure the tree is not
2072 messed up. This function is called only when some parse error
2076 gfc_free_st_label (gfc_st_label *label)
2082 gfc_delete_bbt (&gfc_current_ns->st_labels, label, compare_st_labels);
2084 if (label->format != NULL)
2085 gfc_free_expr (label->format);
2091 /* Free a whole tree of gfc_st_label structures. */
2094 free_st_labels (gfc_st_label *label)
2100 free_st_labels (label->left);
2101 free_st_labels (label->right);
2103 if (label->format != NULL)
2104 gfc_free_expr (label->format);
2109 /* Given a label number, search for and return a pointer to the label
2110 structure, creating it if it does not exist. */
2113 gfc_get_st_label (int labelno)
2118 /* Find the namespace of the scoping unit:
2119 If we're in a BLOCK construct, jump to the parent namespace. */
2120 ns = gfc_current_ns;
2121 while (ns->proc_name && ns->proc_name->attr.flavor == FL_LABEL)
2124 /* First see if the label is already in this namespace. */
2128 if (lp->value == labelno)
2131 if (lp->value < labelno)
2137 lp = XCNEW (gfc_st_label);
2139 lp->value = labelno;
2140 lp->defined = ST_LABEL_UNKNOWN;
2141 lp->referenced = ST_LABEL_UNKNOWN;
2143 gfc_insert_bbt (&ns->st_labels, lp, compare_st_labels);
2149 /* Called when a statement with a statement label is about to be
2150 accepted. We add the label to the list of the current namespace,
2151 making sure it hasn't been defined previously and referenced
2155 gfc_define_st_label (gfc_st_label *lp, gfc_sl_type type, locus *label_locus)
2159 labelno = lp->value;
2161 if (lp->defined != ST_LABEL_UNKNOWN)
2162 gfc_error ("Duplicate statement label %d at %L and %L", labelno,
2163 &lp->where, label_locus);
2166 lp->where = *label_locus;
2170 case ST_LABEL_FORMAT:
2171 if (lp->referenced == ST_LABEL_TARGET)
2172 gfc_error ("Label %d at %C already referenced as branch target",
2175 lp->defined = ST_LABEL_FORMAT;
2179 case ST_LABEL_TARGET:
2180 if (lp->referenced == ST_LABEL_FORMAT)
2181 gfc_error ("Label %d at %C already referenced as a format label",
2184 lp->defined = ST_LABEL_TARGET;
2189 lp->defined = ST_LABEL_BAD_TARGET;
2190 lp->referenced = ST_LABEL_BAD_TARGET;
2196 /* Reference a label. Given a label and its type, see if that
2197 reference is consistent with what is known about that label,
2198 updating the unknown state. Returns FAILURE if something goes
2202 gfc_reference_st_label (gfc_st_label *lp, gfc_sl_type type)
2204 gfc_sl_type label_type;
2211 labelno = lp->value;
2213 if (lp->defined != ST_LABEL_UNKNOWN)
2214 label_type = lp->defined;
2217 label_type = lp->referenced;
2218 lp->where = gfc_current_locus;
2221 if (label_type == ST_LABEL_FORMAT && type == ST_LABEL_TARGET)
2223 gfc_error ("Label %d at %C previously used as a FORMAT label", labelno);
2228 if ((label_type == ST_LABEL_TARGET || label_type == ST_LABEL_BAD_TARGET)
2229 && type == ST_LABEL_FORMAT)
2231 gfc_error ("Label %d at %C previously used as branch target", labelno);
2236 lp->referenced = type;
2244 /*******A helper function for creating new expressions*************/
2248 gfc_lval_expr_from_sym (gfc_symbol *sym)
2251 lval = gfc_get_expr ();
2252 lval->expr_type = EXPR_VARIABLE;
2253 lval->where = sym->declared_at;
2255 lval->symtree = gfc_find_symtree (sym->ns->sym_root, sym->name);
2257 /* It will always be a full array. */
2258 lval->rank = sym->as ? sym->as->rank : 0;
2261 lval->ref = gfc_get_ref ();
2262 lval->ref->type = REF_ARRAY;
2263 lval->ref->u.ar.type = AR_FULL;
2264 lval->ref->u.ar.dimen = lval->rank;
2265 lval->ref->u.ar.where = sym->declared_at;
2266 lval->ref->u.ar.as = sym->as;
2273 /************** Symbol table management subroutines ****************/
2275 /* Basic details: Fortran 95 requires a potentially unlimited number
2276 of distinct namespaces when compiling a program unit. This case
2277 occurs during a compilation of internal subprograms because all of
2278 the internal subprograms must be read before we can start
2279 generating code for the host.
2281 Given the tricky nature of the Fortran grammar, we must be able to
2282 undo changes made to a symbol table if the current interpretation
2283 of a statement is found to be incorrect. Whenever a symbol is
2284 looked up, we make a copy of it and link to it. All of these
2285 symbols are kept in a singly linked list so that we can commit or
2286 undo the changes at a later time.
2288 A symtree may point to a symbol node outside of its namespace. In
2289 this case, that symbol has been used as a host associated variable
2290 at some previous time. */
2292 /* Allocate a new namespace structure. Copies the implicit types from
2293 PARENT if PARENT_TYPES is set. */
2296 gfc_get_namespace (gfc_namespace *parent, int parent_types)
2303 ns = XCNEW (gfc_namespace);
2304 ns->sym_root = NULL;
2305 ns->uop_root = NULL;
2306 ns->tb_sym_root = NULL;
2307 ns->finalizers = NULL;
2308 ns->default_access = ACCESS_UNKNOWN;
2309 ns->parent = parent;
2311 for (in = GFC_INTRINSIC_BEGIN; in != GFC_INTRINSIC_END; in++)
2313 ns->operator_access[in] = ACCESS_UNKNOWN;
2314 ns->tb_op[in] = NULL;
2317 /* Initialize default implicit types. */
2318 for (i = 'a'; i <= 'z'; i++)
2320 ns->set_flag[i - 'a'] = 0;
2321 ts = &ns->default_type[i - 'a'];
2323 if (parent_types && ns->parent != NULL)
2325 /* Copy parent settings. */
2326 *ts = ns->parent->default_type[i - 'a'];
2330 if (gfc_option.flag_implicit_none != 0)
2336 if ('i' <= i && i <= 'n')
2338 ts->type = BT_INTEGER;
2339 ts->kind = gfc_default_integer_kind;
2344 ts->kind = gfc_default_real_kind;
2354 /* Comparison function for symtree nodes. */
2357 compare_symtree (void *_st1, void *_st2)
2359 gfc_symtree *st1, *st2;
2361 st1 = (gfc_symtree *) _st1;
2362 st2 = (gfc_symtree *) _st2;
2364 return strcmp (st1->name, st2->name);
2368 /* Allocate a new symtree node and associate it with the new symbol. */
2371 gfc_new_symtree (gfc_symtree **root, const char *name)
2375 st = XCNEW (gfc_symtree);
2376 st->name = gfc_get_string (name);
2378 gfc_insert_bbt (root, st, compare_symtree);
2383 /* Delete a symbol from the tree. Does not free the symbol itself! */
2386 gfc_delete_symtree (gfc_symtree **root, const char *name)
2388 gfc_symtree st, *st0;
2390 st0 = gfc_find_symtree (*root, name);
2392 st.name = gfc_get_string (name);
2393 gfc_delete_bbt (root, &st, compare_symtree);
2399 /* Given a root symtree node and a name, try to find the symbol within
2400 the namespace. Returns NULL if the symbol is not found. */
2403 gfc_find_symtree (gfc_symtree *st, const char *name)
2409 c = strcmp (name, st->name);
2413 st = (c < 0) ? st->left : st->right;
2420 /* Return a symtree node with a name that is guaranteed to be unique
2421 within the namespace and corresponds to an illegal fortran name. */
2424 gfc_get_unique_symtree (gfc_namespace *ns)
2426 char name[GFC_MAX_SYMBOL_LEN + 1];
2427 static int serial = 0;
2429 sprintf (name, "@%d", serial++);
2430 return gfc_new_symtree (&ns->sym_root, name);
2434 /* Given a name find a user operator node, creating it if it doesn't
2435 exist. These are much simpler than symbols because they can't be
2436 ambiguous with one another. */
2439 gfc_get_uop (const char *name)
2444 st = gfc_find_symtree (gfc_current_ns->uop_root, name);
2448 st = gfc_new_symtree (&gfc_current_ns->uop_root, name);
2450 uop = st->n.uop = XCNEW (gfc_user_op);
2451 uop->name = gfc_get_string (name);
2452 uop->access = ACCESS_UNKNOWN;
2453 uop->ns = gfc_current_ns;
2459 /* Given a name find the user operator node. Returns NULL if it does
2463 gfc_find_uop (const char *name, gfc_namespace *ns)
2468 ns = gfc_current_ns;
2470 st = gfc_find_symtree (ns->uop_root, name);
2471 return (st == NULL) ? NULL : st->n.uop;
2475 /* Remove a gfc_symbol structure and everything it points to. */
2478 gfc_free_symbol (gfc_symbol *sym)
2484 gfc_free_array_spec (sym->as);
2486 free_components (sym->components);
2488 gfc_free_expr (sym->value);
2490 gfc_free_namelist (sym->namelist);
2492 gfc_free_namespace (sym->formal_ns);
2494 if (!sym->attr.generic_copy)
2495 gfc_free_interface (sym->generic);
2497 gfc_free_formal_arglist (sym->formal);
2499 gfc_free_namespace (sym->f2k_derived);
2505 /* Decrease the reference counter and free memory when we reach zero. */
2508 gfc_release_symbol (gfc_symbol *sym)
2513 if (sym->formal_ns != NULL && sym->refs == 2)
2515 /* As formal_ns contains a reference to sym, delete formal_ns just
2516 before the deletion of sym. */
2517 gfc_namespace *ns = sym->formal_ns;
2518 sym->formal_ns = NULL;
2519 gfc_free_namespace (ns);
2526 gcc_assert (sym->refs == 0);
2527 gfc_free_symbol (sym);
2531 /* Allocate and initialize a new symbol node. */
2534 gfc_new_symbol (const char *name, gfc_namespace *ns)
2538 p = XCNEW (gfc_symbol);
2540 gfc_clear_ts (&p->ts);
2541 gfc_clear_attr (&p->attr);
2544 p->declared_at = gfc_current_locus;
2546 if (strlen (name) > GFC_MAX_SYMBOL_LEN)
2547 gfc_internal_error ("new_symbol(): Symbol name too long");
2549 p->name = gfc_get_string (name);
2551 /* Make sure flags for symbol being C bound are clear initially. */
2552 p->attr.is_bind_c = 0;
2553 p->attr.is_iso_c = 0;
2554 /* Make sure the binding label field has a Nul char to start. */
2555 p->binding_label[0] = '\0';
2557 /* Clear the ptrs we may need. */
2558 p->common_block = NULL;
2559 p->f2k_derived = NULL;
2566 /* Generate an error if a symbol is ambiguous. */
2569 ambiguous_symbol (const char *name, gfc_symtree *st)
2572 if (st->n.sym->module)
2573 gfc_error ("Name '%s' at %C is an ambiguous reference to '%s' "
2574 "from module '%s'", name, st->n.sym->name, st->n.sym->module);
2576 gfc_error ("Name '%s' at %C is an ambiguous reference to '%s' "
2577 "from current program unit", name, st->n.sym->name);
2581 /* If we're in a SELECT TYPE block, check if the variable 'st' matches any
2582 selector on the stack. If yes, replace it by the corresponding temporary. */
2585 select_type_insert_tmp (gfc_symtree **st)
2587 gfc_select_type_stack *stack = select_type_stack;
2588 for (; stack; stack = stack->prev)
2589 if ((*st)->n.sym == stack->selector && stack->tmp)
2594 /* Look for a symtree in the current procedure -- that is, go up to
2595 parent namespaces but only if inside a BLOCK. Returns NULL if not found. */
2598 gfc_find_symtree_in_proc (const char* name, gfc_namespace* ns)
2602 gfc_symtree* st = gfc_find_symtree (ns->sym_root, name);
2606 if (!ns->construct_entities)
2615 /* Search for a symtree starting in the current namespace, resorting to
2616 any parent namespaces if requested by a nonzero parent_flag.
2617 Returns nonzero if the name is ambiguous. */
2620 gfc_find_sym_tree (const char *name, gfc_namespace *ns, int parent_flag,
2621 gfc_symtree **result)
2626 ns = gfc_current_ns;
2630 st = gfc_find_symtree (ns->sym_root, name);
2633 select_type_insert_tmp (&st);
2636 /* Ambiguous generic interfaces are permitted, as long
2637 as the specific interfaces are different. */
2638 if (st->ambiguous && !st->n.sym->attr.generic)
2640 ambiguous_symbol (name, st);
2659 /* Same, but returns the symbol instead. */
2662 gfc_find_symbol (const char *name, gfc_namespace *ns, int parent_flag,
2663 gfc_symbol **result)
2668 i = gfc_find_sym_tree (name, ns, parent_flag, &st);
2673 *result = st->n.sym;
2679 /* Save symbol with the information necessary to back it out. */
2682 save_symbol_data (gfc_symbol *sym)
2685 if (sym->gfc_new || sym->old_symbol != NULL)
2688 sym->old_symbol = XCNEW (gfc_symbol);
2689 *(sym->old_symbol) = *sym;
2691 sym->tlink = changed_syms;
2696 /* Given a name, find a symbol, or create it if it does not exist yet
2697 in the current namespace. If the symbol is found we make sure that
2700 The integer return code indicates
2702 1 The symbol name was ambiguous
2703 2 The name meant to be established was already host associated.
2705 So if the return value is nonzero, then an error was issued. */
2708 gfc_get_sym_tree (const char *name, gfc_namespace *ns, gfc_symtree **result,
2709 bool allow_subroutine)
2714 /* This doesn't usually happen during resolution. */
2716 ns = gfc_current_ns;
2718 /* Try to find the symbol in ns. */
2719 st = gfc_find_symtree (ns->sym_root, name);
2723 /* If not there, create a new symbol. */
2724 p = gfc_new_symbol (name, ns);
2726 /* Add to the list of tentative symbols. */
2727 p->old_symbol = NULL;
2728 p->tlink = changed_syms;
2733 st = gfc_new_symtree (&ns->sym_root, name);
2740 /* Make sure the existing symbol is OK. Ambiguous
2741 generic interfaces are permitted, as long as the
2742 specific interfaces are different. */
2743 if (st->ambiguous && !st->n.sym->attr.generic)
2745 ambiguous_symbol (name, st);
2750 if (p->ns != ns && (!p->attr.function || ns->proc_name != p)
2751 && !(allow_subroutine && p->attr.subroutine)
2752 && !(ns->proc_name && ns->proc_name->attr.if_source == IFSRC_IFBODY
2753 && (ns->has_import_set || p->attr.imported)))
2755 /* Symbol is from another namespace. */
2756 gfc_error ("Symbol '%s' at %C has already been host associated",
2763 /* Copy in case this symbol is changed. */
2764 save_symbol_data (p);
2773 gfc_get_symbol (const char *name, gfc_namespace *ns, gfc_symbol **result)
2778 i = gfc_get_sym_tree (name, ns, &st, false);
2783 *result = st->n.sym;
2790 /* Subroutine that searches for a symbol, creating it if it doesn't
2791 exist, but tries to host-associate the symbol if possible. */
2794 gfc_get_ha_sym_tree (const char *name, gfc_symtree **result)
2799 i = gfc_find_sym_tree (name, gfc_current_ns, 0, &st);
2803 save_symbol_data (st->n.sym);
2808 if (gfc_current_ns->parent != NULL)
2810 i = gfc_find_sym_tree (name, gfc_current_ns->parent, 1, &st);
2821 return gfc_get_sym_tree (name, gfc_current_ns, result, false);
2826 gfc_get_ha_symbol (const char *name, gfc_symbol **result)
2831 i = gfc_get_ha_sym_tree (name, &st);
2834 *result = st->n.sym;
2841 /* Return true if both symbols could refer to the same data object. Does
2842 not take account of aliasing due to equivalence statements. */
2845 gfc_symbols_could_alias (gfc_symbol *lsym, gfc_symbol *rsym)
2847 /* Aliasing isn't possible if the symbols have different base types. */
2848 if (gfc_compare_types (&lsym->ts, &rsym->ts) == 0)
2851 /* Pointers can point to other pointers, target objects and allocatable
2852 objects. Two allocatable objects cannot share the same storage. */
2853 if (lsym->attr.pointer
2854 && (rsym->attr.pointer || rsym->attr.allocatable || rsym->attr.target))
2856 if (lsym->attr.target && rsym->attr.pointer)
2858 if (lsym->attr.allocatable && rsym->attr.pointer)
2861 /* Special case: Argument association, cf. F90 12.4.1.6, F2003 12.4.1.7
2862 and F2008 12.5.2.13 items 3b and 4b. The pointer case (a) is already
2864 if (lsym->attr.target && rsym->attr.target
2865 && ((lsym->attr.dummy && !lsym->attr.contiguous
2866 && (!lsym->attr.dimension || lsym->as->type == AS_ASSUMED_SHAPE))
2867 || (rsym->attr.dummy && !rsym->attr.contiguous
2868 && (!rsym->attr.dimension
2869 || rsym->as->type == AS_ASSUMED_SHAPE))))
2876 /* Undoes all the changes made to symbols in the current statement.
2877 This subroutine is made simpler due to the fact that attributes are
2878 never removed once added. */
2881 gfc_undo_symbols (void)
2883 gfc_symbol *p, *q, *old;
2884 tentative_tbp *tbp, *tbq;
2886 for (p = changed_syms; p; p = q)
2892 /* Symbol was new. */
2893 if (p->attr.in_common && p->common_block && p->common_block->head)
2895 /* If the symbol was added to any common block, it
2896 needs to be removed to stop the resolver looking
2897 for a (possibly) dead symbol. */
2899 if (p->common_block->head == p)
2900 p->common_block->head = p->common_next;
2903 gfc_symbol *cparent, *csym;
2905 cparent = p->common_block->head;
2906 csym = cparent->common_next;
2911 csym = csym->common_next;
2914 gcc_assert(cparent->common_next == p);
2916 cparent->common_next = csym->common_next;
2920 gfc_delete_symtree (&p->ns->sym_root, p->name);
2922 gfc_release_symbol (p);
2926 /* Restore previous state of symbol. Just copy simple stuff. */
2928 old = p->old_symbol;
2930 p->ts.type = old->ts.type;
2931 p->ts.kind = old->ts.kind;
2933 p->attr = old->attr;
2935 if (p->value != old->value)
2937 gfc_free_expr (old->value);
2941 if (p->as != old->as)
2944 gfc_free_array_spec (p->as);
2948 p->generic = old->generic;
2949 p->component_access = old->component_access;
2951 if (p->namelist != NULL && old->namelist == NULL)
2953 gfc_free_namelist (p->namelist);
2958 if (p->namelist_tail != old->namelist_tail)
2960 gfc_free_namelist (old->namelist_tail);
2961 old->namelist_tail->next = NULL;
2965 p->namelist_tail = old->namelist_tail;
2967 if (p->formal != old->formal)
2969 gfc_free_formal_arglist (p->formal);
2970 p->formal = old->formal;
2973 gfc_free (p->old_symbol);
2974 p->old_symbol = NULL;
2978 changed_syms = NULL;
2980 for (tbp = tentative_tbp_list; tbp; tbp = tbq)
2983 /* Procedure is already marked `error' by default. */
2986 tentative_tbp_list = NULL;
2990 /* Free sym->old_symbol. sym->old_symbol is mostly a shallow copy of sym; the
2991 components of old_symbol that might need deallocation are the "allocatables"
2992 that are restored in gfc_undo_symbols(), with two exceptions: namelist and
2993 namelist_tail. In case these differ between old_symbol and sym, it's just
2994 because sym->namelist has gotten a few more items. */
2997 free_old_symbol (gfc_symbol *sym)
3000 if (sym->old_symbol == NULL)
3003 if (sym->old_symbol->as != sym->as)
3004 gfc_free_array_spec (sym->old_symbol->as);
3006 if (sym->old_symbol->value != sym->value)
3007 gfc_free_expr (sym->old_symbol->value);
3009 if (sym->old_symbol->formal != sym->formal)
3010 gfc_free_formal_arglist (sym->old_symbol->formal);
3012 gfc_free (sym->old_symbol);
3013 sym->old_symbol = NULL;
3017 /* Makes the changes made in the current statement permanent-- gets
3018 rid of undo information. */
3021 gfc_commit_symbols (void)
3024 tentative_tbp *tbp, *tbq;
3026 for (p = changed_syms; p; p = q)
3032 free_old_symbol (p);
3034 changed_syms = NULL;
3036 for (tbp = tentative_tbp_list; tbp; tbp = tbq)
3039 tbp->proc->error = 0;
3042 tentative_tbp_list = NULL;
3046 /* Makes the changes made in one symbol permanent -- gets rid of undo
3050 gfc_commit_symbol (gfc_symbol *sym)
3054 if (changed_syms == sym)
3055 changed_syms = sym->tlink;
3058 for (p = changed_syms; p; p = p->tlink)
3059 if (p->tlink == sym)
3061 p->tlink = sym->tlink;
3070 free_old_symbol (sym);
3074 /* Recursively free trees containing type-bound procedures. */
3077 free_tb_tree (gfc_symtree *t)
3082 free_tb_tree (t->left);
3083 free_tb_tree (t->right);
3085 /* TODO: Free type-bound procedure structs themselves; probably needs some
3086 sort of ref-counting mechanism. */
3092 /* Recursive function that deletes an entire tree and all the common
3093 head structures it points to. */
3096 free_common_tree (gfc_symtree * common_tree)
3098 if (common_tree == NULL)
3101 free_common_tree (common_tree->left);
3102 free_common_tree (common_tree->right);
3104 gfc_free (common_tree);
3108 /* Recursive function that deletes an entire tree and all the user
3109 operator nodes that it contains. */
3112 free_uop_tree (gfc_symtree *uop_tree)
3114 if (uop_tree == NULL)
3117 free_uop_tree (uop_tree->left);
3118 free_uop_tree (uop_tree->right);
3120 gfc_free_interface (uop_tree->n.uop->op);
3121 gfc_free (uop_tree->n.uop);
3122 gfc_free (uop_tree);
3126 /* Recursive function that deletes an entire tree and all the symbols
3127 that it contains. */
3130 free_sym_tree (gfc_symtree *sym_tree)
3132 if (sym_tree == NULL)
3135 free_sym_tree (sym_tree->left);
3136 free_sym_tree (sym_tree->right);
3138 gfc_release_symbol (sym_tree->n.sym);
3139 gfc_free (sym_tree);
3143 /* Free the derived type list. */
3146 gfc_free_dt_list (void)
3148 gfc_dt_list *dt, *n;
3150 for (dt = gfc_derived_types; dt; dt = n)
3156 gfc_derived_types = NULL;
3160 /* Free the gfc_equiv_info's. */
3163 gfc_free_equiv_infos (gfc_equiv_info *s)
3167 gfc_free_equiv_infos (s->next);
3172 /* Free the gfc_equiv_lists. */
3175 gfc_free_equiv_lists (gfc_equiv_list *l)
3179 gfc_free_equiv_lists (l->next);
3180 gfc_free_equiv_infos (l->equiv);
3185 /* Free a finalizer procedure list. */
3188 gfc_free_finalizer (gfc_finalizer* el)
3192 gfc_release_symbol (el->proc_sym);
3198 gfc_free_finalizer_list (gfc_finalizer* list)
3202 gfc_finalizer* current = list;
3204 gfc_free_finalizer (current);
3209 /* Create a new gfc_charlen structure and add it to a namespace.
3210 If 'old_cl' is given, the newly created charlen will be a copy of it. */
3213 gfc_new_charlen (gfc_namespace *ns, gfc_charlen *old_cl)
3216 cl = gfc_get_charlen ();
3218 /* Put into namespace. */
3219 cl->next = ns->cl_list;
3225 cl->length = gfc_copy_expr (old_cl->length);
3226 cl->length_from_typespec = old_cl->length_from_typespec;
3227 cl->backend_decl = old_cl->backend_decl;
3228 cl->passed_length = old_cl->passed_length;
3229 cl->resolved = old_cl->resolved;
3236 /* Free the charlen list from cl to end (end is not freed).
3237 Free the whole list if end is NULL. */
3239 void gfc_free_charlen (gfc_charlen *cl, gfc_charlen *end)
3243 for (; cl != end; cl = cl2)
3248 gfc_free_expr (cl->length);
3254 /* Free a namespace structure and everything below it. Interface
3255 lists associated with intrinsic operators are not freed. These are
3256 taken care of when a specific name is freed. */
3259 gfc_free_namespace (gfc_namespace *ns)
3261 gfc_namespace *p, *q;
3270 gcc_assert (ns->refs == 0);
3272 gfc_free_statements (ns->code);
3274 free_sym_tree (ns->sym_root);
3275 free_uop_tree (ns->uop_root);
3276 free_common_tree (ns->common_root);
3277 free_tb_tree (ns->tb_sym_root);
3278 free_tb_tree (ns->tb_uop_root);
3279 gfc_free_finalizer_list (ns->finalizers);
3280 gfc_free_charlen (ns->cl_list, NULL);
3281 free_st_labels (ns->st_labels);
3283 gfc_free_equiv (ns->equiv);
3284 gfc_free_equiv_lists (ns->equiv_lists);
3285 gfc_free_use_stmts (ns->use_stmts);
3287 for (i = GFC_INTRINSIC_BEGIN; i != GFC_INTRINSIC_END; i++)
3288 gfc_free_interface (ns->op[i]);
3290 gfc_free_data (ns->data);
3294 /* Recursively free any contained namespaces. */
3299 gfc_free_namespace (q);
3305 gfc_symbol_init_2 (void)
3308 gfc_current_ns = gfc_get_namespace (NULL, 0);
3313 gfc_symbol_done_2 (void)
3316 gfc_free_namespace (gfc_current_ns);
3317 gfc_current_ns = NULL;
3318 gfc_free_dt_list ();
3322 /* Clear mark bits from symbol nodes associated with a symtree node. */
3325 clear_sym_mark (gfc_symtree *st)
3328 st->n.sym->mark = 0;
3332 /* Recursively traverse the symtree nodes. */
3335 gfc_traverse_symtree (gfc_symtree *st, void (*func) (gfc_symtree *))
3340 gfc_traverse_symtree (st->left, func);
3342 gfc_traverse_symtree (st->right, func);
3346 /* Recursive namespace traversal function. */
3349 traverse_ns (gfc_symtree *st, void (*func) (gfc_symbol *))
3355 traverse_ns (st->left, func);
3357 if (st->n.sym->mark == 0)
3358 (*func) (st->n.sym);
3359 st->n.sym->mark = 1;
3361 traverse_ns (st->right, func);
3365 /* Call a given function for all symbols in the namespace. We take
3366 care that each gfc_symbol node is called exactly once. */
3369 gfc_traverse_ns (gfc_namespace *ns, void (*func) (gfc_symbol *))
3372 gfc_traverse_symtree (ns->sym_root, clear_sym_mark);
3374 traverse_ns (ns->sym_root, func);
3378 /* Return TRUE when name is the name of an intrinsic type. */
3381 gfc_is_intrinsic_typename (const char *name)
3383 if (strcmp (name, "integer") == 0
3384 || strcmp (name, "real") == 0
3385 || strcmp (name, "character") == 0
3386 || strcmp (name, "logical") == 0
3387 || strcmp (name, "complex") == 0
3388 || strcmp (name, "doubleprecision") == 0
3389 || strcmp (name, "doublecomplex") == 0)
3396 /* Return TRUE if the symbol is an automatic variable. */
3399 gfc_is_var_automatic (gfc_symbol *sym)
3401 /* Pointer and allocatable variables are never automatic. */
3402 if (sym->attr.pointer || sym->attr.allocatable)
3404 /* Check for arrays with non-constant size. */
3405 if (sym->attr.dimension && sym->as
3406 && !gfc_is_compile_time_shape (sym->as))
3408 /* Check for non-constant length character variables. */
3409 if (sym->ts.type == BT_CHARACTER
3411 && !gfc_is_constant_expr (sym->ts.u.cl->length))
3416 /* Given a symbol, mark it as SAVEd if it is allowed. */
3419 save_symbol (gfc_symbol *sym)
3422 if (sym->attr.use_assoc)
3425 if (sym->attr.in_common
3428 || sym->attr.flavor != FL_VARIABLE)
3430 /* Automatic objects are not saved. */
3431 if (gfc_is_var_automatic (sym))
3433 gfc_add_save (&sym->attr, sym->name, &sym->declared_at);
3437 /* Mark those symbols which can be SAVEd as such. */
3440 gfc_save_all (gfc_namespace *ns)
3442 gfc_traverse_ns (ns, save_symbol);
3446 /* Make sure that no changes to symbols are pending. */
3449 gfc_enforce_clean_symbol_state(void)
3451 gcc_assert (changed_syms == NULL);
3455 /************** Global symbol handling ************/
3458 /* Search a tree for the global symbol. */
3461 gfc_find_gsymbol (gfc_gsymbol *symbol, const char *name)
3470 c = strcmp (name, symbol->name);
3474 symbol = (c < 0) ? symbol->left : symbol->right;
3481 /* Compare two global symbols. Used for managing the BB tree. */
3484 gsym_compare (void *_s1, void *_s2)
3486 gfc_gsymbol *s1, *s2;
3488 s1 = (gfc_gsymbol *) _s1;
3489 s2 = (gfc_gsymbol *) _s2;
3490 return strcmp (s1->name, s2->name);
3494 /* Get a global symbol, creating it if it doesn't exist. */
3497 gfc_get_gsymbol (const char *name)
3501 s = gfc_find_gsymbol (gfc_gsym_root, name);
3505 s = XCNEW (gfc_gsymbol);
3506 s->type = GSYM_UNKNOWN;
3507 s->name = gfc_get_string (name);
3509 gfc_insert_bbt (&gfc_gsym_root, s, gsym_compare);
3516 get_iso_c_binding_dt (int sym_id)
3518 gfc_dt_list *dt_list;
3520 dt_list = gfc_derived_types;
3522 /* Loop through the derived types in the name list, searching for
3523 the desired symbol from iso_c_binding. Search the parent namespaces
3524 if necessary and requested to (parent_flag). */
3525 while (dt_list != NULL)
3527 if (dt_list->derived->from_intmod != INTMOD_NONE
3528 && dt_list->derived->intmod_sym_id == sym_id)
3529 return dt_list->derived;
3531 dt_list = dt_list->next;
3538 /* Verifies that the given derived type symbol, derived_sym, is interoperable
3539 with C. This is necessary for any derived type that is BIND(C) and for
3540 derived types that are parameters to functions that are BIND(C). All
3541 fields of the derived type are required to be interoperable, and are tested
3542 for such. If an error occurs, the errors are reported here, allowing for
3543 multiple errors to be handled for a single derived type. */
3546 verify_bind_c_derived_type (gfc_symbol *derived_sym)
3548 gfc_component *curr_comp = NULL;
3549 gfc_try is_c_interop = FAILURE;
3550 gfc_try retval = SUCCESS;
3552 if (derived_sym == NULL)
3553 gfc_internal_error ("verify_bind_c_derived_type(): Given symbol is "
3554 "unexpectedly NULL");
3556 /* If we've already looked at this derived symbol, do not look at it again
3557 so we don't repeat warnings/errors. */
3558 if (derived_sym->ts.is_c_interop)
3561 /* The derived type must have the BIND attribute to be interoperable
3562 J3/04-007, Section 15.2.3. */
3563 if (derived_sym->attr.is_bind_c != 1)
3565 derived_sym->ts.is_c_interop = 0;
3566 gfc_error_now ("Derived type '%s' declared at %L must have the BIND "
3567 "attribute to be C interoperable", derived_sym->name,
3568 &(derived_sym->declared_at));
3572 curr_comp = derived_sym->components;
3574 /* TODO: is this really an error? */
3575 if (curr_comp == NULL)
3577 gfc_error ("Derived type '%s' at %L is empty",
3578 derived_sym->name, &(derived_sym->declared_at));
3582 /* Initialize the derived type as being C interoperable.
3583 If we find an error in the components, this will be set false. */
3584 derived_sym->ts.is_c_interop = 1;
3586 /* Loop through the list of components to verify that the kind of
3587 each is a C interoperable type. */
3590 /* The components cannot be pointers (fortran sense).
3591 J3/04-007, Section 15.2.3, C1505. */
3592 if (curr_comp->attr.pointer != 0)
3594 gfc_error ("Component '%s' at %L cannot have the "
3595 "POINTER attribute because it is a member "
3596 "of the BIND(C) derived type '%s' at %L",
3597 curr_comp->name, &(curr_comp->loc),
3598 derived_sym->name, &(derived_sym->declared_at));
3602 if (curr_comp->attr.proc_pointer != 0)
3604 gfc_error ("Procedure pointer component '%s' at %L cannot be a member"
3605 " of the BIND(C) derived type '%s' at %L", curr_comp->name,
3606 &curr_comp->loc, derived_sym->name,
3607 &derived_sym->declared_at);
3611 /* The components cannot be allocatable.
3612 J3/04-007, Section 15.2.3, C1505. */
3613 if (curr_comp->attr.allocatable != 0)
3615 gfc_error ("Component '%s' at %L cannot have the "
3616 "ALLOCATABLE attribute because it is a member "
3617 "of the BIND(C) derived type '%s' at %L",
3618 curr_comp->name, &(curr_comp->loc),
3619 derived_sym->name, &(derived_sym->declared_at));
3623 /* BIND(C) derived types must have interoperable components. */
3624 if (curr_comp->ts.type == BT_DERIVED
3625 && curr_comp->ts.u.derived->ts.is_iso_c != 1
3626 && curr_comp->ts.u.derived != derived_sym)
3628 /* This should be allowed; the draft says a derived-type can not
3629 have type parameters if it is has the BIND attribute. Type
3630 parameters seem to be for making parameterized derived types.
3631 There's no need to verify the type if it is c_ptr/c_funptr. */
3632 retval = verify_bind_c_derived_type (curr_comp->ts.u.derived);
3636 /* Grab the typespec for the given component and test the kind. */
3637 is_c_interop = verify_c_interop (&(curr_comp->ts));
3639 if (is_c_interop != SUCCESS)
3641 /* Report warning and continue since not fatal. The
3642 draft does specify a constraint that requires all fields
3643 to interoperate, but if the user says real(4), etc., it
3644 may interoperate with *something* in C, but the compiler
3645 most likely won't know exactly what. Further, it may not
3646 interoperate with the same data type(s) in C if the user
3647 recompiles with different flags (e.g., -m32 and -m64 on
3648 x86_64 and using integer(4) to claim interop with a
3650 if (derived_sym->attr.is_bind_c == 1)
3651 /* If the derived type is bind(c), all fields must be
3653 gfc_warning ("Component '%s' in derived type '%s' at %L "
3654 "may not be C interoperable, even though "
3655 "derived type '%s' is BIND(C)",
3656 curr_comp->name, derived_sym->name,
3657 &(curr_comp->loc), derived_sym->name);
3659 /* If derived type is param to bind(c) routine, or to one
3660 of the iso_c_binding procs, it must be interoperable, so
3661 all fields must interop too. */
3662 gfc_warning ("Component '%s' in derived type '%s' at %L "
3663 "may not be C interoperable",
3664 curr_comp->name, derived_sym->name,
3669 curr_comp = curr_comp->next;
3670 } while (curr_comp != NULL);
3673 /* Make sure we don't have conflicts with the attributes. */
3674 if (derived_sym->attr.access == ACCESS_PRIVATE)
3676 gfc_error ("Derived type '%s' at %L cannot be declared with both "
3677 "PRIVATE and BIND(C) attributes", derived_sym->name,
3678 &(derived_sym->declared_at));
3682 if (derived_sym->attr.sequence != 0)
3684 gfc_error ("Derived type '%s' at %L cannot have the SEQUENCE "
3685 "attribute because it is BIND(C)", derived_sym->name,
3686 &(derived_sym->declared_at));
3690 /* Mark the derived type as not being C interoperable if we found an
3691 error. If there were only warnings, proceed with the assumption
3692 it's interoperable. */
3693 if (retval == FAILURE)
3694 derived_sym->ts.is_c_interop = 0;
3700 /* Generate symbols for the named constants c_null_ptr and c_null_funptr. */
3703 gen_special_c_interop_ptr (int ptr_id, const char *ptr_name,
3704 const char *module_name)
3706 gfc_symtree *tmp_symtree;
3707 gfc_symbol *tmp_sym;
3710 tmp_symtree = gfc_find_symtree (gfc_current_ns->sym_root, ptr_name);
3712 if (tmp_symtree != NULL)
3713 tmp_sym = tmp_symtree->n.sym;
3717 gfc_internal_error ("gen_special_c_interop_ptr(): Unable to "
3718 "create symbol for %s", ptr_name);
3721 /* Set up the symbol's important fields. Save attr required so we can
3722 initialize the ptr to NULL. */
3723 tmp_sym->attr.save = SAVE_EXPLICIT;
3724 tmp_sym->ts.is_c_interop = 1;
3725 tmp_sym->attr.is_c_interop = 1;
3726 tmp_sym->ts.is_iso_c = 1;
3727 tmp_sym->ts.type = BT_DERIVED;
3729 /* The c_ptr and c_funptr derived types will provide the
3730 definition for c_null_ptr and c_null_funptr, respectively. */
3731 if (ptr_id == ISOCBINDING_NULL_PTR)
3732 tmp_sym->ts.u.derived = get_iso_c_binding_dt (ISOCBINDING_PTR);
3734 tmp_sym->ts.u.derived = get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
3735 if (tmp_sym->ts.u.derived == NULL)
3737 /* This can occur if the user forgot to declare c_ptr or
3738 c_funptr and they're trying to use one of the procedures
3739 that has arg(s) of the missing type. In this case, a
3740 regular version of the thing should have been put in the
3742 generate_isocbinding_symbol (module_name, ptr_id == ISOCBINDING_NULL_PTR
3743 ? ISOCBINDING_PTR : ISOCBINDING_FUNPTR,
3744 (const char *) (ptr_id == ISOCBINDING_NULL_PTR
3745 ? "_gfortran_iso_c_binding_c_ptr"
3746 : "_gfortran_iso_c_binding_c_funptr"));
3748 tmp_sym->ts.u.derived =
3749 get_iso_c_binding_dt (ptr_id == ISOCBINDING_NULL_PTR
3750 ? ISOCBINDING_PTR : ISOCBINDING_FUNPTR);
3753 /* Module name is some mangled version of iso_c_binding. */
3754 tmp_sym->module = gfc_get_string (module_name);
3756 /* Say it's from the iso_c_binding module. */
3757 tmp_sym->attr.is_iso_c = 1;
3759 tmp_sym->attr.use_assoc = 1;
3760 tmp_sym->attr.is_bind_c = 1;
3761 /* Set the binding_label. */
3762 sprintf (tmp_sym->binding_label, "%s_%s", module_name, tmp_sym->name);
3764 /* Set the c_address field of c_null_ptr and c_null_funptr to
3765 the value of NULL. */
3766 tmp_sym->value = gfc_get_expr ();
3767 tmp_sym->value->expr_type = EXPR_STRUCTURE;
3768 tmp_sym->value->ts.type = BT_DERIVED;
3769 tmp_sym->value->ts.u.derived = tmp_sym->ts.u.derived;
3770 gfc_constructor_append_expr (&tmp_sym->value->value.constructor, NULL, NULL);
3771 c = gfc_constructor_first (tmp_sym->value->value.constructor);
3772 c->expr = gfc_get_expr ();
3773 c->expr->expr_type = EXPR_NULL;
3774 c->expr->ts.is_iso_c = 1;
3775 /* Must declare c_null_ptr and c_null_funptr as having the
3776 PARAMETER attribute so they can be used in init expressions. */
3777 tmp_sym->attr.flavor = FL_PARAMETER;
3783 /* Add a formal argument, gfc_formal_arglist, to the
3784 end of the given list of arguments. Set the reference to the
3785 provided symbol, param_sym, in the argument. */
3788 add_formal_arg (gfc_formal_arglist **head,
3789 gfc_formal_arglist **tail,
3790 gfc_formal_arglist *formal_arg,
3791 gfc_symbol *param_sym)
3793 /* Put in list, either as first arg or at the tail (curr arg). */
3795 *head = *tail = formal_arg;
3798 (*tail)->next = formal_arg;
3799 (*tail) = formal_arg;
3802 (*tail)->sym = param_sym;
3803 (*tail)->next = NULL;
3809 /* Generates a symbol representing the CPTR argument to an
3810 iso_c_binding procedure. Also, create a gfc_formal_arglist for the
3811 CPTR and add it to the provided argument list. */
3814 gen_cptr_param (gfc_formal_arglist **head,
3815 gfc_formal_arglist **tail,
3816 const char *module_name,
3817 gfc_namespace *ns, const char *c_ptr_name,
3820 gfc_symbol *param_sym = NULL;
3821 gfc_symbol *c_ptr_sym = NULL;
3822 gfc_symtree *param_symtree = NULL;
3823 gfc_formal_arglist *formal_arg = NULL;
3824 const char *c_ptr_in;
3825 const char *c_ptr_type = NULL;
3827 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3828 c_ptr_type = "_gfortran_iso_c_binding_c_funptr";
3830 c_ptr_type = "_gfortran_iso_c_binding_c_ptr";
3832 if(c_ptr_name == NULL)
3833 c_ptr_in = "gfc_cptr__";
3835 c_ptr_in = c_ptr_name;
3836 gfc_get_sym_tree (c_ptr_in, ns, ¶m_symtree, false);
3837 if (param_symtree != NULL)
3838 param_sym = param_symtree->n.sym;
3840 gfc_internal_error ("gen_cptr_param(): Unable to "
3841 "create symbol for %s", c_ptr_in);
3843 /* Set up the appropriate fields for the new c_ptr param sym. */
3845 param_sym->attr.flavor = FL_DERIVED;
3846 param_sym->ts.type = BT_DERIVED;
3847 param_sym->attr.intent = INTENT_IN;
3848 param_sym->attr.dummy = 1;
3850 /* This will pass the ptr to the iso_c routines as a (void *). */
3851 param_sym->attr.value = 1;
3852 param_sym->attr.use_assoc = 1;
3854 /* Get the symbol for c_ptr or c_funptr, no matter what it's name is
3856 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3857 c_ptr_sym = get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
3859 c_ptr_sym = get_iso_c_binding_dt (ISOCBINDING_PTR);
3860 if (c_ptr_sym == NULL)
3862 /* This can happen if the user did not define c_ptr but they are
3863 trying to use one of the iso_c_binding functions that need it. */
3864 if (iso_c_sym_id == ISOCBINDING_F_PROCPOINTER)
3865 generate_isocbinding_symbol (module_name, ISOCBINDING_FUNPTR,
3866 (const char *)c_ptr_type);
3868 generate_isocbinding_symbol (module_name, ISOCBINDING_PTR,
3869 (const char *)c_ptr_type);
3871 gfc_get_ha_symbol (c_ptr_type, &(c_ptr_sym));
3874 param_sym->ts.u.derived = c_ptr_sym;
3875 param_sym->module = gfc_get_string (module_name);
3877 /* Make new formal arg. */
3878 formal_arg = gfc_get_formal_arglist ();
3879 /* Add arg to list of formal args (the CPTR arg). */
3880 add_formal_arg (head, tail, formal_arg, param_sym);
3882 /* Validate changes. */
3883 gfc_commit_symbol (param_sym);
3887 /* Generates a symbol representing the FPTR argument to an
3888 iso_c_binding procedure. Also, create a gfc_formal_arglist for the
3889 FPTR and add it to the provided argument list. */
3892 gen_fptr_param (gfc_formal_arglist **head,
3893 gfc_formal_arglist **tail,
3894 const char *module_name,
3895 gfc_namespace *ns, const char *f_ptr_name, int proc)
3897 gfc_symbol *param_sym = NULL;
3898 gfc_symtree *param_symtree = NULL;
3899 gfc_formal_arglist *formal_arg = NULL;
3900 const char *f_ptr_out = "gfc_fptr__";
3902 if (f_ptr_name != NULL)
3903 f_ptr_out = f_ptr_name;
3905 gfc_get_sym_tree (f_ptr_out, ns, ¶m_symtree, false);
3906 if (param_symtree != NULL)
3907 param_sym = param_symtree->n.sym;
3909 gfc_internal_error ("generateFPtrParam(): Unable to "
3910 "create symbol for %s", f_ptr_out);
3912 /* Set up the necessary fields for the fptr output param sym. */
3915 param_sym->attr.proc_pointer = 1;
3917 param_sym->attr.pointer = 1;
3918 param_sym->attr.dummy = 1;
3919 param_sym->attr.use_assoc = 1;
3921 /* ISO C Binding type to allow any pointer type as actual param. */
3922 param_sym->ts.type = BT_VOID;
3923 param_sym->module = gfc_get_string (module_name);
3926 formal_arg = gfc_get_formal_arglist ();
3927 /* Add arg to list of formal args. */
3928 add_formal_arg (head, tail, formal_arg, param_sym);
3930 /* Validate changes. */
3931 gfc_commit_symbol (param_sym);
3935 /* Generates a symbol representing the optional SHAPE argument for the
3936 iso_c_binding c_f_pointer() procedure. Also, create a
3937 gfc_formal_arglist for the SHAPE and add it to the provided
3941 gen_shape_param (gfc_formal_arglist **head,
3942 gfc_formal_arglist **tail,
3943 const char *module_name,
3944 gfc_namespace *ns, const char *shape_param_name)
3946 gfc_symbol *param_sym = NULL;
3947 gfc_symtree *param_symtree = NULL;
3948 gfc_formal_arglist *formal_arg = NULL;
3949 const char *shape_param = "gfc_shape_array__";
3952 if (shape_param_name != NULL)
3953 shape_param = shape_param_name;
3955 gfc_get_sym_tree (shape_param, ns, ¶m_symtree, false);
3956 if (param_symtree != NULL)
3957 param_sym = param_symtree->n.sym;
3959 gfc_internal_error ("generateShapeParam(): Unable to "
3960 "create symbol for %s", shape_param);
3962 /* Set up the necessary fields for the shape input param sym. */
3964 param_sym->attr.dummy = 1;
3965 param_sym->attr.use_assoc = 1;
3967 /* Integer array, rank 1, describing the shape of the object. Make it's
3968 type BT_VOID initially so we can accept any type/kind combination of
3969 integer. During gfc_iso_c_sub_interface (resolve.c), we'll make it
3970 of BT_INTEGER type. */
3971 param_sym->ts.type = BT_VOID;
3973 /* Initialize the kind to default integer. However, it will be overridden
3974 during resolution to match the kind of the SHAPE parameter given as
3975 the actual argument (to allow for any valid integer kind). */
3976 param_sym->ts.kind = gfc_default_integer_kind;
3977 param_sym->as = gfc_get_array_spec ();
3979 /* Clear out the dimension info for the array. */
3980 for (i = 0; i < GFC_MAX_DIMENSIONS; i++)
3982 param_sym->as->lower[i] = NULL;
3983 param_sym->as->upper[i] = NULL;
3985 param_sym->as->rank = 1;
3986 param_sym->as->lower[0] = gfc_get_int_expr (gfc_default_integer_kind,
3989 /* The extent is unknown until we get it. The length give us
3990 the rank the incoming pointer. */
3991 param_sym->as->type = AS_ASSUMED_SHAPE;
3993 /* The arg is also optional; it is required iff the second arg
3994 (fptr) is to an array, otherwise, it's ignored. */
3995 param_sym->attr.optional = 1;
3996 param_sym->attr.intent = INTENT_IN;
3997 param_sym->attr.dimension = 1;
3998 param_sym->module = gfc_get_string (module_name);
4001 formal_arg = gfc_get_formal_arglist ();
4002 /* Add arg to list of formal args. */
4003 add_formal_arg (head, tail, formal_arg, param_sym);
4005 /* Validate changes. */
4006 gfc_commit_symbol (param_sym);
4010 /* Add a procedure interface to the given symbol (i.e., store a
4011 reference to the list of formal arguments). */
4014 add_proc_interface (gfc_symbol *sym, ifsrc source,
4015 gfc_formal_arglist *formal)
4018 sym->formal = formal;
4019 sym->attr.if_source = source;
4023 /* Copy the formal args from an existing symbol, src, into a new
4024 symbol, dest. New formal args are created, and the description of
4025 each arg is set according to the existing ones. This function is
4026 used when creating procedure declaration variables from a procedure
4027 declaration statement (see match_proc_decl()) to create the formal
4028 args based on the args of a given named interface. */
4031 gfc_copy_formal_args (gfc_symbol *dest, gfc_symbol *src)
4033 gfc_formal_arglist *head = NULL;
4034 gfc_formal_arglist *tail = NULL;
4035 gfc_formal_arglist *formal_arg = NULL;
4036 gfc_formal_arglist *curr_arg = NULL;
4037 gfc_formal_arglist *formal_prev = NULL;
4038 /* Save current namespace so we can change it for formal args. */
4039 gfc_namespace *parent_ns = gfc_current_ns;
4041 /* Create a new namespace, which will be the formal ns (namespace
4042 of the formal args). */
4043 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4044 gfc_current_ns->proc_name = dest;
4046 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4048 formal_arg = gfc_get_formal_arglist ();
4049 gfc_get_symbol (curr_arg->sym->name, gfc_current_ns, &(formal_arg->sym));
4051 /* May need to copy more info for the symbol. */
4052 formal_arg->sym->attr = curr_arg->sym->attr;
4053 formal_arg->sym->ts = curr_arg->sym->ts;
4054 formal_arg->sym->as = gfc_copy_array_spec (curr_arg->sym->as);
4055 gfc_copy_formal_args (formal_arg->sym, curr_arg->sym);
4057 /* If this isn't the first arg, set up the next ptr. For the
4058 last arg built, the formal_arg->next will never get set to
4059 anything other than NULL. */
4060 if (formal_prev != NULL)
4061 formal_prev->next = formal_arg;
4063 formal_arg->next = NULL;
4065 formal_prev = formal_arg;
4067 /* Add arg to list of formal args. */
4068 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4070 /* Validate changes. */
4071 gfc_commit_symbol (formal_arg->sym);
4074 /* Add the interface to the symbol. */
4075 add_proc_interface (dest, IFSRC_DECL, head);
4077 /* Store the formal namespace information. */
4078 if (dest->formal != NULL)
4079 /* The current ns should be that for the dest proc. */
4080 dest->formal_ns = gfc_current_ns;
4081 /* Restore the current namespace to what it was on entry. */
4082 gfc_current_ns = parent_ns;
4087 gfc_copy_formal_args_intr (gfc_symbol *dest, gfc_intrinsic_sym *src)
4089 gfc_formal_arglist *head = NULL;
4090 gfc_formal_arglist *tail = NULL;
4091 gfc_formal_arglist *formal_arg = NULL;
4092 gfc_intrinsic_arg *curr_arg = NULL;
4093 gfc_formal_arglist *formal_prev = NULL;
4094 /* Save current namespace so we can change it for formal args. */
4095 gfc_namespace *parent_ns = gfc_current_ns;
4097 /* Create a new namespace, which will be the formal ns (namespace
4098 of the formal args). */
4099 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4100 gfc_current_ns->proc_name = dest;
4102 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4104 formal_arg = gfc_get_formal_arglist ();
4105 gfc_get_symbol (curr_arg->name, gfc_current_ns, &(formal_arg->sym));
4107 /* May need to copy more info for the symbol. */
4108 formal_arg->sym->ts = curr_arg->ts;
4109 formal_arg->sym->attr.optional = curr_arg->optional;
4110 formal_arg->sym->attr.intent = curr_arg->intent;
4111 formal_arg->sym->attr.flavor = FL_VARIABLE;
4112 formal_arg->sym->attr.dummy = 1;
4114 if (formal_arg->sym->ts.type == BT_CHARACTER)
4115 formal_arg->sym->ts.u.cl = gfc_new_charlen (gfc_current_ns, NULL);
4117 /* If this isn't the first arg, set up the next ptr. For the
4118 last arg built, the formal_arg->next will never get set to
4119 anything other than NULL. */
4120 if (formal_prev != NULL)
4121 formal_prev->next = formal_arg;
4123 formal_arg->next = NULL;
4125 formal_prev = formal_arg;
4127 /* Add arg to list of formal args. */
4128 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4130 /* Validate changes. */
4131 gfc_commit_symbol (formal_arg->sym);
4134 /* Add the interface to the symbol. */
4135 add_proc_interface (dest, IFSRC_DECL, head);
4137 /* Store the formal namespace information. */
4138 if (dest->formal != NULL)
4139 /* The current ns should be that for the dest proc. */
4140 dest->formal_ns = gfc_current_ns;
4141 /* Restore the current namespace to what it was on entry. */
4142 gfc_current_ns = parent_ns;
4147 gfc_copy_formal_args_ppc (gfc_component *dest, gfc_symbol *src)
4149 gfc_formal_arglist *head = NULL;
4150 gfc_formal_arglist *tail = NULL;
4151 gfc_formal_arglist *formal_arg = NULL;
4152 gfc_formal_arglist *curr_arg = NULL;
4153 gfc_formal_arglist *formal_prev = NULL;
4154 /* Save current namespace so we can change it for formal args. */
4155 gfc_namespace *parent_ns = gfc_current_ns;
4157 /* Create a new namespace, which will be the formal ns (namespace
4158 of the formal args). */
4159 gfc_current_ns = gfc_get_namespace (parent_ns, 0);
4160 /* TODO: gfc_current_ns->proc_name = dest;*/
4162 for (curr_arg = src->formal; curr_arg; curr_arg = curr_arg->next)
4164 formal_arg = gfc_get_formal_arglist ();
4165 gfc_get_symbol (curr_arg->sym->name, gfc_current_ns, &(formal_arg->sym));
4167 /* May need to copy more info for the symbol. */
4168 formal_arg->sym->attr = curr_arg->sym->attr;
4169 formal_arg->sym->ts = curr_arg->sym->ts;
4170 formal_arg->sym->as = gfc_copy_array_spec (curr_arg->sym->as);
4171 gfc_copy_formal_args (formal_arg->sym, curr_arg->sym);
4173 /* If this isn't the first arg, set up the next ptr. For the
4174 last arg built, the formal_arg->next will never get set to
4175 anything other than NULL. */
4176 if (formal_prev != NULL)
4177 formal_prev->next = formal_arg;
4179 formal_arg->next = NULL;
4181 formal_prev = formal_arg;
4183 /* Add arg to list of formal args. */
4184 add_formal_arg (&head, &tail, formal_arg, formal_arg->sym);
4186 /* Validate changes. */
4187 gfc_commit_symbol (formal_arg->sym);
4190 /* Add the interface to the symbol. */
4191 dest->formal = head;
4192 dest->attr.if_source = IFSRC_DECL;
4194 /* Store the formal namespace information. */
4195 if (dest->formal != NULL)
4196 /* The current ns should be that for the dest proc. */
4197 dest->formal_ns = gfc_current_ns;
4198 /* Restore the current namespace to what it was on entry. */
4199 gfc_current_ns = parent_ns;
4203 /* Builds the parameter list for the iso_c_binding procedure
4204 c_f_pointer or c_f_procpointer. The old_sym typically refers to a
4205 generic version of either the c_f_pointer or c_f_procpointer
4206 functions. The new_proc_sym represents a "resolved" version of the
4207 symbol. The functions are resolved to match the types of their
4208 parameters; for example, c_f_pointer(cptr, fptr) would resolve to
4209 something similar to c_f_pointer_i4 if the type of data object fptr
4210 pointed to was a default integer. The actual name of the resolved
4211 procedure symbol is further mangled with the module name, etc., but
4212 the idea holds true. */
4215 build_formal_args (gfc_symbol *new_proc_sym,
4216 gfc_symbol *old_sym, int add_optional_arg)
4218 gfc_formal_arglist *head = NULL, *tail = NULL;
4219 gfc_namespace *parent_ns = NULL;
4221 parent_ns = gfc_current_ns;
4222 /* Create a new namespace, which will be the formal ns (namespace
4223 of the formal args). */
4224 gfc_current_ns = gfc_get_namespace(parent_ns, 0);
4225 gfc_current_ns->proc_name = new_proc_sym;
4227 /* Generate the params. */
4228 if (old_sym->intmod_sym_id == ISOCBINDING_F_PROCPOINTER)
4230 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4231 gfc_current_ns, "cptr", old_sym->intmod_sym_id);
4232 gen_fptr_param (&head, &tail, (const char *) new_proc_sym->module,
4233 gfc_current_ns, "fptr", 1);
4235 else if (old_sym->intmod_sym_id == ISOCBINDING_F_POINTER)
4237 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4238 gfc_current_ns, "cptr", old_sym->intmod_sym_id);
4239 gen_fptr_param (&head, &tail, (const char *) new_proc_sym->module,
4240 gfc_current_ns, "fptr", 0);
4241 /* If we're dealing with c_f_pointer, it has an optional third arg. */
4242 gen_shape_param (&head, &tail,(const char *) new_proc_sym->module,
4243 gfc_current_ns, "shape");
4246 else if (old_sym->intmod_sym_id == ISOCBINDING_ASSOCIATED)
4248 /* c_associated has one required arg and one optional; both
4250 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4251 gfc_current_ns, "c_ptr_1", ISOCBINDING_ASSOCIATED);
4252 if (add_optional_arg)
4254 gen_cptr_param (&head, &tail, (const char *) new_proc_sym->module,
4255 gfc_current_ns, "c_ptr_2", ISOCBINDING_ASSOCIATED);
4256 /* The last param is optional so mark it as such. */
4257 tail->sym->attr.optional = 1;
4261 /* Add the interface (store formal args to new_proc_sym). */
4262 add_proc_interface (new_proc_sym, IFSRC_DECL, head);
4264 /* Set up the formal_ns pointer to the one created for the
4265 new procedure so it'll get cleaned up during gfc_free_symbol(). */
4266 new_proc_sym->formal_ns = gfc_current_ns;
4268 gfc_current_ns = parent_ns;
4272 std_for_isocbinding_symbol (int id)
4276 #define NAMED_INTCST(a,b,c,d) \
4279 #include "iso-c-binding.def"
4282 return GFC_STD_F2003;
4286 /* Generate the given set of C interoperable kind objects, or all
4287 interoperable kinds. This function will only be given kind objects
4288 for valid iso_c_binding defined types because this is verified when
4289 the 'use' statement is parsed. If the user gives an 'only' clause,
4290 the specific kinds are looked up; if they don't exist, an error is
4291 reported. If the user does not give an 'only' clause, all
4292 iso_c_binding symbols are generated. If a list of specific kinds
4293 is given, it must have a NULL in the first empty spot to mark the
4298 generate_isocbinding_symbol (const char *mod_name, iso_c_binding_symbol s,
4299 const char *local_name)
4301 const char *const name = (local_name && local_name[0]) ? local_name
4302 : c_interop_kinds_table[s].name;
4303 gfc_symtree *tmp_symtree = NULL;
4304 gfc_symbol *tmp_sym = NULL;
4305 gfc_dt_list **dt_list_ptr = NULL;
4306 gfc_component *tmp_comp = NULL;
4307 char comp_name[(GFC_MAX_SYMBOL_LEN * 2) + 1];
4310 if (gfc_notification_std (std_for_isocbinding_symbol (s)) == ERROR)
4312 tmp_symtree = gfc_find_symtree (gfc_current_ns->sym_root, name);
4314 /* Already exists in this scope so don't re-add it.
4315 TODO: we should probably check that it's really the same symbol. */
4316 if (tmp_symtree != NULL)
4319 /* Create the sym tree in the current ns. */
4320 gfc_get_sym_tree (name, gfc_current_ns, &tmp_symtree, false);
4322 tmp_sym = tmp_symtree->n.sym;
4324 gfc_internal_error ("generate_isocbinding_symbol(): Unable to "
4327 /* Say what module this symbol belongs to. */
4328 tmp_sym->module = gfc_get_string (mod_name);
4329 tmp_sym->from_intmod = INTMOD_ISO_C_BINDING;
4330 tmp_sym->intmod_sym_id = s;
4335 #define NAMED_INTCST(a,b,c,d) case a :
4336 #define NAMED_REALCST(a,b,c) case a :
4337 #define NAMED_CMPXCST(a,b,c) case a :
4338 #define NAMED_LOGCST(a,b,c) case a :
4339 #define NAMED_CHARKNDCST(a,b,c) case a :
4340 #include "iso-c-binding.def"
4342 tmp_sym->value = gfc_get_int_expr (gfc_default_integer_kind, NULL,
4343 c_interop_kinds_table[s].value);
4345 /* Initialize an integer constant expression node. */
4346 tmp_sym->attr.flavor = FL_PARAMETER;
4347 tmp_sym->ts.type = BT_INTEGER;
4348 tmp_sym->ts.kind = gfc_default_integer_kind;
4350 /* Mark this type as a C interoperable one. */
4351 tmp_sym->ts.is_c_interop = 1;
4352 tmp_sym->ts.is_iso_c = 1;
4353 tmp_sym->value->ts.is_c_interop = 1;
4354 tmp_sym->value->ts.is_iso_c = 1;
4355 tmp_sym->attr.is_c_interop = 1;
4357 /* Tell what f90 type this c interop kind is valid. */
4358 tmp_sym->ts.f90_type = c_interop_kinds_table[s].f90_type;
4360 /* Say it's from the iso_c_binding module. */
4361 tmp_sym->attr.is_iso_c = 1;
4363 /* Make it use associated. */
4364 tmp_sym->attr.use_assoc = 1;
4368 #define NAMED_CHARCST(a,b,c) case a :
4369 #include "iso-c-binding.def"
4371 /* Initialize an integer constant expression node for the
4372 length of the character. */
4373 tmp_sym->value = gfc_get_character_expr (gfc_default_character_kind,
4374 &gfc_current_locus, NULL, 1);
4375 tmp_sym->value->ts.is_c_interop = 1;
4376 tmp_sym->value->ts.is_iso_c = 1;
4377 tmp_sym->value->value.character.length = 1;
4378 tmp_sym->value->value.character.string[0]
4379 = (gfc_char_t) c_interop_kinds_table[s].value;
4380 tmp_sym->ts.u.cl = gfc_new_charlen (gfc_current_ns, NULL);
4381 tmp_sym->ts.u.cl->length = gfc_get_int_expr (gfc_default_integer_kind,
4384 /* May not need this in both attr and ts, but do need in
4385 attr for writing module file. */
4386 tmp_sym->attr.is_c_interop = 1;
4388 tmp_sym->attr.flavor = FL_PARAMETER;
4389 tmp_sym->ts.type = BT_CHARACTER;
4391 /* Need to set it to the C_CHAR kind. */
4392 tmp_sym->ts.kind = gfc_default_character_kind;
4394 /* Mark this type as a C interoperable one. */
4395 tmp_sym->ts.is_c_interop = 1;
4396 tmp_sym->ts.is_iso_c = 1;
4398 /* Tell what f90 type this c interop kind is valid. */
4399 tmp_sym->ts.f90_type = BT_CHARACTER;
4401 /* Say it's from the iso_c_binding module. */
4402 tmp_sym->attr.is_iso_c = 1;
4404 /* Make it use associated. */
4405 tmp_sym->attr.use_assoc = 1;
4408 case ISOCBINDING_PTR:
4409 case ISOCBINDING_FUNPTR:
4411 /* Initialize an integer constant expression node. */
4412 tmp_sym->attr.flavor = FL_DERIVED;
4413 tmp_sym->ts.is_c_interop = 1;
4414 tmp_sym->attr.is_c_interop = 1;
4415 tmp_sym->attr.is_iso_c = 1;
4416 tmp_sym->ts.is_iso_c = 1;
4417 tmp_sym->ts.type = BT_DERIVED;
4419 /* A derived type must have the bind attribute to be
4420 interoperable (J3/04-007, Section 15.2.3), even though
4421 the binding label is not used. */
4422 tmp_sym->attr.is_bind_c = 1;
4424 tmp_sym->attr.referenced = 1;
4426 tmp_sym->ts.u.derived = tmp_sym;
4428 /* Add the symbol created for the derived type to the current ns. */
4429 dt_list_ptr = &(gfc_derived_types);
4430 while (*dt_list_ptr != NULL && (*dt_list_ptr)->next != NULL)
4431 dt_list_ptr = &((*dt_list_ptr)->next);
4433 /* There is already at least one derived type in the list, so append
4434 the one we're currently building for c_ptr or c_funptr. */
4435 if (*dt_list_ptr != NULL)
4436 dt_list_ptr = &((*dt_list_ptr)->next);
4437 (*dt_list_ptr) = gfc_get_dt_list ();
4438 (*dt_list_ptr)->derived = tmp_sym;
4439 (*dt_list_ptr)->next = NULL;
4441 /* Set up the component of the derived type, which will be
4442 an integer with kind equal to c_ptr_size. Mangle the name of
4443 the field for the c_address to prevent the curious user from
4444 trying to access it from Fortran. */
4445 sprintf (comp_name, "__%s_%s", tmp_sym->name, "c_address");
4446 gfc_add_component (tmp_sym, comp_name, &tmp_comp);
4447 if (tmp_comp == NULL)
4448 gfc_internal_error ("generate_isocbinding_symbol(): Unable to "
4449 "create component for c_address");
4451 tmp_comp->ts.type = BT_INTEGER;
4453 /* Set this because the module will need to read/write this field. */
4454 tmp_comp->ts.f90_type = BT_INTEGER;
4456 /* The kinds for c_ptr and c_funptr are the same. */
4457 index = get_c_kind ("c_ptr", c_interop_kinds_table);
4458 tmp_comp->ts.kind = c_interop_kinds_table[index].value;
4460 tmp_comp->attr.pointer = 0;
4461 tmp_comp->attr.dimension = 0;
4463 /* Mark the component as C interoperable. */
4464 tmp_comp->ts.is_c_interop = 1;
4466 /* Make it use associated (iso_c_binding module). */
4467 tmp_sym->attr.use_assoc = 1;
4470 case ISOCBINDING_NULL_PTR:
4471 case ISOCBINDING_NULL_FUNPTR:
4472 gen_special_c_interop_ptr (s, name, mod_name);
4475 case ISOCBINDING_F_POINTER:
4476 case ISOCBINDING_ASSOCIATED:
4477 case ISOCBINDING_LOC:
4478 case ISOCBINDING_FUNLOC:
4479 case ISOCBINDING_F_PROCPOINTER:
4481 tmp_sym->attr.proc = PROC_MODULE;
4483 /* Use the procedure's name as it is in the iso_c_binding module for
4484 setting the binding label in case the user renamed the symbol. */
4485 sprintf (tmp_sym->binding_label, "%s_%s", mod_name,
4486 c_interop_kinds_table[s].name);
4487 tmp_sym->attr.is_iso_c = 1;
4488 if (s == ISOCBINDING_F_POINTER || s == ISOCBINDING_F_PROCPOINTER)
4489 tmp_sym->attr.subroutine = 1;
4492 /* TODO! This needs to be finished more for the expr of the
4493 function or something!
4494 This may not need to be here, because trying to do c_loc
4496 if (s == ISOCBINDING_ASSOCIATED)
4498 tmp_sym->attr.function = 1;
4499 tmp_sym->ts.type = BT_LOGICAL;
4500 tmp_sym->ts.kind = gfc_default_logical_kind;
4501 tmp_sym->result = tmp_sym;
4505 /* Here, we're taking the simple approach. We're defining
4506 c_loc as an external identifier so the compiler will put
4507 what we expect on the stack for the address we want the
4509 tmp_sym->ts.type = BT_DERIVED;
4510 if (s == ISOCBINDING_LOC)
4511 tmp_sym->ts.u.derived =
4512 get_iso_c_binding_dt (ISOCBINDING_PTR);
4514 tmp_sym->ts.u.derived =
4515 get_iso_c_binding_dt (ISOCBINDING_FUNPTR);
4517 if (tmp_sym->ts.u.derived == NULL)
4519 /* Create the necessary derived type so we can continue
4520 processing the file. */
4521 generate_isocbinding_symbol
4522 (mod_name, s == ISOCBINDING_FUNLOC
4523 ? ISOCBINDING_FUNPTR : ISOCBINDING_PTR,
4524 (const char *)(s == ISOCBINDING_FUNLOC
4525 ? "_gfortran_iso_c_binding_c_funptr"
4526 : "_gfortran_iso_c_binding_c_ptr"));
4527 tmp_sym->ts.u.derived =
4528 get_iso_c_binding_dt (s == ISOCBINDING_FUNLOC
4529 ? ISOCBINDING_FUNPTR
4533 /* The function result is itself (no result clause). */
4534 tmp_sym->result = tmp_sym;
4535 tmp_sym->attr.external = 1;
4536 tmp_sym->attr.use_assoc = 0;
4537 tmp_sym->attr.pure = 1;
4538 tmp_sym->attr.if_source = IFSRC_UNKNOWN;
4539 tmp_sym->attr.proc = PROC_UNKNOWN;
4543 tmp_sym->attr.flavor = FL_PROCEDURE;
4544 tmp_sym->attr.contained = 0;
4546 /* Try using this builder routine, with the new and old symbols
4547 both being the generic iso_c proc sym being created. This
4548 will create the formal args (and the new namespace for them).
4549 Don't build an arg list for c_loc because we're going to treat
4550 c_loc as an external procedure. */
4551 if (s != ISOCBINDING_LOC && s != ISOCBINDING_FUNLOC)
4552 /* The 1 says to add any optional args, if applicable. */
4553 build_formal_args (tmp_sym, tmp_sym, 1);
4555 /* Set this after setting up the symbol, to prevent error messages. */
4556 tmp_sym->attr.use_assoc = 1;
4558 /* This symbol will not be referenced directly. It will be
4559 resolved to the implementation for the given f90 kind. */
4560 tmp_sym->attr.referenced = 0;
4567 gfc_commit_symbol (tmp_sym);
4571 /* Creates a new symbol based off of an old iso_c symbol, with a new
4572 binding label. This function can be used to create a new,
4573 resolved, version of a procedure symbol for c_f_pointer or
4574 c_f_procpointer that is based on the generic symbols. A new
4575 parameter list is created for the new symbol using
4576 build_formal_args(). The add_optional_flag specifies whether the
4577 to add the optional SHAPE argument. The new symbol is
4581 get_iso_c_sym (gfc_symbol *old_sym, char *new_name,
4582 char *new_binding_label, int add_optional_arg)
4584 gfc_symtree *new_symtree = NULL;
4586 /* See if we have a symbol by that name already available, looking
4587 through any parent namespaces. */
4588 gfc_find_sym_tree (new_name, gfc_current_ns, 1, &new_symtree);
4589 if (new_symtree != NULL)
4590 /* Return the existing symbol. */
4591 return new_symtree->n.sym;
4593 /* Create the symtree/symbol, with attempted host association. */
4594 gfc_get_ha_sym_tree (new_name, &new_symtree);
4595 if (new_symtree == NULL)
4596 gfc_internal_error ("get_iso_c_sym(): Unable to create "
4597 "symtree for '%s'", new_name);
4599 /* Now fill in the fields of the resolved symbol with the old sym. */
4600 strcpy (new_symtree->n.sym->binding_label, new_binding_label);
4601 new_symtree->n.sym->attr = old_sym->attr;
4602 new_symtree->n.sym->ts = old_sym->ts;
4603 new_symtree->n.sym->module = gfc_get_string (old_sym->module);
4604 new_symtree->n.sym->from_intmod = old_sym->from_intmod;
4605 new_symtree->n.sym->intmod_sym_id = old_sym->intmod_sym_id;
4606 if (old_sym->attr.function)
4607 new_symtree->n.sym->result = new_symtree->n.sym;
4608 /* Build the formal arg list. */
4609 build_formal_args (new_symtree->n.sym, old_sym, add_optional_arg);
4611 gfc_commit_symbol (new_symtree->n.sym);
4613 return new_symtree->n.sym;
4617 /* Check that a symbol is already typed. If strict is not set, an untyped
4618 symbol is acceptable for non-standard-conforming mode. */
4621 gfc_check_symbol_typed (gfc_symbol* sym, gfc_namespace* ns,
4622 bool strict, locus where)
4626 if (gfc_matching_prefix)
4629 /* Check for the type and try to give it an implicit one. */
4630 if (sym->ts.type == BT_UNKNOWN
4631 && gfc_set_default_type (sym, 0, ns) == FAILURE)
4635 gfc_error ("Symbol '%s' is used before it is typed at %L",
4640 if (gfc_notify_std (GFC_STD_GNU,
4641 "Extension: Symbol '%s' is used before"
4642 " it is typed at %L", sym->name, &where) == FAILURE)
4646 /* Everything is ok. */
4651 /* Construct a typebound-procedure structure. Those are stored in a tentative
4652 list and marked `error' until symbols are committed. */
4655 gfc_get_typebound_proc (gfc_typebound_proc *tb0)
4657 gfc_typebound_proc *result;
4658 tentative_tbp *list_node;
4660 result = XCNEW (gfc_typebound_proc);
4665 list_node = XCNEW (tentative_tbp);
4666 list_node->next = tentative_tbp_list;
4667 list_node->proc = result;
4668 tentative_tbp_list = list_node;
4674 /* Get the super-type of a given derived type. */
4677 gfc_get_derived_super_type (gfc_symbol* derived)
4679 if (!derived->attr.extension)
4682 gcc_assert (derived->components);
4683 gcc_assert (derived->components->ts.type == BT_DERIVED);
4684 gcc_assert (derived->components->ts.u.derived);
4686 return derived->components->ts.u.derived;
4690 /* Get the ultimate super-type of a given derived type. */
4693 gfc_get_ultimate_derived_super_type (gfc_symbol* derived)
4695 if (!derived->attr.extension)
4698 derived = gfc_get_derived_super_type (derived);
4700 if (derived->attr.extension)
4701 return gfc_get_ultimate_derived_super_type (derived);
4707 /* Check if a derived type t2 is an extension of (or equal to) a type t1. */
4710 gfc_type_is_extension_of (gfc_symbol *t1, gfc_symbol *t2)
4712 while (!gfc_compare_derived_types (t1, t2) && t2->attr.extension)
4713 t2 = gfc_get_derived_super_type (t2);
4714 return gfc_compare_derived_types (t1, t2);
4718 /* Check if two typespecs are type compatible (F03:5.1.1.2):
4719 If ts1 is nonpolymorphic, ts2 must be the same type.
4720 If ts1 is polymorphic (CLASS), ts2 must be an extension of ts1. */
4723 gfc_type_compatible (gfc_typespec *ts1, gfc_typespec *ts2)
4725 bool is_class1 = (ts1->type == BT_CLASS);
4726 bool is_class2 = (ts2->type == BT_CLASS);
4727 bool is_derived1 = (ts1->type == BT_DERIVED);
4728 bool is_derived2 = (ts2->type == BT_DERIVED);
4730 if (!is_derived1 && !is_derived2 && !is_class1 && !is_class2)
4731 return (ts1->type == ts2->type);
4733 if (is_derived1 && is_derived2)
4734 return gfc_compare_derived_types (ts1->u.derived, ts2->u.derived);
4736 if (is_class1 && is_derived2)
4737 return gfc_type_is_extension_of (ts1->u.derived->components->ts.u.derived,
4739 else if (is_class1 && is_class2)
4740 return gfc_type_is_extension_of (ts1->u.derived->components->ts.u.derived,
4741 ts2->u.derived->components->ts.u.derived);
4747 /* Find the parent-namespace of the current function. If we're inside
4748 BLOCK constructs, it may not be the current one. */
4751 gfc_find_proc_namespace (gfc_namespace* ns)
4753 while (ns->construct_entities)
4763 /* Check if an associate-variable should be translated as an `implicit' pointer
4764 internally (if it is associated to a variable and not an array with
4768 gfc_is_associate_pointer (gfc_symbol* sym)
4773 if (!sym->assoc->variable)
4776 if (sym->attr.dimension && sym->as->type != AS_EXPLICIT)