OSDN Git Service

For the 60th anniversary of Chinese people��s Anti-Japan war victory.
[pf3gnuchains/gcc-fork.git] / gcc / fortran / io.c
1 /* Deal with I/O statements & related stuff.
2    Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation,
3    Inc.
4    Contributed by Andy Vaught
5
6 This file is part of GCC.
7
8 GCC is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 2, or (at your option) any later
11 version.
12
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
16 for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING.  If not, write to the Free
20 Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
21 02110-1301, USA.  */
22
23 #include "config.h"
24 #include "system.h"
25 #include "flags.h"
26 #include "gfortran.h"
27 #include "match.h"
28 #include "parse.h"
29
30 gfc_st_label format_asterisk =
31   { -1, ST_LABEL_FORMAT, ST_LABEL_FORMAT, NULL, 0,
32     {NULL, NULL}, NULL, NULL};
33
34 typedef struct
35 {
36   const char *name, *spec;
37   bt type;
38 }
39 io_tag;
40
41 static const io_tag
42         tag_file        = { "FILE", " file = %e", BT_CHARACTER },
43         tag_status      = { "STATUS", " status = %e", BT_CHARACTER},
44         tag_e_access    = {"ACCESS", " access = %e", BT_CHARACTER},
45         tag_e_form      = {"FORM", " form = %e", BT_CHARACTER},
46         tag_e_recl      = {"RECL", " recl = %e", BT_INTEGER},
47         tag_e_blank     = {"BLANK", " blank = %e", BT_CHARACTER},
48         tag_e_position  = {"POSITION", " position = %e", BT_CHARACTER},
49         tag_e_action    = {"ACTION", " action = %e", BT_CHARACTER},
50         tag_e_delim     = {"DELIM", " delim = %e", BT_CHARACTER},
51         tag_e_pad       = {"PAD", " pad = %e", BT_CHARACTER},
52         tag_unit        = {"UNIT", " unit = %e", BT_INTEGER},
53         tag_advance     = {"ADVANCE", " advance = %e", BT_CHARACTER},
54         tag_rec         = {"REC", " rec = %e", BT_INTEGER},
55         tag_format      = {"FORMAT", NULL, BT_CHARACTER},
56         tag_iostat      = {"IOSTAT", " iostat = %v", BT_INTEGER},
57         tag_size        = {"SIZE", " size = %v", BT_INTEGER},
58         tag_exist       = {"EXIST", " exist = %v", BT_LOGICAL},
59         tag_opened      = {"OPENED", " opened = %v", BT_LOGICAL},
60         tag_named       = {"NAMED", " named = %v", BT_LOGICAL},
61         tag_name        = {"NAME", " name = %v", BT_CHARACTER},
62         tag_number      = {"NUMBER", " number = %v", BT_INTEGER},
63         tag_s_access    = {"ACCESS", " access = %v", BT_CHARACTER},
64         tag_sequential  = {"SEQUENTIAL", " sequential = %v", BT_CHARACTER},
65         tag_direct      = {"DIRECT", " direct = %v", BT_CHARACTER},
66         tag_s_form      = {"FORM", " form = %v", BT_CHARACTER},
67         tag_formatted   = {"FORMATTED", " formatted = %v", BT_CHARACTER},
68         tag_unformatted = {"UNFORMATTED", " unformatted = %v", BT_CHARACTER},
69         tag_s_recl      = {"RECL", " recl = %v", BT_INTEGER},
70         tag_nextrec     = {"NEXTREC", " nextrec = %v", BT_INTEGER},
71         tag_s_blank     = {"BLANK", " blank = %v", BT_CHARACTER},
72         tag_s_position  = {"POSITION", " position = %v", BT_CHARACTER},
73         tag_s_action    = {"ACTION", " action = %v", BT_CHARACTER},
74         tag_read        = {"READ", " read = %v", BT_CHARACTER},
75         tag_write       = {"WRITE", " write = %v", BT_CHARACTER},
76         tag_readwrite   = {"READWRITE", " readwrite = %v", BT_CHARACTER},
77         tag_s_delim     = {"DELIM", " delim = %v", BT_CHARACTER},
78         tag_s_pad       = {"PAD", " pad = %v", BT_CHARACTER},
79         tag_iolength    = {"IOLENGTH", " iolength = %v", BT_INTEGER},
80         tag_err         = {"ERR", " err = %l", BT_UNKNOWN},
81         tag_end         = {"END", " end = %l", BT_UNKNOWN},
82         tag_eor         = {"EOR", " eor = %l", BT_UNKNOWN};
83
84 static gfc_dt *current_dt;
85
86 #define RESOLVE_TAG(x, y) if (resolve_tag(x, y) == FAILURE) return FAILURE;
87
88
89 /**************** Fortran 95 FORMAT parser  *****************/
90
91 /* FORMAT tokens returned by format_lex().  */
92 typedef enum
93 {
94   FMT_NONE, FMT_UNKNOWN, FMT_SIGNED_INT, FMT_ZERO, FMT_POSINT, FMT_PERIOD,
95   FMT_COMMA, FMT_COLON, FMT_SLASH, FMT_DOLLAR, FMT_POS, FMT_LPAREN,
96   FMT_RPAREN, FMT_X, FMT_SIGN, FMT_BLANK, FMT_CHAR, FMT_P, FMT_IBOZ, FMT_F,
97   FMT_E, FMT_EXT, FMT_G, FMT_L, FMT_A, FMT_D, FMT_H, FMT_END
98 }
99 format_token;
100
101 /* Local variables for checking format strings.  The saved_token is
102    used to back up by a single format token during the parsing
103    process.  */
104 static char *format_string;
105 static int format_length, use_last_char;
106
107 static format_token saved_token;
108
109 static enum
110 { MODE_STRING, MODE_FORMAT, MODE_COPY }
111 mode;
112
113
114 /* Return the next character in the format string.  */
115
116 static char
117 next_char (int in_string)
118 {
119   static char c;
120
121   if (use_last_char)
122     {
123       use_last_char = 0;
124       return c;
125     }
126
127   format_length++;
128
129   if (mode == MODE_STRING)
130     c = *format_string++;
131   else
132     {
133       c = gfc_next_char_literal (in_string);
134       if (c == '\n')
135         c = '\0';
136
137       if (mode == MODE_COPY)
138         *format_string++ = c;
139     }
140
141   c = TOUPPER (c);
142   return c;
143 }
144
145
146 /* Back up one character position.  Only works once.  */
147
148 static void
149 unget_char (void)
150 {
151
152   use_last_char = 1;
153 }
154
155 static int value = 0;
156
157 /* Simple lexical analyzer for getting the next token in a FORMAT
158    statement.  */
159
160 static format_token
161 format_lex (void)
162 {
163   format_token token;
164   char c, delim;
165   int zflag;
166   int negative_flag;
167
168   if (saved_token != FMT_NONE)
169     {
170       token = saved_token;
171       saved_token = FMT_NONE;
172       return token;
173     }
174
175   do
176     {
177       c = next_char (0);
178     }
179   while (gfc_is_whitespace (c));
180
181   negative_flag = 0;
182   switch (c)
183     {
184     case '-':
185       negative_flag = 1;
186     case '+':
187       c = next_char (0);
188       if (!ISDIGIT (c))
189         {
190           token = FMT_UNKNOWN;
191           break;
192         }
193
194       value = c - '0';
195
196       do
197         {
198           c = next_char (0);
199           if(ISDIGIT (c))
200             value = 10 * value + c - '0';
201         }
202       while (ISDIGIT (c));
203
204       unget_char ();
205
206       if (negative_flag)
207         value = -value;
208
209       token = FMT_SIGNED_INT;
210       break;
211
212     case '0':
213     case '1':
214     case '2':
215     case '3':
216     case '4':
217     case '5':
218     case '6':
219     case '7':
220     case '8':
221     case '9':
222       zflag = (c == '0');
223
224       value = c - '0';
225
226       do
227         {
228           c = next_char (0);
229           if (c != '0')
230             zflag = 0;
231           if (ISDIGIT (c))
232             value = 10 * value + c - '0';
233         }
234       while (ISDIGIT (c));
235
236       unget_char ();
237       token = zflag ? FMT_ZERO : FMT_POSINT;
238       break;
239
240     case '.':
241       token = FMT_PERIOD;
242       break;
243
244     case ',':
245       token = FMT_COMMA;
246       break;
247
248     case ':':
249       token = FMT_COLON;
250       break;
251
252     case '/':
253       token = FMT_SLASH;
254       break;
255
256     case '$':
257       token = FMT_DOLLAR;
258       break;
259
260     case 'T':
261       c = next_char (0);
262       if (c != 'L' && c != 'R')
263         unget_char ();
264
265       token = FMT_POS;
266       break;
267
268     case '(':
269       token = FMT_LPAREN;
270       break;
271
272     case ')':
273       token = FMT_RPAREN;
274       break;
275
276     case 'X':
277       token = FMT_X;
278       break;
279
280     case 'S':
281       c = next_char (0);
282       if (c != 'P' && c != 'S')
283         unget_char ();
284
285       token = FMT_SIGN;
286       break;
287
288     case 'B':
289       c = next_char (0);
290       if (c == 'N' || c == 'Z')
291         token = FMT_BLANK;
292       else
293         {
294           unget_char ();
295           token = FMT_IBOZ;
296         }
297
298       break;
299
300     case '\'':
301     case '"':
302       delim = c;
303
304       value = 0;
305
306       for (;;)
307         {
308           c = next_char (1);
309           if (c == '\0')
310             {
311               token = FMT_END;
312               break;
313             }
314
315           if (c == delim)
316             {
317               c = next_char (1);
318
319               if (c == '\0')
320                 {
321                   token = FMT_END;
322                   break;
323                 }
324
325               if (c != delim)
326                 {
327                   unget_char ();
328                   token = FMT_CHAR;
329                   break;
330                 }
331             }
332           value++;
333         }
334       break;
335
336     case 'P':
337       token = FMT_P;
338       break;
339
340     case 'I':
341     case 'O':
342     case 'Z':
343       token = FMT_IBOZ;
344       break;
345
346     case 'F':
347       token = FMT_F;
348       break;
349
350     case 'E':
351       c = next_char (0);
352       if (c == 'N' || c == 'S')
353         token = FMT_EXT;
354       else
355         {
356           token = FMT_E;
357           unget_char ();
358         }
359
360       break;
361
362     case 'G':
363       token = FMT_G;
364       break;
365
366     case 'H':
367       token = FMT_H;
368       break;
369
370     case 'L':
371       token = FMT_L;
372       break;
373
374     case 'A':
375       token = FMT_A;
376       break;
377
378     case 'D':
379       token = FMT_D;
380       break;
381
382     case '\0':
383       token = FMT_END;
384       break;
385
386     default:
387       token = FMT_UNKNOWN;
388       break;
389     }
390
391   return token;
392 }
393
394
395 /* Check a format statement.  The format string, either from a FORMAT
396    statement or a constant in an I/O statement has already been parsed
397    by itself, and we are checking it for validity.  The dual origin
398    means that the warning message is a little less than great.  */
399
400 static try
401 check_format (void)
402 {
403   const char *posint_required     = "Positive width required";
404   const char *period_required     = "Period required";
405   const char *nonneg_required     = "Nonnegative width required";
406   const char *unexpected_element  = "Unexpected element";
407   const char *unexpected_end      = "Unexpected end of format string";
408
409   const char *error;
410   format_token t, u;
411   int level;
412   int repeat;
413   try rv;
414
415   use_last_char = 0;
416   saved_token = FMT_NONE;
417   level = 0;
418   repeat = 0;
419   rv = SUCCESS;
420
421   t = format_lex ();
422   if (t != FMT_LPAREN)
423     {
424       error = "Missing leading left parenthesis";
425       goto syntax;
426     }
427
428   t = format_lex ();
429   if (t == FMT_RPAREN)
430     goto finished;              /* Empty format is legal */
431   saved_token = t;
432
433 format_item:
434   /* In this state, the next thing has to be a format item.  */
435   t = format_lex ();
436 format_item_1:
437   switch (t)
438     {
439     case FMT_POSINT:
440       repeat = value;
441       t = format_lex ();
442       if (t == FMT_LPAREN)
443         {
444           level++;
445           goto format_item;
446         }
447
448       if (t == FMT_SLASH)
449         goto optional_comma;
450
451       goto data_desc;
452
453     case FMT_LPAREN:
454       level++;
455       goto format_item;
456
457     case FMT_SIGNED_INT:
458       /* Signed integer can only precede a P format.  */
459       t = format_lex ();
460       if (t != FMT_P)
461         {
462           error = "Expected P edit descriptor";
463           goto syntax;
464         }
465
466       goto data_desc;
467
468     case FMT_P:
469       /* P requires a prior number.  */
470       error = "P descriptor requires leading scale factor";
471       goto syntax;
472
473     case FMT_X:
474       /* X requires a prior number if we're being pedantic.  */
475       if (gfc_notify_std (GFC_STD_GNU, "Extension: X descriptor "
476                           "requires leading space count at %C")
477           == FAILURE)
478         return FAILURE;
479       goto between_desc;
480
481     case FMT_SIGN:
482     case FMT_BLANK:
483       goto between_desc;
484
485     case FMT_CHAR:
486       goto extension_optional_comma;
487
488     case FMT_COLON:
489     case FMT_SLASH:
490       goto optional_comma;
491
492     case FMT_DOLLAR:
493       t = format_lex ();
494
495       if (gfc_notify_std (GFC_STD_GNU, "Extension: $ descriptor at %C")
496           == FAILURE)
497         return FAILURE;
498       if (t != FMT_RPAREN || level > 0)
499         {
500           error = "$ must be the last specifier";
501           goto syntax;
502         }
503
504       goto finished;
505
506     case FMT_POS:
507     case FMT_IBOZ:
508     case FMT_F:
509     case FMT_E:
510     case FMT_EXT:
511     case FMT_G:
512     case FMT_L:
513     case FMT_A:
514     case FMT_D:
515       goto data_desc;
516
517     case FMT_H:
518       goto data_desc;
519
520     case FMT_END:
521       error = unexpected_end;
522       goto syntax;
523
524     default:
525       error = unexpected_element;
526       goto syntax;
527     }
528
529 data_desc:
530   /* In this state, t must currently be a data descriptor.
531      Deal with things that can/must follow the descriptor.  */
532   switch (t)
533     {
534     case FMT_SIGN:
535     case FMT_BLANK:
536     case FMT_X:
537       break;
538
539     case FMT_P:
540       if (pedantic)
541         {
542           t = format_lex ();
543           if (t == FMT_POSINT)
544             {
545               error = "Repeat count cannot follow P descriptor";
546               goto syntax;
547             }
548
549           saved_token = t;
550         }
551
552       goto optional_comma;
553
554     case FMT_POS:
555     case FMT_L:
556       t = format_lex ();
557       if (t == FMT_POSINT)
558         break;
559
560       error = posint_required;
561       goto syntax;
562
563     case FMT_A:
564       t = format_lex ();
565       if (t != FMT_POSINT)
566         saved_token = t;
567       break;
568
569     case FMT_D:
570     case FMT_E:
571     case FMT_G:
572     case FMT_EXT:
573       u = format_lex ();
574       if (u != FMT_POSINT)
575         {
576           error = posint_required;
577           goto syntax;
578         }
579
580       u = format_lex ();
581       if (u != FMT_PERIOD)
582         {
583           error = period_required;
584           goto syntax;
585         }
586
587       u = format_lex ();
588       if (u != FMT_ZERO && u != FMT_POSINT)
589         {
590           error = nonneg_required;
591           goto syntax;
592         }
593
594       if (t == FMT_D)
595         break;
596
597       /* Look for optional exponent.  */
598       u = format_lex ();
599       if (u != FMT_E)
600         {
601           saved_token = u;
602         }
603       else
604         {
605           u = format_lex ();
606           if (u != FMT_POSINT)
607             {
608               error = "Positive exponent width required";
609               goto syntax;
610             }
611         }
612
613       break;
614
615     case FMT_F:
616       t = format_lex ();
617       if (t != FMT_ZERO && t != FMT_POSINT)
618         {
619           error = nonneg_required;
620           goto syntax;
621         }
622
623       t = format_lex ();
624       if (t != FMT_PERIOD)
625         {
626           error = period_required;
627           goto syntax;
628         }
629
630       t = format_lex ();
631       if (t != FMT_ZERO && t != FMT_POSINT)
632         {
633           error = nonneg_required;
634           goto syntax;
635         }
636
637       break;
638
639     case FMT_H:
640       if(mode == MODE_STRING)
641       {
642         format_string += value;
643         format_length -= value;
644       }
645       else
646       {
647         while(repeat >0)
648          {
649           next_char(1);
650           repeat -- ;
651          }
652       }
653      break;
654
655     case FMT_IBOZ:
656       t = format_lex ();
657       if (t != FMT_ZERO && t != FMT_POSINT)
658         {
659           error = nonneg_required;
660           goto syntax;
661         }
662
663       t = format_lex ();
664       if (t != FMT_PERIOD)
665         {
666           saved_token = t;
667         }
668       else
669         {
670           t = format_lex ();
671           if (t != FMT_ZERO && t != FMT_POSINT)
672             {
673               error = nonneg_required;
674               goto syntax;
675             }
676         }
677
678       break;
679
680     default:
681       error = unexpected_element;
682       goto syntax;
683     }
684
685 between_desc:
686   /* Between a descriptor and what comes next.  */
687   t = format_lex ();
688   switch (t)
689     {
690
691     case FMT_COMMA:
692       goto format_item;
693
694     case FMT_RPAREN:
695       level--;
696       if (level < 0)
697         goto finished;
698       goto between_desc;
699
700     case FMT_COLON:
701     case FMT_SLASH:
702       goto optional_comma;
703
704     case FMT_END:
705       error = unexpected_end;
706       goto syntax;
707
708     default:
709       if (gfc_notify_std (GFC_STD_GNU, "Extension: Missing comma at %C")
710           == FAILURE)
711         return FAILURE;
712       goto format_item_1;
713     }
714
715 optional_comma:
716   /* Optional comma is a weird between state where we've just finished
717      reading a colon, slash or P descriptor.  */
718   t = format_lex ();
719   switch (t)
720     {
721     case FMT_COMMA:
722       break;
723
724     case FMT_RPAREN:
725       level--;
726       if (level < 0)
727         goto finished;
728       goto between_desc;
729
730     default:
731       /* Assume that we have another format item.  */
732       saved_token = t;
733       break;
734     }
735
736   goto format_item;
737
738 extension_optional_comma:
739   /* As a GNU extension, permit a missing comma after a string literal.  */
740   t = format_lex ();
741   switch (t)
742     {
743     case FMT_COMMA:
744       break;
745
746     case FMT_RPAREN:
747       level--;
748       if (level < 0)
749         goto finished;
750       goto between_desc;
751
752     case FMT_COLON:
753     case FMT_SLASH:
754       goto optional_comma;
755
756     case FMT_END:
757       error = unexpected_end;
758       goto syntax;
759
760     default:
761       if (gfc_notify_std (GFC_STD_GNU, "Extension: Missing comma at %C")
762           == FAILURE)
763         return FAILURE;
764       saved_token = t;
765       break;
766     }
767
768   goto format_item;
769
770 syntax:
771   /* Something went wrong.  If the format we're checking is a string,
772      generate a warning, since the program is correct.  If the format
773      is in a FORMAT statement, this messes up parsing, which is an
774      error.  */
775   if (mode != MODE_STRING)
776     gfc_error ("%s in format string at %C", error);
777   else
778     {
779       gfc_warning ("%s in format string at %C", error);
780
781       /* TODO: More elaborate measures are needed to show where a problem
782          is within a format string that has been calculated.  */
783     }
784
785   rv = FAILURE;
786
787 finished:
788   return rv;
789 }
790
791
792 /* Given an expression node that is a constant string, see if it looks
793    like a format string.  */
794
795 static void
796 check_format_string (gfc_expr * e)
797 {
798
799   mode = MODE_STRING;
800   format_string = e->value.character.string;
801   check_format ();
802 }
803
804
805 /************ Fortran 95 I/O statement matchers *************/
806
807 /* Match a FORMAT statement.  This amounts to actually parsing the
808    format descriptors in order to correctly locate the end of the
809    format string.  */
810
811 match
812 gfc_match_format (void)
813 {
814   gfc_expr *e;
815   locus start;
816
817   if (gfc_statement_label == NULL)
818     {
819       gfc_error ("Missing format label at %C");
820       return MATCH_ERROR;
821     }
822   gfc_gobble_whitespace ();
823
824   mode = MODE_FORMAT;
825   format_length = 0;
826
827   start = gfc_current_locus;
828
829   if (check_format () == FAILURE)
830     return MATCH_ERROR;
831
832   if (gfc_match_eos () != MATCH_YES)
833     {
834       gfc_syntax_error (ST_FORMAT);
835       return MATCH_ERROR;
836     }
837
838   /* The label doesn't get created until after the statement is done
839      being matched, so we have to leave the string for later.  */
840
841   gfc_current_locus = start;    /* Back to the beginning */
842
843   new_st.loc = start;
844   new_st.op = EXEC_NOP;
845
846   e = gfc_get_expr();
847   e->expr_type = EXPR_CONSTANT;
848   e->ts.type = BT_CHARACTER;
849   e->ts.kind = gfc_default_character_kind;
850   e->where = start;
851   e->value.character.string = format_string = gfc_getmem(format_length+1);
852   e->value.character.length = format_length;
853   gfc_statement_label->format = e;
854
855   mode = MODE_COPY;
856   check_format ();              /* Guaranteed to succeed */
857   gfc_match_eos ();             /* Guaranteed to succeed */
858
859   return MATCH_YES;
860 }
861
862
863 /* Match an expression I/O tag of some sort.  */
864
865 static match
866 match_etag (const io_tag * tag, gfc_expr ** v)
867 {
868   gfc_expr *result;
869   match m;
870
871   m = gfc_match (tag->spec, &result);
872   if (m != MATCH_YES)
873     return m;
874
875   if (*v != NULL)
876     {
877       gfc_error ("Duplicate %s specification at %C", tag->name);
878       gfc_free_expr (result);
879       return MATCH_ERROR;
880     }
881
882   *v = result;
883   return MATCH_YES;
884 }
885
886
887 /* Match a variable I/O tag of some sort.  */
888
889 static match
890 match_vtag (const io_tag * tag, gfc_expr ** v)
891 {
892   gfc_expr *result;
893   match m;
894
895   m = gfc_match (tag->spec, &result);
896   if (m != MATCH_YES)
897     return m;
898
899   if (*v != NULL)
900     {
901       gfc_error ("Duplicate %s specification at %C", tag->name);
902       gfc_free_expr (result);
903       return MATCH_ERROR;
904     }
905
906   if (result->symtree->n.sym->attr.intent == INTENT_IN)
907     {
908       gfc_error ("Variable tag cannot be INTENT(IN) at %C");
909       gfc_free_expr (result);
910       return MATCH_ERROR;
911     }
912
913   if (gfc_pure (NULL) && gfc_impure_variable (result->symtree->n.sym))
914     {
915       gfc_error ("Variable tag cannot be assigned in PURE procedure at %C");
916       gfc_free_expr (result);
917       return MATCH_ERROR;
918     }
919
920   *v = result;
921   return MATCH_YES;
922 }
923
924
925 /* Match I/O tags that cause variables to become redefined.  */
926
927 static match
928 match_out_tag(const io_tag *tag, gfc_expr **result)
929 {
930   match m;
931
932   m = match_vtag(tag, result);
933   if (m == MATCH_YES)
934     gfc_check_do_variable((*result)->symtree);
935
936   return m;
937 }
938
939
940 /* Match a label I/O tag.  */
941
942 static match
943 match_ltag (const io_tag * tag, gfc_st_label ** label)
944 {
945   match m;
946   gfc_st_label *old;
947
948   old = *label;
949   m = gfc_match (tag->spec, label);
950   if (m == MATCH_YES && old != 0)
951     {
952       gfc_error ("Duplicate %s label specification at %C", tag->name);
953       return MATCH_ERROR;
954     }
955
956   return m;
957 }
958
959
960 /* Do expression resolution and type-checking on an expression tag.  */
961
962 static try
963 resolve_tag (const io_tag * tag, gfc_expr * e)
964 {
965
966   if (e == NULL)
967     return SUCCESS;
968
969   if (gfc_resolve_expr (e) == FAILURE)
970     return FAILURE;
971
972   if (e->ts.type != tag->type && tag != &tag_format)
973     {
974       gfc_error ("%s tag at %L must be of type %s", tag->name,
975                 &e->where, gfc_basic_typename (tag->type));
976       return FAILURE;
977     }
978
979   if (tag == &tag_format)
980     {
981       /* If e's rank is zero and e is not an element of an array, it should be
982          of integer or character type.  The integer variable should be
983          ASSIGNED.  */
984       if (e->symtree == NULL || e->symtree->n.sym->as == NULL
985                 || e->symtree->n.sym->as->rank == 0)
986         {
987           if (e->ts.type != BT_CHARACTER && e->ts.type != BT_INTEGER)
988             {
989               gfc_error ("%s tag at %L must be of type %s or %s", tag->name,
990                         &e->where, gfc_basic_typename (BT_CHARACTER),
991                         gfc_basic_typename (BT_INTEGER));
992               return FAILURE;
993             }
994           else if (e->ts.type == BT_INTEGER && e->expr_type == EXPR_VARIABLE)
995             {
996               if (gfc_notify_std (GFC_STD_F95_DEL,
997                         "Obsolete: ASSIGNED variable in FORMAT tag at %L",
998                         &e->where) == FAILURE)
999                 return FAILURE;
1000               if (e->symtree->n.sym->attr.assign != 1)
1001                 {
1002                   gfc_error ("Variable '%s' at %L has not been assigned a "
1003                         "format label", e->symtree->n.sym->name, &e->where);
1004                   return FAILURE;
1005                 }
1006             }
1007           return SUCCESS;
1008         }
1009       else
1010         {
1011           /* if rank is nonzero, we allow the type to be character under
1012              GFC_STD_GNU and other type under GFC_STD_LEGACY. It may be
1013              assigned an Hollerith constant.  */
1014           if (e->ts.type == BT_CHARACTER)
1015             {
1016               if (gfc_notify_std (GFC_STD_GNU,
1017                         "Extension: Character array in FORMAT tag at %L",
1018                         &e->where) == FAILURE)
1019                 return FAILURE;
1020             }
1021           else
1022             {
1023               if (gfc_notify_std (GFC_STD_LEGACY,
1024                         "Extension: Non-character in FORMAT tag at %L",
1025                         &e->where) == FAILURE)
1026                 return FAILURE;
1027             }
1028           return SUCCESS;
1029         }
1030     }
1031   else
1032     {
1033       if (e->rank != 0)
1034         {
1035           gfc_error ("%s tag at %L must be scalar", tag->name, &e->where);
1036           return FAILURE;
1037         }
1038     }
1039
1040   return SUCCESS;
1041 }
1042
1043
1044 /* Match a single tag of an OPEN statement.  */
1045
1046 static match
1047 match_open_element (gfc_open * open)
1048 {
1049   match m;
1050
1051   m = match_etag (&tag_unit, &open->unit);
1052   if (m != MATCH_NO)
1053     return m;
1054   m = match_out_tag (&tag_iostat, &open->iostat);
1055   if (m != MATCH_NO)
1056     return m;
1057   m = match_etag (&tag_file, &open->file);
1058   if (m != MATCH_NO)
1059     return m;
1060   m = match_etag (&tag_status, &open->status);
1061   if (m != MATCH_NO)
1062     return m;
1063   m = match_etag (&tag_e_access, &open->access);
1064   if (m != MATCH_NO)
1065     return m;
1066   m = match_etag (&tag_e_form, &open->form);
1067   if (m != MATCH_NO)
1068     return m;
1069   m = match_etag (&tag_e_recl, &open->recl);
1070   if (m != MATCH_NO)
1071     return m;
1072   m = match_etag (&tag_e_blank, &open->blank);
1073   if (m != MATCH_NO)
1074     return m;
1075   m = match_etag (&tag_e_position, &open->position);
1076   if (m != MATCH_NO)
1077     return m;
1078   m = match_etag (&tag_e_action, &open->action);
1079   if (m != MATCH_NO)
1080     return m;
1081   m = match_etag (&tag_e_delim, &open->delim);
1082   if (m != MATCH_NO)
1083     return m;
1084   m = match_etag (&tag_e_pad, &open->pad);
1085   if (m != MATCH_NO)
1086     return m;
1087   m = match_ltag (&tag_err, &open->err);
1088   if (m != MATCH_NO)
1089     return m;
1090
1091   return MATCH_NO;
1092 }
1093
1094
1095 /* Free the gfc_open structure and all the expressions it contains.  */
1096
1097 void
1098 gfc_free_open (gfc_open * open)
1099 {
1100
1101   if (open == NULL)
1102     return;
1103
1104   gfc_free_expr (open->unit);
1105   gfc_free_expr (open->iostat);
1106   gfc_free_expr (open->file);
1107   gfc_free_expr (open->status);
1108   gfc_free_expr (open->access);
1109   gfc_free_expr (open->form);
1110   gfc_free_expr (open->recl);
1111   gfc_free_expr (open->blank);
1112   gfc_free_expr (open->position);
1113   gfc_free_expr (open->action);
1114   gfc_free_expr (open->delim);
1115   gfc_free_expr (open->pad);
1116
1117   gfc_free (open);
1118 }
1119
1120
1121 /* Resolve everything in a gfc_open structure.  */
1122
1123 try
1124 gfc_resolve_open (gfc_open * open)
1125 {
1126
1127   RESOLVE_TAG (&tag_unit, open->unit);
1128   RESOLVE_TAG (&tag_iostat, open->iostat);
1129   RESOLVE_TAG (&tag_file, open->file);
1130   RESOLVE_TAG (&tag_status, open->status);
1131   RESOLVE_TAG (&tag_e_form, open->form);
1132   RESOLVE_TAG (&tag_e_recl, open->recl);
1133
1134   RESOLVE_TAG (&tag_e_blank, open->blank);
1135   RESOLVE_TAG (&tag_e_position, open->position);
1136   RESOLVE_TAG (&tag_e_action, open->action);
1137   RESOLVE_TAG (&tag_e_delim, open->delim);
1138   RESOLVE_TAG (&tag_e_pad, open->pad);
1139
1140   if (gfc_reference_st_label (open->err, ST_LABEL_TARGET) == FAILURE)
1141     return FAILURE;
1142
1143   return SUCCESS;
1144 }
1145
1146
1147 /* Match an OPEN statement.  */
1148
1149 match
1150 gfc_match_open (void)
1151 {
1152   gfc_open *open;
1153   match m;
1154
1155   m = gfc_match_char ('(');
1156   if (m == MATCH_NO)
1157     return m;
1158
1159   open = gfc_getmem (sizeof (gfc_open));
1160
1161   m = match_open_element (open);
1162
1163   if (m == MATCH_ERROR)
1164     goto cleanup;
1165   if (m == MATCH_NO)
1166     {
1167       m = gfc_match_expr (&open->unit);
1168       if (m == MATCH_NO)
1169         goto syntax;
1170       if (m == MATCH_ERROR)
1171         goto cleanup;
1172     }
1173
1174   for (;;)
1175     {
1176       if (gfc_match_char (')') == MATCH_YES)
1177         break;
1178       if (gfc_match_char (',') != MATCH_YES)
1179         goto syntax;
1180
1181       m = match_open_element (open);
1182       if (m == MATCH_ERROR)
1183         goto cleanup;
1184       if (m == MATCH_NO)
1185         goto syntax;
1186     }
1187
1188   if (gfc_match_eos () == MATCH_NO)
1189     goto syntax;
1190
1191   if (gfc_pure (NULL))
1192     {
1193       gfc_error ("OPEN statement not allowed in PURE procedure at %C");
1194       goto cleanup;
1195     }
1196
1197   new_st.op = EXEC_OPEN;
1198   new_st.ext.open = open;
1199   return MATCH_YES;
1200
1201 syntax:
1202   gfc_syntax_error (ST_OPEN);
1203
1204 cleanup:
1205   gfc_free_open (open);
1206   return MATCH_ERROR;
1207 }
1208
1209
1210 /* Free a gfc_close structure an all its expressions.  */
1211
1212 void
1213 gfc_free_close (gfc_close * close)
1214 {
1215
1216   if (close == NULL)
1217     return;
1218
1219   gfc_free_expr (close->unit);
1220   gfc_free_expr (close->iostat);
1221   gfc_free_expr (close->status);
1222
1223   gfc_free (close);
1224 }
1225
1226
1227 /* Match elements of a CLOSE statement.  */
1228
1229 static match
1230 match_close_element (gfc_close * close)
1231 {
1232   match m;
1233
1234   m = match_etag (&tag_unit, &close->unit);
1235   if (m != MATCH_NO)
1236     return m;
1237   m = match_etag (&tag_status, &close->status);
1238   if (m != MATCH_NO)
1239     return m;
1240   m = match_out_tag (&tag_iostat, &close->iostat);
1241   if (m != MATCH_NO)
1242     return m;
1243   m = match_ltag (&tag_err, &close->err);
1244   if (m != MATCH_NO)
1245     return m;
1246
1247   return MATCH_NO;
1248 }
1249
1250
1251 /* Match a CLOSE statement.  */
1252
1253 match
1254 gfc_match_close (void)
1255 {
1256   gfc_close *close;
1257   match m;
1258
1259   m = gfc_match_char ('(');
1260   if (m == MATCH_NO)
1261     return m;
1262
1263   close = gfc_getmem (sizeof (gfc_close));
1264
1265   m = match_close_element (close);
1266
1267   if (m == MATCH_ERROR)
1268     goto cleanup;
1269   if (m == MATCH_NO)
1270     {
1271       m = gfc_match_expr (&close->unit);
1272       if (m == MATCH_NO)
1273         goto syntax;
1274       if (m == MATCH_ERROR)
1275         goto cleanup;
1276     }
1277
1278   for (;;)
1279     {
1280       if (gfc_match_char (')') == MATCH_YES)
1281         break;
1282       if (gfc_match_char (',') != MATCH_YES)
1283         goto syntax;
1284
1285       m = match_close_element (close);
1286       if (m == MATCH_ERROR)
1287         goto cleanup;
1288       if (m == MATCH_NO)
1289         goto syntax;
1290     }
1291
1292   if (gfc_match_eos () == MATCH_NO)
1293     goto syntax;
1294
1295   if (gfc_pure (NULL))
1296     {
1297       gfc_error ("CLOSE statement not allowed in PURE procedure at %C");
1298       goto cleanup;
1299     }
1300
1301   new_st.op = EXEC_CLOSE;
1302   new_st.ext.close = close;
1303   return MATCH_YES;
1304
1305 syntax:
1306   gfc_syntax_error (ST_CLOSE);
1307
1308 cleanup:
1309   gfc_free_close (close);
1310   return MATCH_ERROR;
1311 }
1312
1313
1314 /* Resolve everything in a gfc_close structure.  */
1315
1316 try
1317 gfc_resolve_close (gfc_close * close)
1318 {
1319
1320   RESOLVE_TAG (&tag_unit, close->unit);
1321   RESOLVE_TAG (&tag_iostat, close->iostat);
1322   RESOLVE_TAG (&tag_status, close->status);
1323
1324   if (gfc_reference_st_label (close->err, ST_LABEL_TARGET) == FAILURE)
1325     return FAILURE;
1326
1327   return SUCCESS;
1328 }
1329
1330
1331 /* Free a gfc_filepos structure.  */
1332
1333 void
1334 gfc_free_filepos (gfc_filepos * fp)
1335 {
1336
1337   gfc_free_expr (fp->unit);
1338   gfc_free_expr (fp->iostat);
1339   gfc_free (fp);
1340 }
1341
1342
1343 /* Match elements of a REWIND, BACKSPACE or ENDFILE statement.  */
1344
1345 static match
1346 match_file_element (gfc_filepos * fp)
1347 {
1348   match m;
1349
1350   m = match_etag (&tag_unit, &fp->unit);
1351   if (m != MATCH_NO)
1352     return m;
1353   m = match_out_tag (&tag_iostat, &fp->iostat);
1354   if (m != MATCH_NO)
1355     return m;
1356   m = match_ltag (&tag_err, &fp->err);
1357   if (m != MATCH_NO)
1358     return m;
1359
1360   return MATCH_NO;
1361 }
1362
1363
1364 /* Match the second half of the file-positioning statements, REWIND,
1365    BACKSPACE or ENDFILE.  */
1366
1367 static match
1368 match_filepos (gfc_statement st, gfc_exec_op op)
1369 {
1370   gfc_filepos *fp;
1371   match m;
1372
1373   fp = gfc_getmem (sizeof (gfc_filepos));
1374
1375   if (gfc_match_char ('(') == MATCH_NO)
1376     {
1377       m = gfc_match_expr (&fp->unit);
1378       if (m == MATCH_ERROR)
1379         goto cleanup;
1380       if (m == MATCH_NO)
1381         goto syntax;
1382
1383       goto done;
1384     }
1385
1386   m = match_file_element (fp);
1387   if (m == MATCH_ERROR)
1388     goto done;
1389   if (m == MATCH_NO)
1390     {
1391       m = gfc_match_expr (&fp->unit);
1392       if (m == MATCH_ERROR)
1393         goto done;
1394       if (m == MATCH_NO)
1395         goto syntax;
1396     }
1397
1398   for (;;)
1399     {
1400       if (gfc_match_char (')') == MATCH_YES)
1401         break;
1402       if (gfc_match_char (',') != MATCH_YES)
1403         goto syntax;
1404
1405       m = match_file_element (fp);
1406       if (m == MATCH_ERROR)
1407         goto cleanup;
1408       if (m == MATCH_NO)
1409         goto syntax;
1410     }
1411
1412 done:
1413   if (gfc_match_eos () != MATCH_YES)
1414     goto syntax;
1415
1416   if (gfc_pure (NULL))
1417     {
1418       gfc_error ("%s statement not allowed in PURE procedure at %C",
1419                  gfc_ascii_statement (st));
1420
1421       goto cleanup;
1422     }
1423
1424   new_st.op = op;
1425   new_st.ext.filepos = fp;
1426   return MATCH_YES;
1427
1428 syntax:
1429   gfc_syntax_error (st);
1430
1431 cleanup:
1432   gfc_free_filepos (fp);
1433   return MATCH_ERROR;
1434 }
1435
1436
1437 try
1438 gfc_resolve_filepos (gfc_filepos * fp)
1439 {
1440
1441   RESOLVE_TAG (&tag_unit, fp->unit);
1442   if (gfc_reference_st_label (fp->err, ST_LABEL_TARGET) == FAILURE)
1443     return FAILURE;
1444
1445   return SUCCESS;
1446 }
1447
1448
1449 /* Match the file positioning statements: ENDFILE, BACKSPACE or
1450    REWIND.  */
1451
1452 match
1453 gfc_match_endfile (void)
1454 {
1455
1456   return match_filepos (ST_END_FILE, EXEC_ENDFILE);
1457 }
1458
1459 match
1460 gfc_match_backspace (void)
1461 {
1462
1463   return match_filepos (ST_BACKSPACE, EXEC_BACKSPACE);
1464 }
1465
1466 match
1467 gfc_match_rewind (void)
1468 {
1469
1470   return match_filepos (ST_REWIND, EXEC_REWIND);
1471 }
1472
1473
1474 /******************** Data Transfer Statements *********************/
1475
1476 typedef enum
1477 { M_READ, M_WRITE, M_PRINT, M_INQUIRE }
1478 io_kind;
1479
1480
1481 /* Return a default unit number.  */
1482
1483 static gfc_expr *
1484 default_unit (io_kind k)
1485 {
1486   int unit;
1487
1488   if (k == M_READ)
1489     unit = 5;
1490   else
1491     unit = 6;
1492
1493   return gfc_int_expr (unit);
1494 }
1495
1496
1497 /* Match a unit specification for a data transfer statement.  */
1498
1499 static match
1500 match_dt_unit (io_kind k, gfc_dt * dt)
1501 {
1502   gfc_expr *e;
1503
1504   if (gfc_match_char ('*') == MATCH_YES)
1505     {
1506       if (dt->io_unit != NULL)
1507         goto conflict;
1508
1509       dt->io_unit = default_unit (k);
1510       return MATCH_YES;
1511     }
1512
1513   if (gfc_match_expr (&e) == MATCH_YES)
1514     {
1515       if (dt->io_unit != NULL)
1516         {
1517           gfc_free_expr (e);
1518           goto conflict;
1519         }
1520
1521       dt->io_unit = e;
1522       return MATCH_YES;
1523     }
1524
1525   return MATCH_NO;
1526
1527 conflict:
1528   gfc_error ("Duplicate UNIT specification at %C");
1529   return MATCH_ERROR;
1530 }
1531
1532
1533 /* Match a format specification.  */
1534
1535 static match
1536 match_dt_format (gfc_dt * dt)
1537 {
1538   locus where;
1539   gfc_expr *e;
1540   gfc_st_label *label;
1541
1542   where = gfc_current_locus;
1543
1544   if (gfc_match_char ('*') == MATCH_YES)
1545     {
1546       if (dt->format_expr != NULL || dt->format_label != NULL)
1547         goto conflict;
1548
1549       dt->format_label = &format_asterisk;
1550       return MATCH_YES;
1551     }
1552
1553   if (gfc_match_st_label (&label, 0) == MATCH_YES)
1554     {
1555       if (dt->format_expr != NULL || dt->format_label != NULL)
1556         {
1557           gfc_free_st_label (label);
1558           goto conflict;
1559         }
1560
1561       if (gfc_reference_st_label (label, ST_LABEL_FORMAT) == FAILURE)
1562         return MATCH_ERROR;
1563
1564       dt->format_label = label;
1565       return MATCH_YES;
1566     }
1567
1568   if (gfc_match_expr (&e) == MATCH_YES)
1569     {
1570       if (dt->format_expr != NULL || dt->format_label != NULL)
1571         {
1572           gfc_free_expr (e);
1573           goto conflict;
1574         }
1575       dt->format_expr = e;
1576       return MATCH_YES;
1577     }
1578
1579   gfc_current_locus = where;    /* The only case where we have to restore */
1580
1581   return MATCH_NO;
1582
1583 conflict:
1584   gfc_error ("Duplicate format specification at %C");
1585   return MATCH_ERROR;
1586 }
1587
1588
1589 /* Traverse a namelist that is part of a READ statement to make sure
1590    that none of the variables in the namelist are INTENT(IN).  Returns
1591    nonzero if we find such a variable.  */
1592
1593 static int
1594 check_namelist (gfc_symbol * sym)
1595 {
1596   gfc_namelist *p;
1597
1598   for (p = sym->namelist; p; p = p->next)
1599     if (p->sym->attr.intent == INTENT_IN)
1600       {
1601         gfc_error ("Symbol '%s' in namelist '%s' is INTENT(IN) at %C",
1602                    p->sym->name, sym->name);
1603         return 1;
1604       }
1605
1606   return 0;
1607 }
1608
1609
1610 /* Match a single data transfer element.  */
1611
1612 static match
1613 match_dt_element (io_kind k, gfc_dt * dt)
1614 {
1615   char name[GFC_MAX_SYMBOL_LEN + 1];
1616   gfc_symbol *sym;
1617   match m;
1618
1619   if (gfc_match (" unit =") == MATCH_YES)
1620     {
1621       m = match_dt_unit (k, dt);
1622       if (m != MATCH_NO)
1623         return m;
1624     }
1625
1626   if (gfc_match (" fmt =") == MATCH_YES)
1627     {
1628       m = match_dt_format (dt);
1629       if (m != MATCH_NO)
1630         return m;
1631     }
1632
1633   if (gfc_match (" nml = %n", name) == MATCH_YES)
1634     {
1635       if (dt->namelist != NULL)
1636         {
1637           gfc_error ("Duplicate NML specification at %C");
1638           return MATCH_ERROR;
1639         }
1640
1641       if (gfc_find_symbol (name, NULL, 1, &sym))
1642         return MATCH_ERROR;
1643
1644       if (sym == NULL || sym->attr.flavor != FL_NAMELIST)
1645         {
1646           gfc_error ("Symbol '%s' at %C must be a NAMELIST group name",
1647                      sym != NULL ? sym->name : name);
1648           return MATCH_ERROR;
1649         }
1650
1651       dt->namelist = sym;
1652       if (k == M_READ && check_namelist (sym))
1653         return MATCH_ERROR;
1654
1655       return MATCH_YES;
1656     }
1657
1658   m = match_etag (&tag_rec, &dt->rec);
1659   if (m != MATCH_NO)
1660     return m;
1661   m = match_out_tag (&tag_iostat, &dt->iostat);
1662   if (m != MATCH_NO)
1663     return m;
1664   m = match_ltag (&tag_err, &dt->err);
1665   if (m != MATCH_NO)
1666     return m;
1667   m = match_etag (&tag_advance, &dt->advance);
1668   if (m != MATCH_NO)
1669     return m;
1670   m = match_out_tag (&tag_size, &dt->size);
1671   if (m != MATCH_NO)
1672     return m;
1673
1674   m = match_ltag (&tag_end, &dt->end);
1675   if (m == MATCH_YES)
1676     {
1677       if (k == M_WRITE)
1678        {
1679          gfc_error ("END tag at %C not allowed in output statement");
1680          return MATCH_ERROR;
1681        }
1682       dt->end_where = gfc_current_locus;
1683     }
1684   if (m != MATCH_NO)
1685     return m;
1686
1687   m = match_ltag (&tag_eor, &dt->eor);
1688   if (m == MATCH_YES)
1689     dt->eor_where = gfc_current_locus;
1690   if (m != MATCH_NO)
1691     return m;
1692
1693   return MATCH_NO;
1694 }
1695
1696
1697 /* Free a data transfer structure and everything below it.  */
1698
1699 void
1700 gfc_free_dt (gfc_dt * dt)
1701 {
1702
1703   if (dt == NULL)
1704     return;
1705
1706   gfc_free_expr (dt->io_unit);
1707   gfc_free_expr (dt->format_expr);
1708   gfc_free_expr (dt->rec);
1709   gfc_free_expr (dt->advance);
1710   gfc_free_expr (dt->iostat);
1711   gfc_free_expr (dt->size);
1712
1713   gfc_free (dt);
1714 }
1715
1716
1717 /* Resolve everything in a gfc_dt structure.  */
1718
1719 try
1720 gfc_resolve_dt (gfc_dt * dt)
1721 {
1722   gfc_expr *e;
1723
1724   RESOLVE_TAG (&tag_format, dt->format_expr);
1725   RESOLVE_TAG (&tag_rec, dt->rec);
1726   RESOLVE_TAG (&tag_advance, dt->advance);
1727   RESOLVE_TAG (&tag_iostat, dt->iostat);
1728   RESOLVE_TAG (&tag_size, dt->size);
1729
1730   e = dt->io_unit;
1731   if (gfc_resolve_expr (e) == SUCCESS
1732       && (e->ts.type != BT_INTEGER
1733           && (e->ts.type != BT_CHARACTER
1734               || e->expr_type != EXPR_VARIABLE)))
1735     {
1736       gfc_error
1737         ("UNIT specification at %L must be an INTEGER expression or a "
1738          "CHARACTER variable", &e->where);
1739       return FAILURE;
1740     }
1741
1742   /* Sanity checks on data transfer statements.  */
1743   if (e->ts.type == BT_CHARACTER)
1744     {
1745       if (dt->rec != NULL)
1746         {
1747           gfc_error ("REC tag at %L is incompatible with internal file",
1748                      &dt->rec->where);
1749           return FAILURE;
1750         }
1751
1752       if (dt->namelist != NULL)
1753         {
1754           gfc_error ("Internal file at %L is incompatible with namelist",
1755                      &dt->io_unit->where);
1756           return FAILURE;
1757         }
1758
1759       if (dt->advance != NULL)
1760         {
1761           gfc_error ("ADVANCE tag at %L is incompatible with internal file",
1762                      &dt->advance->where);
1763           return FAILURE;
1764         }
1765     }
1766
1767   if (dt->rec != NULL)
1768     {
1769       if (dt->end != NULL)
1770         {
1771           gfc_error ("REC tag at %L is incompatible with END tag",
1772                      &dt->rec->where);
1773           return FAILURE;
1774         }
1775
1776       if (dt->format_label == &format_asterisk)
1777         {
1778           gfc_error
1779             ("END tag at %L is incompatible with list directed format (*)",
1780              &dt->end_where);
1781           return FAILURE;
1782         }
1783
1784       if (dt->namelist != NULL)
1785         {
1786           gfc_error ("REC tag at %L is incompatible with namelist",
1787                      &dt->rec->where);
1788           return FAILURE;
1789         }
1790     }
1791
1792   if (dt->advance != NULL && dt->format_label == &format_asterisk)
1793     {
1794       gfc_error ("ADVANCE tag at %L is incompatible with list directed "
1795                  "format (*)", &dt->advance->where);
1796       return FAILURE;
1797     }
1798
1799   if (dt->eor != 0 && dt->advance == NULL)
1800     {
1801       gfc_error ("EOR tag at %L requires an ADVANCE tag", &dt->eor_where);
1802       return FAILURE;
1803     }
1804
1805   if (dt->size != NULL && dt->advance == NULL)
1806     {
1807       gfc_error ("SIZE tag at %L requires an ADVANCE tag", &dt->size->where);
1808       return FAILURE;
1809     }
1810
1811   /* TODO: Make sure the ADVANCE tag is 'yes' or 'no' if it is a string
1812      constant.  */
1813
1814   if (gfc_reference_st_label (dt->err, ST_LABEL_TARGET) == FAILURE)
1815     return FAILURE;
1816
1817   if (gfc_reference_st_label (dt->end, ST_LABEL_TARGET) == FAILURE)
1818     return FAILURE;
1819
1820   if (gfc_reference_st_label (dt->eor, ST_LABEL_TARGET) == FAILURE)
1821     return FAILURE;
1822
1823   /* Check the format label actually exists.  */
1824   if (dt->format_label && dt->format_label != &format_asterisk
1825       && dt->format_label->defined == ST_LABEL_UNKNOWN)
1826     {
1827       gfc_error ("FORMAT label %d at %L not defined", dt->format_label->value,
1828                  &dt->format_label->where);
1829       return FAILURE;
1830     }
1831   return SUCCESS;
1832 }
1833
1834
1835 /* Given an io_kind, return its name.  */
1836
1837 static const char *
1838 io_kind_name (io_kind k)
1839 {
1840   const char *name;
1841
1842   switch (k)
1843     {
1844     case M_READ:
1845       name = "READ";
1846       break;
1847     case M_WRITE:
1848       name = "WRITE";
1849       break;
1850     case M_PRINT:
1851       name = "PRINT";
1852       break;
1853     case M_INQUIRE:
1854       name = "INQUIRE";
1855       break;
1856     default:
1857       gfc_internal_error ("io_kind_name(): bad I/O-kind");
1858     }
1859
1860   return name;
1861 }
1862
1863
1864 /* Match an IO iteration statement of the form:
1865
1866    ( [<IO element> ,] <IO element>, I = <expr>, <expr> [, <expr> ] )
1867
1868    which is equivalent to a single IO element.  This function is
1869    mutually recursive with match_io_element().  */
1870
1871 static match match_io_element (io_kind k, gfc_code **);
1872
1873 static match
1874 match_io_iterator (io_kind k, gfc_code ** result)
1875 {
1876   gfc_code *head, *tail, *new;
1877   gfc_iterator *iter;
1878   locus old_loc;
1879   match m;
1880   int n;
1881
1882   iter = NULL;
1883   head = NULL;
1884   old_loc = gfc_current_locus;
1885
1886   if (gfc_match_char ('(') != MATCH_YES)
1887     return MATCH_NO;
1888
1889   m = match_io_element (k, &head);
1890   tail = head;
1891
1892   if (m != MATCH_YES || gfc_match_char (',') != MATCH_YES)
1893     {
1894       m = MATCH_NO;
1895       goto cleanup;
1896     }
1897
1898   /* Can't be anything but an IO iterator.  Build a list.  */
1899   iter = gfc_get_iterator ();
1900
1901   for (n = 1;; n++)
1902     {
1903       m = gfc_match_iterator (iter, 0);
1904       if (m == MATCH_ERROR)
1905         goto cleanup;
1906       if (m == MATCH_YES)
1907         {
1908           gfc_check_do_variable (iter->var->symtree);
1909           break;
1910         }
1911
1912       m = match_io_element (k, &new);
1913       if (m == MATCH_ERROR)
1914         goto cleanup;
1915       if (m == MATCH_NO)
1916         {
1917           if (n > 2)
1918             goto syntax;
1919           goto cleanup;
1920         }
1921
1922       tail = gfc_append_code (tail, new);
1923
1924       if (gfc_match_char (',') != MATCH_YES)
1925         {
1926           if (n > 2)
1927             goto syntax;
1928           m = MATCH_NO;
1929           goto cleanup;
1930         }
1931     }
1932
1933   if (gfc_match_char (')') != MATCH_YES)
1934     goto syntax;
1935
1936   new = gfc_get_code ();
1937   new->op = EXEC_DO;
1938   new->ext.iterator = iter;
1939
1940   new->block = gfc_get_code ();
1941   new->block->op = EXEC_DO;
1942   new->block->next = head;
1943
1944   *result = new;
1945   return MATCH_YES;
1946
1947 syntax:
1948   gfc_error ("Syntax error in I/O iterator at %C");
1949   m = MATCH_ERROR;
1950
1951 cleanup:
1952   gfc_free_iterator (iter, 1);
1953   gfc_free_statements (head);
1954   gfc_current_locus = old_loc;
1955   return m;
1956 }
1957
1958
1959 /* Match a single element of an IO list, which is either a single
1960    expression or an IO Iterator.  */
1961
1962 static match
1963 match_io_element (io_kind k, gfc_code ** cpp)
1964 {
1965   gfc_expr *expr;
1966   gfc_code *cp;
1967   match m;
1968
1969   expr = NULL;
1970
1971   m = match_io_iterator (k, cpp);
1972   if (m == MATCH_YES)
1973     return MATCH_YES;
1974
1975   if (k == M_READ)
1976     {
1977       m = gfc_match_variable (&expr, 0);
1978       if (m == MATCH_NO)
1979         gfc_error ("Expected variable in READ statement at %C");
1980     }
1981   else
1982     {
1983       m = gfc_match_expr (&expr);
1984       if (m == MATCH_NO)
1985         gfc_error ("Expected expression in %s statement at %C",
1986                    io_kind_name (k));
1987     }
1988
1989   if (m == MATCH_YES)
1990     switch (k)
1991       {
1992       case M_READ:
1993         if (expr->symtree->n.sym->attr.intent == INTENT_IN)
1994           {
1995             gfc_error
1996               ("Variable '%s' in input list at %C cannot be INTENT(IN)",
1997                expr->symtree->n.sym->name);
1998             m = MATCH_ERROR;
1999           }
2000
2001         if (gfc_pure (NULL)
2002             && gfc_impure_variable (expr->symtree->n.sym)
2003             && current_dt->io_unit->ts.type == BT_CHARACTER)
2004           {
2005             gfc_error ("Cannot read to variable '%s' in PURE procedure at %C",
2006                        expr->symtree->n.sym->name);
2007             m = MATCH_ERROR;
2008           }
2009
2010         if (gfc_check_do_variable (expr->symtree))
2011           m = MATCH_ERROR;
2012
2013         break;
2014
2015       case M_WRITE:
2016         if (current_dt->io_unit->ts.type == BT_CHARACTER
2017             && gfc_pure (NULL)
2018             && current_dt->io_unit->expr_type == EXPR_VARIABLE
2019             && gfc_impure_variable (current_dt->io_unit->symtree->n.sym))
2020           {
2021             gfc_error
2022               ("Cannot write to internal file unit '%s' at %C inside a "
2023                "PURE procedure", current_dt->io_unit->symtree->n.sym->name);
2024             m = MATCH_ERROR;
2025           }
2026
2027         break;
2028
2029       default:
2030         break;
2031       }
2032
2033   if (m != MATCH_YES)
2034     {
2035       gfc_free_expr (expr);
2036       return MATCH_ERROR;
2037     }
2038
2039   cp = gfc_get_code ();
2040   cp->op = EXEC_TRANSFER;
2041   cp->expr = expr;
2042
2043   *cpp = cp;
2044   return MATCH_YES;
2045 }
2046
2047
2048 /* Match an I/O list, building gfc_code structures as we go.  */
2049
2050 static match
2051 match_io_list (io_kind k, gfc_code ** head_p)
2052 {
2053   gfc_code *head, *tail, *new;
2054   match m;
2055
2056   *head_p = head = tail = NULL;
2057   if (gfc_match_eos () == MATCH_YES)
2058     return MATCH_YES;
2059
2060   for (;;)
2061     {
2062       m = match_io_element (k, &new);
2063       if (m == MATCH_ERROR)
2064         goto cleanup;
2065       if (m == MATCH_NO)
2066         goto syntax;
2067
2068       tail = gfc_append_code (tail, new);
2069       if (head == NULL)
2070         head = new;
2071
2072       if (gfc_match_eos () == MATCH_YES)
2073         break;
2074       if (gfc_match_char (',') != MATCH_YES)
2075         goto syntax;
2076     }
2077
2078   *head_p = head;
2079   return MATCH_YES;
2080
2081 syntax:
2082   gfc_error ("Syntax error in %s statement at %C", io_kind_name (k));
2083
2084 cleanup:
2085   gfc_free_statements (head);
2086   return MATCH_ERROR;
2087 }
2088
2089
2090 /* Attach the data transfer end node.  */
2091
2092 static void
2093 terminate_io (gfc_code * io_code)
2094 {
2095   gfc_code *c;
2096
2097   if (io_code == NULL)
2098     io_code = &new_st;
2099
2100   c = gfc_get_code ();
2101   c->op = EXEC_DT_END;
2102
2103   /* Point to structure that is already there */
2104   c->ext.dt = new_st.ext.dt;
2105   gfc_append_code (io_code, c);
2106 }
2107
2108
2109 /* Match a READ, WRITE or PRINT statement.  */
2110
2111 static match
2112 match_io (io_kind k)
2113 {
2114   char name[GFC_MAX_SYMBOL_LEN + 1];
2115   gfc_code *io_code;
2116   gfc_symbol *sym;
2117   gfc_expr *expr;
2118   int comma_flag, c;
2119   locus where;
2120   gfc_dt *dt;
2121   match m;
2122
2123   comma_flag = 0;
2124   current_dt = dt = gfc_getmem (sizeof (gfc_dt));
2125
2126   if (gfc_match_char ('(') == MATCH_NO)
2127     {
2128       if (k == M_WRITE)
2129         goto syntax;
2130
2131       if (gfc_current_form == FORM_FREE)
2132        {
2133          c = gfc_peek_char();
2134          if (c != ' ' && c != '*' && c != '\'' && c != '"')
2135            {
2136              m = MATCH_NO;
2137              goto cleanup;
2138            }
2139        }
2140
2141       m = match_dt_format (dt);
2142       if (m == MATCH_ERROR)
2143         goto cleanup;
2144       if (m == MATCH_NO)
2145         goto syntax;
2146
2147       comma_flag = 1;
2148       dt->io_unit = default_unit (k);
2149       goto get_io_list;
2150     }
2151
2152   /* Match a control list */
2153   if (match_dt_element (k, dt) == MATCH_YES)
2154     goto next;
2155   if (match_dt_unit (k, dt) != MATCH_YES)
2156     goto loop;
2157
2158   if (gfc_match_char (')') == MATCH_YES)
2159     goto get_io_list;
2160   if (gfc_match_char (',') != MATCH_YES)
2161     goto syntax;
2162
2163   m = match_dt_element (k, dt);
2164   if (m == MATCH_YES)
2165     goto next;
2166   if (m == MATCH_ERROR)
2167     goto cleanup;
2168
2169   m = match_dt_format (dt);
2170   if (m == MATCH_YES)
2171     goto next;
2172   if (m == MATCH_ERROR)
2173     goto cleanup;
2174
2175   where = gfc_current_locus;
2176
2177   if (gfc_match_name (name) == MATCH_YES
2178       && !gfc_find_symbol (name, NULL, 1, &sym)
2179       && sym->attr.flavor == FL_NAMELIST)
2180     {
2181       dt->namelist = sym;
2182       if (k == M_READ && check_namelist (sym))
2183         {
2184           m = MATCH_ERROR;
2185           goto cleanup;
2186         }
2187       goto next;
2188     }
2189
2190   gfc_current_locus = where;
2191
2192   goto loop;                    /* No matches, try regular elements */
2193
2194 next:
2195   if (gfc_match_char (')') == MATCH_YES)
2196     goto get_io_list;
2197   if (gfc_match_char (',') != MATCH_YES)
2198     goto syntax;
2199
2200 loop:
2201   for (;;)
2202     {
2203       m = match_dt_element (k, dt);
2204       if (m == MATCH_NO)
2205         goto syntax;
2206       if (m == MATCH_ERROR)
2207         goto cleanup;
2208
2209       if (gfc_match_char (')') == MATCH_YES)
2210         break;
2211       if (gfc_match_char (',') != MATCH_YES)
2212         goto syntax;
2213     }
2214
2215 get_io_list:
2216   /* Optional leading comma (non-standard).  */
2217   if (!comma_flag
2218       && gfc_match_char (',') == MATCH_YES
2219       && k == M_WRITE
2220       && gfc_notify_std (GFC_STD_GNU, "Extension: Comma before output "
2221                          "item list at %C is an extension") == FAILURE)
2222     return MATCH_ERROR;
2223
2224   io_code = NULL;
2225   if (gfc_match_eos () != MATCH_YES)
2226     {
2227       if (comma_flag && gfc_match_char (',') != MATCH_YES)
2228         {
2229           gfc_error ("Expected comma in I/O list at %C");
2230           m = MATCH_ERROR;
2231           goto cleanup;
2232         }
2233
2234       m = match_io_list (k, &io_code);
2235       if (m == MATCH_ERROR)
2236         goto cleanup;
2237       if (m == MATCH_NO)
2238         goto syntax;
2239     }
2240
2241   /* A full IO statement has been matched.  */
2242   if (dt->io_unit->expr_type == EXPR_VARIABLE
2243       && k == M_WRITE
2244       && dt->io_unit->ts.type == BT_CHARACTER
2245       && dt->io_unit->symtree->n.sym->attr.intent == INTENT_IN)
2246     {
2247       gfc_error ("Internal file '%s' at %L is INTENT(IN)",
2248                  dt->io_unit->symtree->n.sym->name, &dt->io_unit->where);
2249       m = MATCH_ERROR;
2250       goto cleanup;
2251     }
2252
2253   expr = dt->format_expr;
2254
2255   if (expr != NULL && expr->expr_type == EXPR_CONSTANT)
2256     check_format_string (expr);
2257
2258   if (gfc_pure (NULL)
2259       && (k == M_READ || k == M_WRITE)
2260       && dt->io_unit->ts.type != BT_CHARACTER)
2261     {
2262       gfc_error
2263         ("io-unit in %s statement at %C must be an internal file in a "
2264          "PURE procedure", io_kind_name (k));
2265       m = MATCH_ERROR;
2266       goto cleanup;
2267     }
2268
2269   new_st.op = (k == M_READ) ? EXEC_READ : EXEC_WRITE;
2270   new_st.ext.dt = dt;
2271   new_st.next = io_code;
2272
2273   terminate_io (io_code);
2274
2275   return MATCH_YES;
2276
2277 syntax:
2278   gfc_error ("Syntax error in %s statement at %C", io_kind_name (k));
2279   m = MATCH_ERROR;
2280
2281 cleanup:
2282   gfc_free_dt (dt);
2283   return m;
2284 }
2285
2286
2287 match
2288 gfc_match_read (void)
2289 {
2290   return match_io (M_READ);
2291 }
2292
2293 match
2294 gfc_match_write (void)
2295 {
2296   return match_io (M_WRITE);
2297 }
2298
2299 match
2300 gfc_match_print (void)
2301 {
2302   match m;
2303
2304   m = match_io (M_PRINT);
2305   if (m != MATCH_YES)
2306     return m;
2307
2308   if (gfc_pure (NULL))
2309     {
2310       gfc_error ("PRINT statement at %C not allowed within PURE procedure");
2311       return MATCH_ERROR;
2312     }
2313
2314   return MATCH_YES;
2315 }
2316
2317
2318 /* Free a gfc_inquire structure.  */
2319
2320 void
2321 gfc_free_inquire (gfc_inquire * inquire)
2322 {
2323
2324   if (inquire == NULL)
2325     return;
2326
2327   gfc_free_expr (inquire->unit);
2328   gfc_free_expr (inquire->file);
2329   gfc_free_expr (inquire->iostat);
2330   gfc_free_expr (inquire->exist);
2331   gfc_free_expr (inquire->opened);
2332   gfc_free_expr (inquire->number);
2333   gfc_free_expr (inquire->named);
2334   gfc_free_expr (inquire->name);
2335   gfc_free_expr (inquire->access);
2336   gfc_free_expr (inquire->sequential);
2337   gfc_free_expr (inquire->direct);
2338   gfc_free_expr (inquire->form);
2339   gfc_free_expr (inquire->formatted);
2340   gfc_free_expr (inquire->unformatted);
2341   gfc_free_expr (inquire->recl);
2342   gfc_free_expr (inquire->nextrec);
2343   gfc_free_expr (inquire->blank);
2344   gfc_free_expr (inquire->position);
2345   gfc_free_expr (inquire->action);
2346   gfc_free_expr (inquire->read);
2347   gfc_free_expr (inquire->write);
2348   gfc_free_expr (inquire->readwrite);
2349   gfc_free_expr (inquire->delim);
2350   gfc_free_expr (inquire->pad);
2351   gfc_free_expr (inquire->iolength);
2352
2353   gfc_free (inquire);
2354 }
2355
2356
2357 /* Match an element of an INQUIRE statement.  */
2358
2359 #define RETM   if (m != MATCH_NO) return m;
2360
2361 static match
2362 match_inquire_element (gfc_inquire * inquire)
2363 {
2364   match m;
2365
2366   m = match_etag (&tag_unit, &inquire->unit);
2367   RETM m = match_etag (&tag_file, &inquire->file);
2368   RETM m = match_ltag (&tag_err, &inquire->err);
2369   RETM m = match_out_tag (&tag_iostat, &inquire->iostat);
2370   RETM m = match_vtag (&tag_exist, &inquire->exist);
2371   RETM m = match_vtag (&tag_opened, &inquire->opened);
2372   RETM m = match_vtag (&tag_named, &inquire->named);
2373   RETM m = match_vtag (&tag_name, &inquire->name);
2374   RETM m = match_out_tag (&tag_number, &inquire->number);
2375   RETM m = match_vtag (&tag_s_access, &inquire->access);
2376   RETM m = match_vtag (&tag_sequential, &inquire->sequential);
2377   RETM m = match_vtag (&tag_direct, &inquire->direct);
2378   RETM m = match_vtag (&tag_s_form, &inquire->form);
2379   RETM m = match_vtag (&tag_formatted, &inquire->formatted);
2380   RETM m = match_vtag (&tag_unformatted, &inquire->unformatted);
2381   RETM m = match_out_tag (&tag_s_recl, &inquire->recl);
2382   RETM m = match_out_tag (&tag_nextrec, &inquire->nextrec);
2383   RETM m = match_vtag (&tag_s_blank, &inquire->blank);
2384   RETM m = match_vtag (&tag_s_position, &inquire->position);
2385   RETM m = match_vtag (&tag_s_action, &inquire->action);
2386   RETM m = match_vtag (&tag_read, &inquire->read);
2387   RETM m = match_vtag (&tag_write, &inquire->write);
2388   RETM m = match_vtag (&tag_readwrite, &inquire->readwrite);
2389   RETM m = match_vtag (&tag_s_delim, &inquire->delim);
2390   RETM m = match_vtag (&tag_s_pad, &inquire->pad);
2391   RETM m = match_vtag (&tag_iolength, &inquire->iolength);
2392   RETM return MATCH_NO;
2393 }
2394
2395 #undef RETM
2396
2397
2398 match
2399 gfc_match_inquire (void)
2400 {
2401   gfc_inquire *inquire;
2402   gfc_code *code;
2403   match m;
2404   locus loc;
2405
2406   m = gfc_match_char ('(');
2407   if (m == MATCH_NO)
2408     return m;
2409
2410   inquire = gfc_getmem (sizeof (gfc_inquire));
2411
2412   loc = gfc_current_locus;
2413
2414   m = match_inquire_element (inquire);
2415   if (m == MATCH_ERROR)
2416     goto cleanup;
2417   if (m == MATCH_NO)
2418     {
2419       m = gfc_match_expr (&inquire->unit);
2420       if (m == MATCH_ERROR)
2421         goto cleanup;
2422       if (m == MATCH_NO)
2423         goto syntax;
2424     }
2425
2426   /* See if we have the IOLENGTH form of the inquire statement.  */
2427   if (inquire->iolength != NULL)
2428     {
2429       if (gfc_match_char (')') != MATCH_YES)
2430         goto syntax;
2431
2432       m = match_io_list (M_INQUIRE, &code);
2433       if (m == MATCH_ERROR)
2434         goto cleanup;
2435       if (m == MATCH_NO)
2436         goto syntax;
2437
2438       terminate_io (code);
2439
2440       new_st.op = EXEC_IOLENGTH;
2441       new_st.expr = inquire->iolength;
2442       new_st.ext.inquire = inquire;
2443
2444       if (gfc_pure (NULL))
2445         {
2446           gfc_free_statements (code);
2447           gfc_error ("INQUIRE statement not allowed in PURE procedure at %C");
2448           return MATCH_ERROR;
2449         }
2450
2451       new_st.next = code;
2452       return MATCH_YES;
2453     }
2454
2455   /* At this point, we have the non-IOLENGTH inquire statement.  */
2456   for (;;)
2457     {
2458       if (gfc_match_char (')') == MATCH_YES)
2459         break;
2460       if (gfc_match_char (',') != MATCH_YES)
2461         goto syntax;
2462
2463       m = match_inquire_element (inquire);
2464       if (m == MATCH_ERROR)
2465         goto cleanup;
2466       if (m == MATCH_NO)
2467         goto syntax;
2468
2469       if (inquire->iolength != NULL)
2470         {
2471           gfc_error ("IOLENGTH tag invalid in INQUIRE statement at %C");
2472           goto cleanup;
2473         }
2474     }
2475
2476   if (gfc_match_eos () != MATCH_YES)
2477     goto syntax;
2478
2479   if (inquire->unit != NULL && inquire->file != NULL)
2480     {
2481       gfc_error ("INQUIRE statement at %L cannot contain both FILE and"
2482                  " UNIT specifiers", &loc);
2483       goto cleanup;
2484     }
2485
2486   if (inquire->unit == NULL && inquire->file == NULL)
2487     {
2488       gfc_error ("INQUIRE statement at %L requires either FILE or"
2489                      " UNIT specifier", &loc);
2490       goto cleanup;
2491     }
2492
2493   if (gfc_pure (NULL))
2494     {
2495       gfc_error ("INQUIRE statement not allowed in PURE procedure at %C");
2496       goto cleanup;
2497     }
2498
2499   new_st.op = EXEC_INQUIRE;
2500   new_st.ext.inquire = inquire;
2501   return MATCH_YES;
2502
2503 syntax:
2504   gfc_syntax_error (ST_INQUIRE);
2505
2506 cleanup:
2507   gfc_free_inquire (inquire);
2508   return MATCH_ERROR;
2509 }
2510
2511
2512 /* Resolve everything in a gfc_inquire structure.  */
2513
2514 try
2515 gfc_resolve_inquire (gfc_inquire * inquire)
2516 {
2517
2518   RESOLVE_TAG (&tag_unit, inquire->unit);
2519   RESOLVE_TAG (&tag_file, inquire->file);
2520   RESOLVE_TAG (&tag_iostat, inquire->iostat);
2521   RESOLVE_TAG (&tag_exist, inquire->exist);
2522   RESOLVE_TAG (&tag_opened, inquire->opened);
2523   RESOLVE_TAG (&tag_number, inquire->number);
2524   RESOLVE_TAG (&tag_named, inquire->named);
2525   RESOLVE_TAG (&tag_name, inquire->name);
2526   RESOLVE_TAG (&tag_s_access, inquire->access);
2527   RESOLVE_TAG (&tag_sequential, inquire->sequential);
2528   RESOLVE_TAG (&tag_direct, inquire->direct);
2529   RESOLVE_TAG (&tag_s_form, inquire->form);
2530   RESOLVE_TAG (&tag_formatted, inquire->formatted);
2531   RESOLVE_TAG (&tag_unformatted, inquire->unformatted);
2532   RESOLVE_TAG (&tag_s_recl, inquire->recl);
2533   RESOLVE_TAG (&tag_nextrec, inquire->nextrec);
2534   RESOLVE_TAG (&tag_s_blank, inquire->blank);
2535   RESOLVE_TAG (&tag_s_position, inquire->position);
2536   RESOLVE_TAG (&tag_s_action, inquire->action);
2537   RESOLVE_TAG (&tag_read, inquire->read);
2538   RESOLVE_TAG (&tag_write, inquire->write);
2539   RESOLVE_TAG (&tag_readwrite, inquire->readwrite);
2540   RESOLVE_TAG (&tag_s_delim, inquire->delim);
2541   RESOLVE_TAG (&tag_s_pad, inquire->pad);
2542   RESOLVE_TAG (&tag_iolength, inquire->iolength);
2543
2544   if (gfc_reference_st_label (inquire->err, ST_LABEL_TARGET) == FAILURE)
2545     return FAILURE;
2546
2547   return SUCCESS;
2548 }