1 /* Declaration statement matcher
2 Copyright (C) 2002 Free Software Foundation, Inc.
3 Contributed by Andy Vaught
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 2, or (at your option) any later
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING. If not, write to the Free
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
30 /* This flag is set if a an old-style length selector is matched
31 during a type-declaration statement. */
33 static int old_char_selector;
35 /* When variables aquire types and attributes from a declaration
36 statement, they get them from the following static variables. The
37 first part of a declaration sets these variables and the second
38 part copies these into symbol structures. */
40 static gfc_typespec current_ts;
42 static symbol_attribute current_attr;
43 static gfc_array_spec *current_as;
44 static int colon_seen;
46 /* gfc_new_block points to the symbol of a newly matched block. */
48 gfc_symbol *gfc_new_block;
51 /* Match an intent specification. Since this can only happen after an
52 INTENT word, a legal intent-spec must follow. */
55 match_intent_spec (void)
58 if (gfc_match (" ( in out )") == MATCH_YES)
60 if (gfc_match (" ( in )") == MATCH_YES)
62 if (gfc_match (" ( out )") == MATCH_YES)
65 gfc_error ("Bad INTENT specification at %C");
66 return INTENT_UNKNOWN;
70 /* Matches a character length specification, which is either a
71 specification expression or a '*'. */
74 char_len_param_value (gfc_expr ** expr)
77 if (gfc_match_char ('*') == MATCH_YES)
83 return gfc_match_expr (expr);
87 /* A character length is a '*' followed by a literal integer or a
88 char_len_param_value in parenthesis. */
91 match_char_length (gfc_expr ** expr)
96 m = gfc_match_char ('*');
100 m = gfc_match_small_literal_int (&length);
101 if (m == MATCH_ERROR)
106 *expr = gfc_int_expr (length);
110 if (gfc_match_char ('(') == MATCH_NO)
113 m = char_len_param_value (expr);
114 if (m == MATCH_ERROR)
119 if (gfc_match_char (')') == MATCH_NO)
121 gfc_free_expr (*expr);
129 gfc_error ("Syntax error in character length specification at %C");
134 /* Special subroutine for finding a symbol. If we're compiling a
135 function or subroutine and the parent compilation unit is an
136 interface, then check to see if the name we've been given is the
137 name of the interface (located in another namespace). If so,
138 return that symbol. If not, use gfc_get_symbol(). */
141 find_special (const char *name, gfc_symbol ** result)
145 if (gfc_current_state () != COMP_SUBROUTINE
146 && gfc_current_state () != COMP_FUNCTION)
149 s = gfc_state_stack->previous;
153 if (s->state != COMP_INTERFACE)
156 goto normal; /* Nameless interface */
158 if (strcmp (name, s->sym->name) == 0)
165 return gfc_get_symbol (name, NULL, result);
169 /* Special subroutine for getting a symbol node associated with a
170 procedure name, used in SUBROUTINE and FUNCTION statements. The
171 symbol is created in the parent using with symtree node in the
172 child unit pointing to the symbol. If the current namespace has no
173 parent, then the symbol is just created in the current unit. */
176 get_proc_name (const char *name, gfc_symbol ** result)
182 if (gfc_current_ns->parent == NULL)
183 return gfc_get_symbol (name, NULL, result);
185 rc = gfc_get_symbol (name, gfc_current_ns->parent, result);
189 /* Deal with ENTRY problem */
191 st = gfc_new_symtree (&gfc_current_ns->sym_root, name);
197 /* See if the procedure should be a module procedure */
199 if (sym->ns->proc_name != NULL
200 && sym->ns->proc_name->attr.flavor == FL_MODULE
201 && sym->attr.proc != PROC_MODULE
202 && gfc_add_procedure (&sym->attr, PROC_MODULE, NULL) == FAILURE)
209 /* Function called by variable_decl() that adds a name to the symbol
213 build_sym (const char *name, gfc_charlen * cl,
214 gfc_array_spec ** as, locus * var_locus)
216 symbol_attribute attr;
219 if (find_special (name, &sym))
222 /* Start updating the symbol table. Add basic type attribute
224 if (current_ts.type != BT_UNKNOWN
225 &&(sym->attr.implicit_type == 0
226 || !gfc_compare_types (&sym->ts, ¤t_ts))
227 && gfc_add_type (sym, ¤t_ts, var_locus) == FAILURE)
230 if (sym->ts.type == BT_CHARACTER)
233 /* Add dimension attribute if present. */
234 if (gfc_set_array_spec (sym, *as, var_locus) == FAILURE)
238 /* Add attribute to symbol. The copy is so that we can reset the
239 dimension attribute. */
243 if (gfc_copy_attr (&sym->attr, &attr, var_locus) == FAILURE)
250 /* Function called by variable_decl() that adds an initialization
251 expression to a symbol. */
254 add_init_expr_to_sym (const char *name, gfc_expr ** initp,
257 symbol_attribute attr;
262 if (find_special (name, &sym))
267 /* If this symbol is confirming an implicit parameter type,
268 then an initialization expression is not allowed. */
269 if (attr.flavor == FL_PARAMETER
270 && sym->value != NULL
273 gfc_error ("Initializer not allowed for PARAMETER '%s' at %C",
282 gfc_error ("Initializer not allowed for COMMON variable '%s' at %C",
289 /* An initializer is required for PARAMETER declarations. */
290 if (attr.flavor == FL_PARAMETER)
292 gfc_error ("PARAMETER at %L is missing an initializer", var_locus);
298 /* If a variable appears in a DATA block, it cannot have an
303 ("Variable '%s' at %C with an initializer already appears "
304 "in a DATA statement", sym->name);
308 /* Checking a derived type parameter has to be put off until later. */
309 if (sym->ts.type != BT_DERIVED && init->ts.type != BT_DERIVED
310 && gfc_check_assign_symbol (sym, init) == FAILURE)
313 /* Add initializer. Make sure we keep the ranks sane. */
314 if (sym->attr.dimension && init->rank == 0)
315 init->rank = sym->as->rank;
325 /* Function called by variable_decl() that adds a name to a structure
329 build_struct (const char *name, gfc_charlen * cl, gfc_expr ** init,
330 gfc_array_spec ** as)
334 /* If the current symbol is of the same derived type that we're
335 constructing, it must have the pointer attribute. */
336 if (current_ts.type == BT_DERIVED
337 && current_ts.derived == gfc_current_block ()
338 && current_attr.pointer == 0)
340 gfc_error ("Component at %C must have the POINTER attribute");
344 if (gfc_current_block ()->attr.pointer
347 if ((*as)->type != AS_DEFERRED && (*as)->type != AS_EXPLICIT)
349 gfc_error ("Array component of structure at %C must have explicit "
350 "or deferred shape");
355 if (gfc_add_component (gfc_current_block (), name, &c) == FAILURE)
360 gfc_set_component_attr (c, ¤t_attr);
362 c->initializer = *init;
370 /* Check array components. */
376 if (c->as->type != AS_DEFERRED)
378 gfc_error ("Pointer array component of structure at %C "
379 "must have a deferred shape");
385 if (c->as->type != AS_EXPLICIT)
388 ("Array component of structure at %C must have an explicit "
398 /* Match a 'NULL()', and possibly take care of some side effects. */
401 gfc_match_null (gfc_expr ** result)
407 m = gfc_match (" null ( )");
411 /* The NULL symbol now has to be/become an intrinsic function. */
412 if (gfc_get_symbol ("null", NULL, &sym))
414 gfc_error ("NULL() initialization at %C is ambiguous");
418 gfc_intrinsic_symbol (sym);
420 if (sym->attr.proc != PROC_INTRINSIC
421 && (gfc_add_procedure (&sym->attr, PROC_INTRINSIC, NULL) == FAILURE
422 || gfc_add_function (&sym->attr, NULL) == FAILURE))
426 e->where = gfc_current_locus;
427 e->expr_type = EXPR_NULL;
428 e->ts.type = BT_UNKNOWN;
436 /* Match a variable name with an optional initializer. When this
437 subroutine is called, a variable is expected to be parsed next.
438 Depending on what is happening at the moment, updates either the
439 symbol table or the current interface. */
444 char name[GFC_MAX_SYMBOL_LEN + 1];
445 gfc_expr *initializer, *char_len;
455 /* When we get here, we've just matched a list of attributes and
456 maybe a type and a double colon. The next thing we expect to see
457 is the name of the symbol. */
458 m = gfc_match_name (name);
462 var_locus = gfc_current_locus;
464 /* Now we could see the optional array spec. or character length. */
465 m = gfc_match_array_spec (&as);
466 if (m == MATCH_ERROR)
469 as = gfc_copy_array_spec (current_as);
474 if (current_ts.type == BT_CHARACTER)
476 switch (match_char_length (&char_len))
479 cl = gfc_get_charlen ();
480 cl->next = gfc_current_ns->cl_list;
481 gfc_current_ns->cl_list = cl;
483 cl->length = char_len;
495 /* OK, we've successfully matched the declaration. Now put the
496 symbol in the current namespace, because it might be used in the
497 optional intialization expression for this symbol, e.g. this is
500 integer, parameter :: i = huge(i)
502 This is only true for parameters or variables of a basic type.
503 For components of derived types, it is not true, so we don't
504 create a symbol for those yet. If we fail to create the symbol,
506 if (gfc_current_state () != COMP_DERIVED
507 && build_sym (name, cl, &as, &var_locus) == FAILURE)
513 /* In functions that have a RESULT variable defined, the function
514 name always refers to function calls. Therefore, the name is
515 not allowed to appear in specification statements. */
516 if (gfc_current_state () == COMP_FUNCTION
517 && gfc_current_block () != NULL
518 && gfc_current_block ()->result != NULL
519 && gfc_current_block ()->result != gfc_current_block ()
520 && strcmp (gfc_current_block ()->name, name) == 0)
522 gfc_error ("Function name '%s' not allowed at %C", name);
527 /* The double colon must be present in order to have initializers.
528 Otherwise the statement is ambiguous with an assignment statement. */
531 if (gfc_match (" =>") == MATCH_YES)
534 if (!current_attr.pointer)
536 gfc_error ("Initialization at %C isn't for a pointer variable");
541 m = gfc_match_null (&initializer);
544 gfc_error ("Pointer initialization requires a NULL at %C");
551 ("Initialization of pointer at %C is not allowed in a "
559 initializer->ts = current_ts;
562 else if (gfc_match_char ('=') == MATCH_YES)
564 if (current_attr.pointer)
567 ("Pointer initialization at %C requires '=>', not '='");
572 m = gfc_match_init_expr (&initializer);
575 gfc_error ("Expected an initialization expression at %C");
579 if (current_attr.flavor != FL_PARAMETER && gfc_pure (NULL))
582 ("Initialization of variable at %C is not allowed in a "
592 /* Add the initializer. Note that it is fine if initializer is
593 NULL here, because we sometimes also need to check if a
594 declaration *must* have an initialization expression. */
595 if (gfc_current_state () != COMP_DERIVED)
596 t = add_init_expr_to_sym (name, &initializer, &var_locus);
599 if (current_ts.type == BT_DERIVED && !initializer)
600 initializer = gfc_default_initializer (¤t_ts);
601 t = build_struct (name, cl, &initializer, &as);
604 m = (t == SUCCESS) ? MATCH_YES : MATCH_ERROR;
607 /* Free stuff up and return. */
608 gfc_free_expr (initializer);
609 gfc_free_array_spec (as);
615 /* Match an extended-f77 kind specification. */
618 gfc_match_old_kind_spec (gfc_typespec * ts)
622 if (gfc_match_char ('*') != MATCH_YES)
625 m = gfc_match_small_literal_int (&ts->kind);
629 /* Massage the kind numbers for complex types. */
630 if (ts->type == BT_COMPLEX && ts->kind == 8)
632 if (ts->type == BT_COMPLEX && ts->kind == 16)
635 if (gfc_validate_kind (ts->type, ts->kind) == -1)
637 gfc_error ("Old-style kind %d not supported for type %s at %C",
638 ts->kind, gfc_basic_typename (ts->type));
647 /* Match a kind specification. Since kinds are generally optional, we
648 usually return MATCH_NO if something goes wrong. If a "kind="
649 string is found, then we know we have an error. */
652 gfc_match_kind_spec (gfc_typespec * ts)
662 where = gfc_current_locus;
664 if (gfc_match_char ('(') == MATCH_NO)
667 /* Also gobbles optional text. */
668 if (gfc_match (" kind = ") == MATCH_YES)
671 n = gfc_match_init_expr (&e);
673 gfc_error ("Expected initialization expression at %C");
679 gfc_error ("Expected scalar initialization expression at %C");
684 msg = gfc_extract_int (e, &ts->kind);
695 if (gfc_validate_kind (ts->type, ts->kind) == -1)
697 gfc_error ("Kind %d not supported for type %s at %C", ts->kind,
698 gfc_basic_typename (ts->type));
704 if (gfc_match_char (')') != MATCH_YES)
706 gfc_error ("Missing right paren at %C");
714 gfc_current_locus = where;
719 /* Match the various kind/length specifications in a CHARACTER
720 declaration. We don't return MATCH_NO. */
723 match_char_spec (gfc_typespec * ts)
725 int i, kind, seen_length;
730 kind = gfc_default_character_kind ();
734 /* Try the old-style specification first. */
735 old_char_selector = 0;
737 m = match_char_length (&len);
741 old_char_selector = 1;
746 m = gfc_match_char ('(');
749 m = MATCH_YES; /* character without length is a single char */
753 /* Try the weird case: ( KIND = <int> [ , LEN = <len-param> ] ) */
754 if (gfc_match (" kind =") == MATCH_YES)
756 m = gfc_match_small_int (&kind);
757 if (m == MATCH_ERROR)
762 if (gfc_match (" , len =") == MATCH_NO)
765 m = char_len_param_value (&len);
768 if (m == MATCH_ERROR)
775 /* Try to match ( LEN = <len-param> ) or ( LEN = <len-param>, KIND = <int> ) */
776 if (gfc_match (" len =") == MATCH_YES)
778 m = char_len_param_value (&len);
781 if (m == MATCH_ERROR)
785 if (gfc_match_char (')') == MATCH_YES)
788 if (gfc_match (" , kind =") != MATCH_YES)
791 gfc_match_small_int (&kind);
793 if (gfc_validate_kind (BT_CHARACTER, kind) == -1)
795 gfc_error ("Kind %d is not a CHARACTER kind at %C", kind);
802 /* Try to match ( <len-param> ) or ( <len-param> , [ KIND = ] <int> ) */
803 m = char_len_param_value (&len);
806 if (m == MATCH_ERROR)
810 m = gfc_match_char (')');
814 if (gfc_match_char (',') != MATCH_YES)
817 gfc_match (" kind ="); /* Gobble optional text */
819 m = gfc_match_small_int (&kind);
820 if (m == MATCH_ERROR)
826 /* Require a right-paren at this point. */
827 m = gfc_match_char (')');
832 gfc_error ("Syntax error in CHARACTER declaration at %C");
836 if (m == MATCH_YES && gfc_validate_kind (BT_CHARACTER, kind) == -1)
838 gfc_error ("Kind %d is not a CHARACTER kind at %C", kind);
848 /* Do some final massaging of the length values. */
849 cl = gfc_get_charlen ();
850 cl->next = gfc_current_ns->cl_list;
851 gfc_current_ns->cl_list = cl;
853 if (seen_length == 0)
854 cl->length = gfc_int_expr (1);
857 if (len == NULL || gfc_extract_int (len, &i) != NULL || i >= 0)
862 cl->length = gfc_int_expr (0);
873 /* Matches a type specification. If successful, sets the ts structure
874 to the matched specification. This is necessary for FUNCTION and
877 If kind_flag is nonzero, then we check for the optional kind
878 specification. Not doing so is needed for matching an IMPLICIT
879 statement correctly. */
882 gfc_match_type_spec (gfc_typespec * ts, int kind_flag)
884 char name[GFC_MAX_SYMBOL_LEN + 1];
890 if (gfc_match (" integer") == MATCH_YES)
892 ts->type = BT_INTEGER;
893 ts->kind = gfc_default_integer_kind ();
897 if (gfc_match (" character") == MATCH_YES)
899 ts->type = BT_CHARACTER;
900 return match_char_spec (ts);
903 if (gfc_match (" real") == MATCH_YES)
906 ts->kind = gfc_default_real_kind ();
910 if (gfc_match (" double precision") == MATCH_YES)
913 ts->kind = gfc_default_double_kind ();
917 if (gfc_match (" complex") == MATCH_YES)
919 ts->type = BT_COMPLEX;
920 ts->kind = gfc_default_complex_kind ();
924 if (gfc_match (" double complex") == MATCH_YES)
926 ts->type = BT_COMPLEX;
927 ts->kind = gfc_default_double_kind ();
931 if (gfc_match (" logical") == MATCH_YES)
933 ts->type = BT_LOGICAL;
934 ts->kind = gfc_default_logical_kind ();
938 m = gfc_match (" type ( %n )", name);
942 /* Search for the name but allow the components to be defined later. */
943 if (gfc_get_ha_symbol (name, &sym))
945 gfc_error ("Type name '%s' at %C is ambiguous", name);
949 if (sym->attr.flavor != FL_DERIVED
950 && gfc_add_flavor (&sym->attr, FL_DERIVED, NULL) == FAILURE)
953 ts->type = BT_DERIVED;
960 /* For all types except double, derived and character, look for an
961 optional kind specifier. MATCH_NO is actually OK at this point. */
965 m = gfc_match_kind_spec (ts);
966 if (m == MATCH_NO && ts->type != BT_CHARACTER)
967 m = gfc_match_old_kind_spec (ts);
970 m = MATCH_YES; /* No kind specifier found. */
976 /* Matches an attribute specification including array specs. If
977 successful, leaves the variables current_attr and current_as
978 holding the specification. Also sets the colon_seen variable for
979 later use by matchers associated with initializations.
981 This subroutine is a little tricky in the sense that we don't know
982 if we really have an attr-spec until we hit the double colon.
983 Until that time, we can only return MATCH_NO. This forces us to
984 check for duplicate specification at this level. */
987 match_attr_spec (void)
990 /* Modifiers that can exist in a type statement. */
992 { GFC_DECL_BEGIN = 0,
993 DECL_ALLOCATABLE = GFC_DECL_BEGIN, DECL_DIMENSION, DECL_EXTERNAL,
994 DECL_IN, DECL_OUT, DECL_INOUT, DECL_INTRINSIC, DECL_OPTIONAL,
995 DECL_PARAMETER, DECL_POINTER, DECL_PRIVATE, DECL_PUBLIC, DECL_SAVE,
996 DECL_TARGET, DECL_COLON, DECL_NONE,
997 GFC_DECL_END /* Sentinel */
1001 /* GFC_DECL_END is the sentinel, index starts at 0. */
1002 #define NUM_DECL GFC_DECL_END
1004 static mstring decls[] = {
1005 minit (", allocatable", DECL_ALLOCATABLE),
1006 minit (", dimension", DECL_DIMENSION),
1007 minit (", external", DECL_EXTERNAL),
1008 minit (", intent ( in )", DECL_IN),
1009 minit (", intent ( out )", DECL_OUT),
1010 minit (", intent ( in out )", DECL_INOUT),
1011 minit (", intrinsic", DECL_INTRINSIC),
1012 minit (", optional", DECL_OPTIONAL),
1013 minit (", parameter", DECL_PARAMETER),
1014 minit (", pointer", DECL_POINTER),
1015 minit (", private", DECL_PRIVATE),
1016 minit (", public", DECL_PUBLIC),
1017 minit (", save", DECL_SAVE),
1018 minit (", target", DECL_TARGET),
1019 minit ("::", DECL_COLON),
1020 minit (NULL, DECL_NONE)
1023 locus start, seen_at[NUM_DECL];
1030 gfc_clear_attr (¤t_attr);
1031 start = gfc_current_locus;
1036 /* See if we get all of the keywords up to the final double colon. */
1037 for (d = GFC_DECL_BEGIN; d != GFC_DECL_END; d++)
1042 d = (decl_types) gfc_match_strings (decls);
1043 if (d == DECL_NONE || d == DECL_COLON)
1047 seen_at[d] = gfc_current_locus;
1049 if (d == DECL_DIMENSION)
1051 m = gfc_match_array_spec (¤t_as);
1055 gfc_error ("Missing dimension specification at %C");
1059 if (m == MATCH_ERROR)
1064 /* No double colon, so assume that we've been looking at something
1065 else the whole time. */
1072 /* Since we've seen a double colon, we have to be looking at an
1073 attr-spec. This means that we can now issue errors. */
1074 for (d = GFC_DECL_BEGIN; d != GFC_DECL_END; d++)
1079 case DECL_ALLOCATABLE:
1080 attr = "ALLOCATABLE";
1082 case DECL_DIMENSION:
1089 attr = "INTENT (IN)";
1092 attr = "INTENT (OUT)";
1095 attr = "INTENT (IN OUT)";
1097 case DECL_INTRINSIC:
1103 case DECL_PARAMETER:
1122 attr = NULL; /* This shouldn't happen */
1125 gfc_error ("Duplicate %s attribute at %L", attr, &seen_at[d]);
1130 /* Now that we've dealt with duplicate attributes, add the attributes
1131 to the current attribute. */
1132 for (d = GFC_DECL_BEGIN; d != GFC_DECL_END; d++)
1137 if (gfc_current_state () == COMP_DERIVED
1138 && d != DECL_DIMENSION && d != DECL_POINTER
1139 && d != DECL_COLON && d != DECL_NONE)
1142 gfc_error ("Attribute at %L is not allowed in a TYPE definition",
1150 case DECL_ALLOCATABLE:
1151 t = gfc_add_allocatable (¤t_attr, &seen_at[d]);
1154 case DECL_DIMENSION:
1155 t = gfc_add_dimension (¤t_attr, &seen_at[d]);
1159 t = gfc_add_external (¤t_attr, &seen_at[d]);
1163 t = gfc_add_intent (¤t_attr, INTENT_IN, &seen_at[d]);
1167 t = gfc_add_intent (¤t_attr, INTENT_OUT, &seen_at[d]);
1171 t = gfc_add_intent (¤t_attr, INTENT_INOUT, &seen_at[d]);
1174 case DECL_INTRINSIC:
1175 t = gfc_add_intrinsic (¤t_attr, &seen_at[d]);
1179 t = gfc_add_optional (¤t_attr, &seen_at[d]);
1182 case DECL_PARAMETER:
1183 t = gfc_add_flavor (¤t_attr, FL_PARAMETER, &seen_at[d]);
1187 t = gfc_add_pointer (¤t_attr, &seen_at[d]);
1191 t = gfc_add_access (¤t_attr, ACCESS_PRIVATE, &seen_at[d]);
1195 t = gfc_add_access (¤t_attr, ACCESS_PUBLIC, &seen_at[d]);
1199 t = gfc_add_save (¤t_attr, &seen_at[d]);
1203 t = gfc_add_target (¤t_attr, &seen_at[d]);
1207 gfc_internal_error ("match_attr_spec(): Bad attribute");
1221 gfc_current_locus = start;
1222 gfc_free_array_spec (current_as);
1228 /* Match a data declaration statement. */
1231 gfc_match_data_decl (void)
1236 m = gfc_match_type_spec (¤t_ts, 1);
1240 if (current_ts.type == BT_DERIVED && gfc_current_state () != COMP_DERIVED)
1242 sym = gfc_use_derived (current_ts.derived);
1250 current_ts.derived = sym;
1253 m = match_attr_spec ();
1254 if (m == MATCH_ERROR)
1260 if (current_ts.type == BT_DERIVED && current_ts.derived->components == NULL)
1263 if (current_attr.pointer && gfc_current_state () == COMP_DERIVED)
1266 if (gfc_find_symbol (current_ts.derived->name,
1267 current_ts.derived->ns->parent, 1, &sym) == 0)
1270 /* Hope that an ambiguous symbol is itself masked by a type definition. */
1271 if (sym != NULL && sym->attr.flavor == FL_DERIVED)
1274 gfc_error ("Derived type at %C has not been previously defined");
1280 /* If we have an old-style character declaration, and no new-style
1281 attribute specifications, then there a comma is optional between
1282 the type specification and the variable list. */
1283 if (m == MATCH_NO && current_ts.type == BT_CHARACTER && old_char_selector)
1284 gfc_match_char (',');
1286 /* Give the types/attributes to symbols that follow. */
1289 m = variable_decl ();
1290 if (m == MATCH_ERROR)
1295 if (gfc_match_eos () == MATCH_YES)
1297 if (gfc_match_char (',') != MATCH_YES)
1301 gfc_error ("Syntax error in data declaration at %C");
1305 gfc_free_array_spec (current_as);
1311 /* Match a prefix associated with a function or subroutine
1312 declaration. If the typespec pointer is nonnull, then a typespec
1313 can be matched. Note that if nothing matches, MATCH_YES is
1314 returned (the null string was matched). */
1317 match_prefix (gfc_typespec * ts)
1321 gfc_clear_attr (¤t_attr);
1325 if (!seen_type && ts != NULL
1326 && gfc_match_type_spec (ts, 1) == MATCH_YES
1327 && gfc_match_space () == MATCH_YES)
1334 if (gfc_match ("elemental% ") == MATCH_YES)
1336 if (gfc_add_elemental (¤t_attr, NULL) == FAILURE)
1342 if (gfc_match ("pure% ") == MATCH_YES)
1344 if (gfc_add_pure (¤t_attr, NULL) == FAILURE)
1350 if (gfc_match ("recursive% ") == MATCH_YES)
1352 if (gfc_add_recursive (¤t_attr, NULL) == FAILURE)
1358 /* At this point, the next item is not a prefix. */
1363 /* Copy attributes matched by match_prefix() to attributes on a symbol. */
1366 copy_prefix (symbol_attribute * dest, locus * where)
1369 if (current_attr.pure && gfc_add_pure (dest, where) == FAILURE)
1372 if (current_attr.elemental && gfc_add_elemental (dest, where) == FAILURE)
1375 if (current_attr.recursive && gfc_add_recursive (dest, where) == FAILURE)
1382 /* Match a formal argument list. */
1385 gfc_match_formal_arglist (gfc_symbol * progname, int st_flag, int null_flag)
1387 gfc_formal_arglist *head, *tail, *p, *q;
1388 char name[GFC_MAX_SYMBOL_LEN + 1];
1394 if (gfc_match_char ('(') != MATCH_YES)
1401 if (gfc_match_char (')') == MATCH_YES)
1406 if (gfc_match_char ('*') == MATCH_YES)
1410 m = gfc_match_name (name);
1414 if (gfc_get_symbol (name, NULL, &sym))
1418 p = gfc_get_formal_arglist ();
1430 /* We don't add the VARIABLE flavor because the name could be a
1431 dummy procedure. We don't apply these attributes to formal
1432 arguments of statement functions. */
1433 if (sym != NULL && !st_flag
1434 && (gfc_add_dummy (&sym->attr, NULL) == FAILURE
1435 || gfc_missing_attr (&sym->attr, NULL) == FAILURE))
1441 /* The name of a program unit can be in a different namespace,
1442 so check for it explicitly. After the statement is accepted,
1443 the name is checked for especially in gfc_get_symbol(). */
1444 if (gfc_new_block != NULL && sym != NULL
1445 && strcmp (sym->name, gfc_new_block->name) == 0)
1447 gfc_error ("Name '%s' at %C is the name of the procedure",
1453 if (gfc_match_char (')') == MATCH_YES)
1456 m = gfc_match_char (',');
1459 gfc_error ("Unexpected junk in formal argument list at %C");
1465 /* Check for duplicate symbols in the formal argument list. */
1468 for (p = head; p->next; p = p->next)
1473 for (q = p->next; q; q = q->next)
1474 if (p->sym == q->sym)
1477 ("Duplicate symbol '%s' in formal argument list at %C",
1486 if (gfc_add_explicit_interface (progname, IFSRC_DECL, head, NULL) ==
1496 gfc_free_formal_arglist (head);
1501 /* Match a RESULT specification following a function declaration or
1502 ENTRY statement. Also matches the end-of-statement. */
1505 match_result (gfc_symbol * function, gfc_symbol ** result)
1507 char name[GFC_MAX_SYMBOL_LEN + 1];
1511 if (gfc_match (" result (") != MATCH_YES)
1514 m = gfc_match_name (name);
1518 if (gfc_match (" )%t") != MATCH_YES)
1520 gfc_error ("Unexpected junk following RESULT variable at %C");
1524 if (strcmp (function->name, name) == 0)
1527 ("RESULT variable at %C must be different than function name");
1531 if (gfc_get_symbol (name, NULL, &r))
1534 if (gfc_add_flavor (&r->attr, FL_VARIABLE, NULL) == FAILURE
1535 || gfc_add_result (&r->attr, NULL) == FAILURE)
1544 /* Match a function declaration. */
1547 gfc_match_function_decl (void)
1549 char name[GFC_MAX_SYMBOL_LEN + 1];
1550 gfc_symbol *sym, *result;
1554 if (gfc_current_state () != COMP_NONE
1555 && gfc_current_state () != COMP_INTERFACE
1556 && gfc_current_state () != COMP_CONTAINS)
1559 gfc_clear_ts (¤t_ts);
1561 old_loc = gfc_current_locus;
1563 m = match_prefix (¤t_ts);
1566 gfc_current_locus = old_loc;
1570 if (gfc_match ("function% %n", name) != MATCH_YES)
1572 gfc_current_locus = old_loc;
1576 if (get_proc_name (name, &sym))
1578 gfc_new_block = sym;
1580 m = gfc_match_formal_arglist (sym, 0, 0);
1582 gfc_error ("Expected formal argument list in function definition at %C");
1583 else if (m == MATCH_ERROR)
1588 if (gfc_match_eos () != MATCH_YES)
1590 /* See if a result variable is present. */
1591 m = match_result (sym, &result);
1593 gfc_error ("Unexpected junk after function declaration at %C");
1602 /* Make changes to the symbol. */
1605 if (gfc_add_function (&sym->attr, NULL) == FAILURE)
1608 if (gfc_missing_attr (&sym->attr, NULL) == FAILURE
1609 || copy_prefix (&sym->attr, &sym->declared_at) == FAILURE)
1612 if (current_ts.type != BT_UNKNOWN && sym->ts.type != BT_UNKNOWN)
1614 gfc_error ("Function '%s' at %C already has a type of %s", name,
1615 gfc_basic_typename (sym->ts.type));
1621 sym->ts = current_ts;
1626 result->ts = current_ts;
1627 sym->result = result;
1633 gfc_current_locus = old_loc;
1638 /* Match an ENTRY statement. */
1641 gfc_match_entry (void)
1643 gfc_symbol *function, *result, *entry;
1644 char name[GFC_MAX_SYMBOL_LEN + 1];
1645 gfc_compile_state state;
1648 m = gfc_match_name (name);
1652 if (get_proc_name (name, &entry))
1655 gfc_enclosing_unit (&state);
1658 case COMP_SUBROUTINE:
1659 m = gfc_match_formal_arglist (entry, 0, 1);
1663 if (gfc_current_state () != COMP_SUBROUTINE)
1664 goto exec_construct;
1666 if (gfc_add_entry (&entry->attr, NULL) == FAILURE
1667 || gfc_add_subroutine (&entry->attr, NULL) == FAILURE)
1673 m = gfc_match_formal_arglist (entry, 0, 0);
1677 if (gfc_current_state () != COMP_FUNCTION)
1678 goto exec_construct;
1679 function = gfc_state_stack->sym;
1683 if (gfc_match_eos () == MATCH_YES)
1685 if (gfc_add_entry (&entry->attr, NULL) == FAILURE
1686 || gfc_add_function (&entry->attr, NULL) == FAILURE)
1689 entry->result = function->result;
1694 m = match_result (function, &result);
1696 gfc_syntax_error (ST_ENTRY);
1700 if (gfc_add_result (&result->attr, NULL) == FAILURE
1701 || gfc_add_entry (&entry->attr, NULL) == FAILURE
1702 || gfc_add_function (&entry->attr, NULL) == FAILURE)
1706 if (function->attr.recursive && result == NULL)
1708 gfc_error ("RESULT attribute required in ENTRY statement at %C");
1715 goto exec_construct;
1718 if (gfc_match_eos () != MATCH_YES)
1720 gfc_syntax_error (ST_ENTRY);
1727 gfc_error ("ENTRY statement at %C cannot appear within %s",
1728 gfc_state_name (gfc_current_state ()));
1734 /* Match a subroutine statement, including optional prefixes. */
1737 gfc_match_subroutine (void)
1739 char name[GFC_MAX_SYMBOL_LEN + 1];
1743 if (gfc_current_state () != COMP_NONE
1744 && gfc_current_state () != COMP_INTERFACE
1745 && gfc_current_state () != COMP_CONTAINS)
1748 m = match_prefix (NULL);
1752 m = gfc_match ("subroutine% %n", name);
1756 if (get_proc_name (name, &sym))
1758 gfc_new_block = sym;
1760 if (gfc_add_subroutine (&sym->attr, NULL) == FAILURE)
1763 if (gfc_match_formal_arglist (sym, 0, 1) != MATCH_YES)
1766 if (gfc_match_eos () != MATCH_YES)
1768 gfc_syntax_error (ST_SUBROUTINE);
1772 if (copy_prefix (&sym->attr, &sym->declared_at) == FAILURE)
1779 /* Match any of the various end-block statements. Returns the type of
1780 END to the caller. The END INTERFACE, END IF, END DO and END
1781 SELECT statements cannot be replaced by a single END statement. */
1784 gfc_match_end (gfc_statement * st)
1786 char name[GFC_MAX_SYMBOL_LEN + 1];
1787 gfc_compile_state state;
1789 const char *block_name;
1793 old_loc = gfc_current_locus;
1794 if (gfc_match ("end") != MATCH_YES)
1797 state = gfc_current_state ();
1799 gfc_current_block () == NULL ? NULL : gfc_current_block ()->name;
1801 if (state == COMP_CONTAINS)
1803 state = gfc_state_stack->previous->state;
1804 block_name = gfc_state_stack->previous->sym == NULL ? NULL
1805 : gfc_state_stack->previous->sym->name;
1812 *st = ST_END_PROGRAM;
1813 target = " program";
1816 case COMP_SUBROUTINE:
1817 *st = ST_END_SUBROUTINE;
1818 target = " subroutine";
1822 *st = ST_END_FUNCTION;
1823 target = " function";
1826 case COMP_BLOCK_DATA:
1827 *st = ST_END_BLOCK_DATA;
1828 target = " block data";
1832 *st = ST_END_MODULE;
1836 case COMP_INTERFACE:
1837 *st = ST_END_INTERFACE;
1838 target = " interface";
1857 *st = ST_END_SELECT;
1862 *st = ST_END_FORALL;
1872 gfc_error ("Unexpected END statement at %C");
1876 if (gfc_match_eos () == MATCH_YES)
1878 state = gfc_current_state ();
1880 if (*st == ST_ENDIF || *st == ST_ENDDO || *st == ST_END_SELECT
1881 || *st == ST_END_INTERFACE || *st == ST_END_FORALL
1882 || *st == ST_END_WHERE
1883 || /* A contained procedure requires END FUNCTION/SUBROUTINE. */
1884 ((state == COMP_FUNCTION || state == COMP_SUBROUTINE)
1885 && gfc_state_stack->previous != NULL
1886 && gfc_state_stack->previous->state == COMP_CONTAINS))
1889 gfc_error ("%s statement expected at %C",
1890 gfc_ascii_statement (*st));
1897 /* Verify that we've got the sort of end-block that we're expecting. */
1898 if (gfc_match (target) != MATCH_YES)
1900 gfc_error ("Expecting %s statement at %C", gfc_ascii_statement (*st));
1904 /* If we're at the end, make sure a block name wasn't required. */
1905 if (gfc_match_eos () == MATCH_YES)
1908 if (*st != ST_ENDDO && *st != ST_ENDIF && *st != ST_END_SELECT)
1911 if (gfc_current_block () == NULL)
1914 gfc_error ("Expected block name of '%s' in %s statement at %C",
1915 block_name, gfc_ascii_statement (*st));
1920 /* END INTERFACE has a special handler for its several possible endings. */
1921 if (*st == ST_END_INTERFACE)
1922 return gfc_match_end_interface ();
1924 /* We haven't hit the end of statement, so what is left must be an end-name. */
1925 m = gfc_match_space ();
1927 m = gfc_match_name (name);
1930 gfc_error ("Expected terminating name at %C");
1934 if (block_name == NULL)
1937 if (strcmp (name, block_name) != 0)
1939 gfc_error ("Expected label '%s' for %s statement at %C", block_name,
1940 gfc_ascii_statement (*st));
1944 if (gfc_match_eos () == MATCH_YES)
1948 gfc_syntax_error (*st);
1951 gfc_current_locus = old_loc;
1957 /***************** Attribute declaration statements ****************/
1959 /* Set the attribute of a single variable. */
1964 char name[GFC_MAX_SYMBOL_LEN + 1];
1972 m = gfc_match_name (name);
1976 if (find_special (name, &sym))
1979 var_locus = gfc_current_locus;
1981 /* Deal with possible array specification for certain attributes. */
1982 if (current_attr.dimension
1983 || current_attr.allocatable
1984 || current_attr.pointer
1985 || current_attr.target)
1987 m = gfc_match_array_spec (&as);
1988 if (m == MATCH_ERROR)
1991 if (current_attr.dimension && m == MATCH_NO)
1994 ("Missing array specification at %L in DIMENSION statement",
2000 if ((current_attr.allocatable || current_attr.pointer)
2001 && (m == MATCH_YES) && (as->type != AS_DEFERRED))
2003 gfc_error ("Array specification must be deferred at %L",
2010 /* Update symbol table. DIMENSION attribute is set in gfc_set_array_spec(). */
2011 if (current_attr.dimension == 0
2012 && gfc_copy_attr (&sym->attr, ¤t_attr, NULL) == FAILURE)
2018 if (gfc_set_array_spec (sym, as, &var_locus) == FAILURE)
2024 if ((current_attr.external || current_attr.intrinsic)
2025 && sym->attr.flavor != FL_PROCEDURE
2026 && gfc_add_flavor (&sym->attr, FL_PROCEDURE, NULL) == FAILURE)
2035 gfc_free_array_spec (as);
2040 /* Generic attribute declaration subroutine. Used for attributes that
2041 just have a list of names. */
2048 /* Gobble the optional double colon, by simply ignoring the result
2058 if (gfc_match_eos () == MATCH_YES)
2064 if (gfc_match_char (',') != MATCH_YES)
2066 gfc_error ("Unexpected character in variable list at %C");
2077 gfc_match_external (void)
2080 gfc_clear_attr (¤t_attr);
2081 gfc_add_external (¤t_attr, NULL);
2083 return attr_decl ();
2089 gfc_match_intent (void)
2093 intent = match_intent_spec ();
2094 if (intent == INTENT_UNKNOWN)
2097 gfc_clear_attr (¤t_attr);
2098 gfc_add_intent (¤t_attr, intent, NULL); /* Can't fail */
2100 return attr_decl ();
2105 gfc_match_intrinsic (void)
2108 gfc_clear_attr (¤t_attr);
2109 gfc_add_intrinsic (¤t_attr, NULL);
2111 return attr_decl ();
2116 gfc_match_optional (void)
2119 gfc_clear_attr (¤t_attr);
2120 gfc_add_optional (¤t_attr, NULL);
2122 return attr_decl ();
2127 gfc_match_pointer (void)
2130 gfc_clear_attr (¤t_attr);
2131 gfc_add_pointer (¤t_attr, NULL);
2133 return attr_decl ();
2138 gfc_match_allocatable (void)
2141 gfc_clear_attr (¤t_attr);
2142 gfc_add_allocatable (¤t_attr, NULL);
2144 return attr_decl ();
2149 gfc_match_dimension (void)
2152 gfc_clear_attr (¤t_attr);
2153 gfc_add_dimension (¤t_attr, NULL);
2155 return attr_decl ();
2160 gfc_match_target (void)
2163 gfc_clear_attr (¤t_attr);
2164 gfc_add_target (¤t_attr, NULL);
2166 return attr_decl ();
2170 /* Match the list of entities being specified in a PUBLIC or PRIVATE
2174 access_attr_decl (gfc_statement st)
2176 char name[GFC_MAX_SYMBOL_LEN + 1];
2177 interface_type type;
2180 gfc_intrinsic_op operator;
2183 if (gfc_match (" ::") == MATCH_NO && gfc_match_space () == MATCH_NO)
2188 m = gfc_match_generic_spec (&type, name, &operator);
2191 if (m == MATCH_ERROR)
2196 case INTERFACE_NAMELESS:
2199 case INTERFACE_GENERIC:
2200 if (gfc_get_symbol (name, NULL, &sym))
2203 if (gfc_add_access (&sym->attr,
2205 ST_PUBLIC) ? ACCESS_PUBLIC : ACCESS_PRIVATE,
2211 case INTERFACE_INTRINSIC_OP:
2212 if (gfc_current_ns->operator_access[operator] == ACCESS_UNKNOWN)
2214 gfc_current_ns->operator_access[operator] =
2215 (st == ST_PUBLIC) ? ACCESS_PUBLIC : ACCESS_PRIVATE;
2219 gfc_error ("Access specification of the %s operator at %C has "
2220 "already been specified", gfc_op2string (operator));
2226 case INTERFACE_USER_OP:
2227 uop = gfc_get_uop (name);
2229 if (uop->access == ACCESS_UNKNOWN)
2232 (st == ST_PUBLIC) ? ACCESS_PUBLIC : ACCESS_PRIVATE;
2237 ("Access specification of the .%s. operator at %C has "
2238 "already been specified", sym->name);
2245 if (gfc_match_char (',') == MATCH_NO)
2249 if (gfc_match_eos () != MATCH_YES)
2254 gfc_syntax_error (st);
2261 /* The PRIVATE statement is a bit weird in that it can be a attribute
2262 declaration, but also works as a standlone statement inside of a
2263 type declaration or a module. */
2266 gfc_match_private (gfc_statement * st)
2269 if (gfc_match ("private") != MATCH_YES)
2272 if (gfc_current_state () == COMP_DERIVED)
2274 if (gfc_match_eos () == MATCH_YES)
2280 gfc_syntax_error (ST_PRIVATE);
2284 if (gfc_match_eos () == MATCH_YES)
2291 return access_attr_decl (ST_PRIVATE);
2296 gfc_match_public (gfc_statement * st)
2299 if (gfc_match ("public") != MATCH_YES)
2302 if (gfc_match_eos () == MATCH_YES)
2309 return access_attr_decl (ST_PUBLIC);
2313 /* Workhorse for gfc_match_parameter. */
2322 m = gfc_match_symbol (&sym, 0);
2324 gfc_error ("Expected variable name at %C in PARAMETER statement");
2329 if (gfc_match_char ('=') == MATCH_NO)
2331 gfc_error ("Expected = sign in PARAMETER statement at %C");
2335 m = gfc_match_init_expr (&init);
2337 gfc_error ("Expected expression at %C in PARAMETER statement");
2341 if (sym->ts.type == BT_UNKNOWN
2342 && gfc_set_default_type (sym, 1, NULL) == FAILURE)
2348 if (gfc_check_assign_symbol (sym, init) == FAILURE
2349 || gfc_add_flavor (&sym->attr, FL_PARAMETER, NULL) == FAILURE)
2359 gfc_free_expr (init);
2364 /* Match a parameter statement, with the weird syntax that these have. */
2367 gfc_match_parameter (void)
2371 if (gfc_match_char ('(') == MATCH_NO)
2380 if (gfc_match (" )%t") == MATCH_YES)
2383 if (gfc_match_char (',') != MATCH_YES)
2385 gfc_error ("Unexpected characters in PARAMETER statement at %C");
2395 /* Save statements have a special syntax. */
2398 gfc_match_save (void)
2403 if (gfc_match_eos () == MATCH_YES)
2405 if (gfc_current_ns->seen_save)
2407 gfc_error ("Blanket SAVE statement at %C follows previous "
2413 gfc_current_ns->save_all = gfc_current_ns->seen_save = 1;
2417 if (gfc_current_ns->save_all)
2419 gfc_error ("SAVE statement at %C follows blanket SAVE statement");
2427 m = gfc_match_symbol (&sym, 0);
2431 if (gfc_add_save (&sym->attr, &gfc_current_locus) == FAILURE)
2442 m = gfc_match (" / %s /", &sym);
2443 if (m == MATCH_ERROR)
2448 if (gfc_add_saved_common (&sym->attr, NULL) == FAILURE)
2450 gfc_current_ns->seen_save = 1;
2453 if (gfc_match_eos () == MATCH_YES)
2455 if (gfc_match_char (',') != MATCH_YES)
2462 gfc_error ("Syntax error in SAVE statement at %C");
2467 /* Match a module procedure statement. Note that we have to modify
2468 symbols in the parent's namespace because the current one was there
2469 to receive symbols that are in a interface's formal argument list. */
2472 gfc_match_modproc (void)
2474 char name[GFC_MAX_SYMBOL_LEN + 1];
2478 if (gfc_state_stack->state != COMP_INTERFACE
2479 || gfc_state_stack->previous == NULL
2480 || current_interface.type == INTERFACE_NAMELESS)
2483 ("MODULE PROCEDURE at %C must be in a generic module interface");
2489 m = gfc_match_name (name);
2495 if (gfc_get_symbol (name, gfc_current_ns->parent, &sym))
2498 if (sym->attr.proc != PROC_MODULE
2499 && gfc_add_procedure (&sym->attr, PROC_MODULE, NULL) == FAILURE)
2502 if (gfc_add_interface (sym) == FAILURE)
2505 if (gfc_match_eos () == MATCH_YES)
2507 if (gfc_match_char (',') != MATCH_YES)
2514 gfc_syntax_error (ST_MODULE_PROC);
2519 /* Match the beginning of a derived type declaration. If a type name
2520 was the result of a function, then it is possible to have a symbol
2521 already to be known as a derived type yet have no components. */
2524 gfc_match_derived_decl (void)
2526 char name[GFC_MAX_SYMBOL_LEN + 1];
2527 symbol_attribute attr;
2531 if (gfc_current_state () == COMP_DERIVED)
2534 gfc_clear_attr (&attr);
2537 if (gfc_match (" , private") == MATCH_YES)
2539 if (gfc_find_state (COMP_MODULE) == FAILURE)
2542 ("Derived type at %C can only be PRIVATE within a MODULE");
2546 if (gfc_add_access (&attr, ACCESS_PRIVATE, NULL) == FAILURE)
2551 if (gfc_match (" , public") == MATCH_YES)
2553 if (gfc_find_state (COMP_MODULE) == FAILURE)
2555 gfc_error ("Derived type at %C can only be PUBLIC within a MODULE");
2559 if (gfc_add_access (&attr, ACCESS_PUBLIC, NULL) == FAILURE)
2564 if (gfc_match (" ::") != MATCH_YES && attr.access != ACCESS_UNKNOWN)
2566 gfc_error ("Expected :: in TYPE definition at %C");
2570 m = gfc_match (" %n%t", name);
2574 /* Make sure the name isn't the name of an intrinsic type. The
2575 'double precision' type doesn't get past the name matcher. */
2576 if (strcmp (name, "integer") == 0
2577 || strcmp (name, "real") == 0
2578 || strcmp (name, "character") == 0
2579 || strcmp (name, "logical") == 0
2580 || strcmp (name, "complex") == 0)
2583 ("Type name '%s' at %C cannot be the same as an intrinsic type",
2588 if (gfc_get_symbol (name, NULL, &sym))
2591 if (sym->ts.type != BT_UNKNOWN)
2593 gfc_error ("Derived type name '%s' at %C already has a basic type "
2594 "of %s", sym->name, gfc_typename (&sym->ts));
2598 /* The symbol may already have the derived attribute without the
2599 components. The ways this can happen is via a function
2600 definition, an INTRINSIC statement or a subtype in another
2601 derived type that is a pointer. The first part of the AND clause
2602 is true if a the symbol is not the return value of a function. */
2603 if (sym->attr.flavor != FL_DERIVED
2604 && gfc_add_flavor (&sym->attr, FL_DERIVED, NULL) == FAILURE)
2607 if (sym->components != NULL)
2610 ("Derived type definition of '%s' at %C has already been defined",
2615 if (attr.access != ACCESS_UNKNOWN
2616 && gfc_add_access (&sym->attr, attr.access, NULL) == FAILURE)
2619 gfc_new_block = sym;