OSDN Git Service

gcc/fortran:
[pf3gnuchains/gcc-fork.git] / gcc / fortran / gfortran.h
1 /* gfortran header file
2    Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007
3    Free Software Foundation, 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 #ifndef GCC_GFORTRAN_H
24 #define GCC_GFORTRAN_H
25
26 /* It's probably insane to have this large of a header file, but it
27    seemed like everything had to be recompiled anyway when a change
28    was made to a header file, and there were ordering issues with
29    multiple header files.  Besides, Microsoft's winnt.h was 250k last
30    time I looked, so by comparison this is perfectly reasonable.  */
31
32 #include "system.h"
33 #include "intl.h"
34 #include "coretypes.h"
35 #include "input.h"
36 #include "splay-tree.h"
37 /* The following ifdefs are recommended by the autoconf documentation
38    for any code using alloca.  */
39
40 /* AIX requires this to be the first thing in the file.  */
41 #ifdef __GNUC__
42 #else /* not __GNUC__ */
43 #ifdef HAVE_ALLOCA_H
44 #include <alloca.h>
45 #else /* do not HAVE_ALLOCA_H */
46 #ifdef _AIX
47 #pragma alloca
48 #else
49 #ifndef alloca                  /* predefined by HP cc +Olibcalls */
50 char *alloca ();
51 #endif /* not predefined */
52 #endif /* not _AIX */
53 #endif /* do not HAVE_ALLOCA_H */
54 #endif /* not __GNUC__ */
55
56 /* Major control parameters.  */
57
58 #define GFC_MAX_SYMBOL_LEN 63   /* Must be at least 63 for F2003.  */
59 #define GFC_MAX_BINDING_LABEL_LEN 126 /* (2 * GFC_MAX_SYMBOL_LEN) */
60 #define GFC_MAX_LINE 132        /* Characters beyond this are not seen.  */
61 #define GFC_MAX_DIMENSIONS 7    /* Maximum dimensions in an array.  */
62 #define GFC_LETTERS 26          /* Number of letters in the alphabet.  */
63
64 #define MAX_SUBRECORD_LENGTH 2147483639   /* 2**31-9 */
65
66
67 #define free(x) Use_gfc_free_instead_of_free()
68 #define gfc_is_whitespace(c) ((c==' ') || (c=='\t'))
69
70 #ifndef NULL
71 #define NULL ((void *) 0)
72 #endif
73
74 /* Stringization.  */
75 #define stringize(x) expand_macro(x)
76 #define expand_macro(x) # x
77
78 /* For a the runtime library, a standard prefix is a requirement to
79    avoid cluttering the namespace with things nobody asked for.  It's
80    ugly to look at and a pain to type when you add the prefix by hand,
81    so we hide it behind a macro.  */
82 #define PREFIX(x) "_gfortran_" x
83 #define PREFIX_LEN 10
84
85 #define BLANK_COMMON_NAME "__BLNK__"
86
87 /* Macro to initialize an mstring structure.  */
88 #define minit(s, t) { s, NULL, t }
89
90 /* Structure for storing strings to be matched by gfc_match_string.  */
91 typedef struct
92 {
93   const char *string;
94   const char *mp;
95   int tag;
96 }
97 mstring;
98
99
100 /* Flags to specify which standard/extension contains a feature.  */
101 #define GFC_STD_LEGACY          (1<<6) /* Backward compatibility.  */
102 #define GFC_STD_GNU             (1<<5)    /* GNU Fortran extension.  */
103 #define GFC_STD_F2003           (1<<4)    /* New in F2003.  */
104 /* Note that no additional features were deleted or made obsolescent
105    in F2003.  */
106 #define GFC_STD_F95             (1<<3)    /* New in F95.  */
107 #define GFC_STD_F95_DEL         (1<<2)    /* Deleted in F95.  */
108 #define GFC_STD_F95_OBS         (1<<1)    /* Obsolescent in F95.  */
109 #define GFC_STD_F77             (1<<0)    /* Included in F77, but not
110                                              deleted or obsolescent in
111                                              later standards.  */
112
113 /* Bitmasks for the various FPE that can be enabled.  */
114 #define GFC_FPE_INVALID    (1<<0)
115 #define GFC_FPE_DENORMAL   (1<<1)
116 #define GFC_FPE_ZERO       (1<<2)
117 #define GFC_FPE_OVERFLOW   (1<<3)
118 #define GFC_FPE_UNDERFLOW  (1<<4)
119 #define GFC_FPE_PRECISION  (1<<5)
120
121 /* Keep this in sync with libgfortran/io/io.h ! */
122
123 typedef enum
124   { CONVERT_NATIVE=0, CONVERT_SWAP, CONVERT_BIG, CONVERT_LITTLE }
125 options_convert;
126
127
128 /*************************** Enums *****************************/
129
130 /* The author remains confused to this day about the convention of
131    returning '0' for 'SUCCESS'... or was it the other way around?  The
132    following enum makes things much more readable.  We also start
133    values off at one instead of zero.  */
134
135 typedef enum
136 { SUCCESS = 1, FAILURE }
137 try;
138
139 /* This is returned by gfc_notification_std to know if, given the flags
140    that were given (-std=, -pedantic) we should issue an error, a warning
141    or nothing.  */
142
143 typedef enum
144 { SILENT, WARNING, ERROR }
145 notification;
146
147 /* Matchers return one of these three values.  The difference between
148    MATCH_NO and MATCH_ERROR is that MATCH_ERROR means that a match was
149    successful, but that something non-syntactic is wrong and an error
150    has already been issued.  */
151
152 typedef enum
153 { MATCH_NO = 1, MATCH_YES, MATCH_ERROR }
154 match;
155
156 typedef enum
157 { FORM_FREE, FORM_FIXED, FORM_UNKNOWN }
158 gfc_source_form;
159
160 /* Basic types.  BT_VOID is used by ISO C BInding so funcs like c_f_pointer
161    can take any arg with the pointer attribute as a param.  */
162 typedef enum
163 { BT_UNKNOWN = 1, BT_INTEGER, BT_REAL, BT_COMPLEX,
164   BT_LOGICAL, BT_CHARACTER, BT_DERIVED, BT_PROCEDURE, BT_HOLLERITH,
165   BT_VOID
166 }
167 bt;
168
169 /* Expression node types.  */
170 typedef enum
171 { EXPR_OP = 1, EXPR_FUNCTION, EXPR_CONSTANT, EXPR_VARIABLE,
172   EXPR_SUBSTRING, EXPR_STRUCTURE, EXPR_ARRAY, EXPR_NULL
173 }
174 expr_t;
175
176 /* Array types.  */
177 typedef enum
178 { AS_EXPLICIT = 1, AS_ASSUMED_SHAPE, AS_DEFERRED,
179   AS_ASSUMED_SIZE, AS_UNKNOWN
180 }
181 array_type;
182
183 typedef enum
184 { AR_FULL = 1, AR_ELEMENT, AR_SECTION, AR_UNKNOWN }
185 ar_type;
186
187 /* Statement label types.  */
188 typedef enum
189 { ST_LABEL_UNKNOWN = 1, ST_LABEL_TARGET,
190   ST_LABEL_BAD_TARGET, ST_LABEL_FORMAT
191 }
192 gfc_sl_type;
193
194 /* Intrinsic operators.  */
195 typedef enum
196 { GFC_INTRINSIC_BEGIN = 0,
197   INTRINSIC_NONE = -1, INTRINSIC_UPLUS = GFC_INTRINSIC_BEGIN,
198   INTRINSIC_UMINUS, INTRINSIC_PLUS, INTRINSIC_MINUS, INTRINSIC_TIMES,
199   INTRINSIC_DIVIDE, INTRINSIC_POWER, INTRINSIC_CONCAT,
200   INTRINSIC_AND, INTRINSIC_OR, INTRINSIC_EQV, INTRINSIC_NEQV,
201   INTRINSIC_EQ, INTRINSIC_NE, INTRINSIC_GT, INTRINSIC_GE,
202   INTRINSIC_LT, INTRINSIC_LE, INTRINSIC_NOT, INTRINSIC_USER,
203   INTRINSIC_ASSIGN, INTRINSIC_PARENTHESES,
204   GFC_INTRINSIC_END /* Sentinel */
205 }
206 gfc_intrinsic_op;
207
208
209 /* Strings for all intrinsic operators.  */
210 extern mstring intrinsic_operators[];
211
212
213 /* This macro is the number of intrinsic operators that exist.
214    Assumptions are made about the numbering of the interface_op enums.  */
215 #define GFC_INTRINSIC_OPS GFC_INTRINSIC_END
216
217 /* Arithmetic results.  */
218 typedef enum
219 { ARITH_OK = 1, ARITH_OVERFLOW, ARITH_UNDERFLOW, ARITH_NAN,
220   ARITH_DIV0, ARITH_INCOMMENSURATE, ARITH_ASYMMETRIC
221 }
222 arith;
223
224 /* Statements.  */
225 typedef enum
226 {
227   ST_ARITHMETIC_IF, ST_ALLOCATE, ST_ATTR_DECL, ST_BACKSPACE, ST_BLOCK_DATA,
228   ST_CALL, ST_CASE, ST_CLOSE, ST_COMMON, ST_CONTINUE, ST_CONTAINS, ST_CYCLE,
229   ST_DATA, ST_DATA_DECL, ST_DEALLOCATE, ST_DO, ST_ELSE, ST_ELSEIF,
230   ST_ELSEWHERE, ST_END_BLOCK_DATA, ST_ENDDO, ST_IMPLIED_ENDDO,
231   ST_END_FILE, ST_FLUSH, ST_END_FORALL, ST_END_FUNCTION, ST_ENDIF,
232   ST_END_INTERFACE, ST_END_MODULE, ST_END_PROGRAM, ST_END_SELECT,
233   ST_END_SUBROUTINE, ST_END_WHERE, ST_END_TYPE, ST_ENTRY, ST_EQUIVALENCE,
234   ST_EXIT, ST_FORALL, ST_FORALL_BLOCK, ST_FORMAT, ST_FUNCTION, ST_GOTO,
235   ST_IF_BLOCK, ST_IMPLICIT, ST_IMPLICIT_NONE, ST_IMPORT, ST_INQUIRE, ST_INTERFACE,
236   ST_PARAMETER, ST_MODULE, ST_MODULE_PROC, ST_NAMELIST, ST_NULLIFY, ST_OPEN,
237   ST_PAUSE, ST_PRIVATE, ST_PROGRAM, ST_PUBLIC, ST_READ, ST_RETURN, ST_REWIND,
238   ST_STOP, ST_SUBROUTINE, ST_TYPE, ST_USE, ST_WHERE_BLOCK, ST_WHERE, ST_WRITE,
239   ST_ASSIGNMENT, ST_POINTER_ASSIGNMENT, ST_SELECT_CASE, ST_SEQUENCE,
240   ST_SIMPLE_IF, ST_STATEMENT_FUNCTION, ST_DERIVED_DECL, ST_LABEL_ASSIGNMENT,
241   ST_ENUM, ST_ENUMERATOR, ST_END_ENUM,
242   ST_OMP_ATOMIC, ST_OMP_BARRIER, ST_OMP_CRITICAL, ST_OMP_END_CRITICAL,
243   ST_OMP_END_DO, ST_OMP_END_MASTER, ST_OMP_END_ORDERED, ST_OMP_END_PARALLEL,
244   ST_OMP_END_PARALLEL_DO, ST_OMP_END_PARALLEL_SECTIONS,
245   ST_OMP_END_PARALLEL_WORKSHARE, ST_OMP_END_SECTIONS, ST_OMP_END_SINGLE,
246   ST_OMP_END_WORKSHARE, ST_OMP_DO, ST_OMP_FLUSH, ST_OMP_MASTER, ST_OMP_ORDERED,
247   ST_OMP_PARALLEL, ST_OMP_PARALLEL_DO, ST_OMP_PARALLEL_SECTIONS,
248   ST_OMP_PARALLEL_WORKSHARE, ST_OMP_SECTIONS, ST_OMP_SECTION, ST_OMP_SINGLE,
249   ST_OMP_THREADPRIVATE, ST_OMP_WORKSHARE,
250   ST_NONE
251 }
252 gfc_statement;
253
254
255 /* Types of interfaces that we can have.  Assignment interfaces are
256    considered to be intrinsic operators.  */
257 typedef enum
258 {
259   INTERFACE_NAMELESS = 1, INTERFACE_GENERIC,
260   INTERFACE_INTRINSIC_OP, INTERFACE_USER_OP
261 }
262 interface_type;
263
264 /* Symbol flavors: these are all mutually exclusive.
265    10 elements = 4 bits.  */
266 typedef enum sym_flavor
267 {
268   FL_UNKNOWN = 0, FL_PROGRAM, FL_BLOCK_DATA, FL_MODULE, FL_VARIABLE,
269   FL_PARAMETER, FL_LABEL, FL_PROCEDURE, FL_DERIVED, FL_NAMELIST,
270   FL_VOID
271 }
272 sym_flavor;
273
274 /* Procedure types.  7 elements = 3 bits.  */
275 typedef enum procedure_type
276 { PROC_UNKNOWN, PROC_MODULE, PROC_INTERNAL, PROC_DUMMY,
277   PROC_INTRINSIC, PROC_ST_FUNCTION, PROC_EXTERNAL
278 }
279 procedure_type;
280
281 /* Intent types.  */
282 typedef enum sym_intent
283 { INTENT_UNKNOWN = 0, INTENT_IN, INTENT_OUT, INTENT_INOUT
284 }
285 sym_intent;
286
287 /* Access types.  */
288 typedef enum gfc_access
289 { ACCESS_UNKNOWN = 0, ACCESS_PUBLIC, ACCESS_PRIVATE
290 }
291 gfc_access;
292
293 /* Flags to keep track of where an interface came from.
294    4 elements = 2 bits.  */
295 typedef enum ifsrc
296 { IFSRC_UNKNOWN = 0, IFSRC_DECL, IFSRC_IFBODY, IFSRC_USAGE
297 }
298 ifsrc;
299
300 /* Whether a SAVE attribute was set explicitly or implictly.  */
301 typedef enum save_state
302 { SAVE_NONE = 0, SAVE_EXPLICIT, SAVE_IMPLICIT
303 }
304 save_state;
305
306 /* Strings for all symbol attributes.  We use these for dumping the
307    parse tree, in error messages, and also when reading and writing
308    modules.  In symbol.c.  */
309 extern const mstring flavors[];
310 extern const mstring procedures[];
311 extern const mstring intents[];
312 extern const mstring access_types[];
313 extern const mstring ifsrc_types[];
314 extern const mstring save_status[];
315
316 /* Enumeration of all the generic intrinsic functions.  Used by the
317    backend for identification of a function.  */
318
319 enum gfc_isym_id
320 {
321   /* GFC_ISYM_NONE is used for intrinsics which will never be seen by
322      the backend (eg. KIND).  */
323   GFC_ISYM_NONE = 0,
324   GFC_ISYM_ABORT,
325   GFC_ISYM_ABS,
326   GFC_ISYM_ACCESS,
327   GFC_ISYM_ACHAR,
328   GFC_ISYM_ACOS,
329   GFC_ISYM_ACOSH,
330   GFC_ISYM_ADJUSTL,
331   GFC_ISYM_ADJUSTR,
332   GFC_ISYM_AIMAG,
333   GFC_ISYM_AINT,
334   GFC_ISYM_ALARM,
335   GFC_ISYM_ALL,
336   GFC_ISYM_ALLOCATED,
337   GFC_ISYM_AND,
338   GFC_ISYM_ANINT,
339   GFC_ISYM_ANY,
340   GFC_ISYM_ASIN,
341   GFC_ISYM_ASINH,
342   GFC_ISYM_ASSOCIATED,
343   GFC_ISYM_ATAN,
344   GFC_ISYM_ATAN2,
345   GFC_ISYM_ATANH,
346   GFC_ISYM_BIT_SIZE,
347   GFC_ISYM_BTEST,
348   GFC_ISYM_CEILING,
349   GFC_ISYM_CHAR,
350   GFC_ISYM_CHDIR,
351   GFC_ISYM_CHMOD,
352   GFC_ISYM_CMPLX,
353   GFC_ISYM_COMMAND_ARGUMENT_COUNT,
354   GFC_ISYM_COMPLEX,
355   GFC_ISYM_CONJG,
356   GFC_ISYM_CONVERSION,
357   GFC_ISYM_COS,
358   GFC_ISYM_COSH,
359   GFC_ISYM_COUNT,
360   GFC_ISYM_CPU_TIME,
361   GFC_ISYM_CSHIFT,
362   GFC_ISYM_CTIME,
363   GFC_ISYM_DATE_AND_TIME,
364   GFC_ISYM_DBLE,
365   GFC_ISYM_DIGITS,
366   GFC_ISYM_DIM,
367   GFC_ISYM_DOT_PRODUCT,
368   GFC_ISYM_DPROD,
369   GFC_ISYM_DTIME,
370   GFC_ISYM_EOSHIFT,
371   GFC_ISYM_EPSILON,
372   GFC_ISYM_ERF,
373   GFC_ISYM_ERFC,
374   GFC_ISYM_ETIME,
375   GFC_ISYM_EXIT,
376   GFC_ISYM_EXP,
377   GFC_ISYM_EXPONENT,
378   GFC_ISYM_FDATE,
379   GFC_ISYM_FGET,
380   GFC_ISYM_FGETC,
381   GFC_ISYM_FLOOR,
382   GFC_ISYM_FLUSH,
383   GFC_ISYM_FNUM,
384   GFC_ISYM_FPUT,
385   GFC_ISYM_FPUTC,
386   GFC_ISYM_FRACTION,
387   GFC_ISYM_FREE,
388   GFC_ISYM_FSEEK,
389   GFC_ISYM_FSTAT,
390   GFC_ISYM_FTELL,
391   GFC_ISYM_GERROR,
392   GFC_ISYM_GETARG,
393   GFC_ISYM_GET_COMMAND,
394   GFC_ISYM_GET_COMMAND_ARGUMENT,
395   GFC_ISYM_GETCWD,
396   GFC_ISYM_GETENV,
397   GFC_ISYM_GET_ENVIRONMENT_VARIABLE,
398   GFC_ISYM_GETGID,
399   GFC_ISYM_GETLOG,
400   GFC_ISYM_GETPID,
401   GFC_ISYM_GETUID,
402   GFC_ISYM_GMTIME,
403   GFC_ISYM_HOSTNM,
404   GFC_ISYM_HUGE,
405   GFC_ISYM_IACHAR,
406   GFC_ISYM_IAND,
407   GFC_ISYM_IARGC,
408   GFC_ISYM_IBCLR,
409   GFC_ISYM_IBITS,
410   GFC_ISYM_IBSET,
411   GFC_ISYM_ICHAR,
412   GFC_ISYM_IDATE,
413   GFC_ISYM_IEOR,
414   GFC_ISYM_IERRNO,
415   GFC_ISYM_INDEX,
416   GFC_ISYM_INT,
417   GFC_ISYM_INT2,
418   GFC_ISYM_INT8,
419   GFC_ISYM_IOR,
420   GFC_ISYM_IRAND,
421   GFC_ISYM_ISATTY,
422   GFC_ISYM_ISHFT,
423   GFC_ISYM_ISHFTC,
424   GFC_ISYM_ITIME,
425   GFC_ISYM_J0,
426   GFC_ISYM_J1,
427   GFC_ISYM_JN,
428   GFC_ISYM_KILL,
429   GFC_ISYM_KIND,
430   GFC_ISYM_LBOUND,
431   GFC_ISYM_LEN,
432   GFC_ISYM_LEN_TRIM,
433   GFC_ISYM_LGE,
434   GFC_ISYM_LGT,
435   GFC_ISYM_LINK,
436   GFC_ISYM_LLE,
437   GFC_ISYM_LLT,
438   GFC_ISYM_LOC,
439   GFC_ISYM_LOG,
440   GFC_ISYM_LOG10,
441   GFC_ISYM_LOGICAL,
442   GFC_ISYM_LONG,
443   GFC_ISYM_LSHIFT,
444   GFC_ISYM_LSTAT,
445   GFC_ISYM_LTIME,
446   GFC_ISYM_MALLOC,
447   GFC_ISYM_MATMUL,
448   GFC_ISYM_MAX,
449   GFC_ISYM_MAXEXPONENT,
450   GFC_ISYM_MAXLOC,
451   GFC_ISYM_MAXVAL,
452   GFC_ISYM_MCLOCK,
453   GFC_ISYM_MCLOCK8,
454   GFC_ISYM_MERGE,
455   GFC_ISYM_MIN,
456   GFC_ISYM_MINEXPONENT,
457   GFC_ISYM_MINLOC,
458   GFC_ISYM_MINVAL,
459   GFC_ISYM_MOD,
460   GFC_ISYM_MODULO,
461   GFC_ISYM_MOVE_ALLOC,
462   GFC_ISYM_MVBITS,
463   GFC_ISYM_NEAREST,
464   GFC_ISYM_NEW_LINE,
465   GFC_ISYM_NINT,
466   GFC_ISYM_NOT,
467   GFC_ISYM_NULL,
468   GFC_ISYM_OR,
469   GFC_ISYM_PACK,
470   GFC_ISYM_PERROR,
471   GFC_ISYM_PRECISION,
472   GFC_ISYM_PRESENT,
473   GFC_ISYM_PRODUCT,
474   GFC_ISYM_RADIX,
475   GFC_ISYM_RAND,
476   GFC_ISYM_RANDOM_NUMBER,
477   GFC_ISYM_RANDOM_SEED,
478   GFC_ISYM_RANGE,
479   GFC_ISYM_REAL,
480   GFC_ISYM_RENAME,
481   GFC_ISYM_REPEAT,
482   GFC_ISYM_RESHAPE,
483   GFC_ISYM_RRSPACING,
484   GFC_ISYM_RSHIFT,
485   GFC_ISYM_SCALE,
486   GFC_ISYM_SCAN,
487   GFC_ISYM_SECNDS,
488   GFC_ISYM_SECOND,
489   GFC_ISYM_SET_EXPONENT,
490   GFC_ISYM_SHAPE,
491   GFC_ISYM_SIGN,
492   GFC_ISYM_SIGNAL,
493   GFC_ISYM_SI_KIND,
494   GFC_ISYM_SIN,
495   GFC_ISYM_SINH,
496   GFC_ISYM_SIZE,
497   GFC_ISYM_SLEEP,
498   GFC_ISYM_SIZEOF,
499   GFC_ISYM_SPACING,
500   GFC_ISYM_SPREAD,
501   GFC_ISYM_SQRT,
502   GFC_ISYM_SRAND,
503   GFC_ISYM_SR_KIND,
504   GFC_ISYM_STAT,
505   GFC_ISYM_SUM,
506   GFC_ISYM_SYMLINK,
507   GFC_ISYM_SYMLNK,
508   GFC_ISYM_SYSTEM,
509   GFC_ISYM_SYSTEM_CLOCK,
510   GFC_ISYM_TAN,
511   GFC_ISYM_TANH,
512   GFC_ISYM_TIME,
513   GFC_ISYM_TIME8,
514   GFC_ISYM_TINY,
515   GFC_ISYM_TRANSFER,
516   GFC_ISYM_TRANSPOSE,
517   GFC_ISYM_TRIM,
518   GFC_ISYM_TTYNAM,
519   GFC_ISYM_UBOUND,
520   GFC_ISYM_UMASK,
521   GFC_ISYM_UNLINK,
522   GFC_ISYM_UNPACK,
523   GFC_ISYM_VERIFY,
524   GFC_ISYM_XOR,
525   GFC_ISYM_Y0,
526   GFC_ISYM_Y1,
527   GFC_ISYM_YN
528 };
529 typedef enum gfc_isym_id gfc_isym_id;
530
531 /* Runtime errors.  The EOR and EOF errors are required to be negative.
532    These codes must be kept synchronized with their equivalents in
533    libgfortran/libgfortran.h .  */
534
535 typedef enum
536 {
537   IOERROR_FIRST = -3,           /* Marker for the first error.  */
538   IOERROR_EOR = -2,
539   IOERROR_END = -1,
540   IOERROR_OK = 0,                       /* Indicates success, must be zero.  */
541   IOERROR_OS = 5000,            /* Operating system error, more info in errno.  */
542   IOERROR_OPTION_CONFLICT,
543   IOERROR_BAD_OPTION,
544   IOERROR_MISSING_OPTION,
545   IOERROR_ALREADY_OPEN,
546   IOERROR_BAD_UNIT,
547   IOERROR_FORMAT,
548   IOERROR_BAD_ACTION,
549   IOERROR_ENDFILE,
550   IOERROR_BAD_US,
551   IOERROR_READ_VALUE,
552   IOERROR_READ_OVERFLOW,
553   IOERROR_INTERNAL,
554   IOERROR_INTERNAL_UNIT,
555   IOERROR_ALLOCATION,
556   IOERROR_DIRECT_EOR,
557   IOERROR_SHORT_RECORD,
558   IOERROR_CORRUPT_FILE,
559   IOERROR_LAST                  /* Not a real error, the last error # + 1.  */
560 }
561 ioerror_codes;
562
563
564 /************************* Structures *****************************/
565
566 /* Used for keeping things in balanced binary trees.  */
567 #define BBT_HEADER(self) int priority; struct self *left, *right
568
569 #define NAMED_INTCST(a,b,c) a,
570 typedef enum
571 {
572   ISOFORTRANENV_INVALID = -1,
573 #include "iso-fortran-env.def"
574   ISOFORTRANENV_LAST, ISOFORTRANENV_NUMBER = ISOFORTRANENV_LAST
575 }
576 iso_fortran_env_symbol;
577 #undef NAMED_INTCST
578
579 #define NAMED_INTCST(a,b,c) a,
580 #define NAMED_REALCST(a,b,c) a,
581 #define NAMED_CMPXCST(a,b,c) a,
582 #define NAMED_LOGCST(a,b,c) a,
583 #define NAMED_CHARKNDCST(a,b,c) a,
584 #define NAMED_CHARCST(a,b,c) a,
585 #define DERIVED_TYPE(a,b,c) a,
586 #define PROCEDURE(a,b) a,
587 typedef enum
588 {
589   ISOCBINDING_INVALID = -1, 
590 #include "iso-c-binding.def"
591   ISOCBINDING_LAST,
592   ISOCBINDING_NUMBER = ISOCBINDING_LAST
593 }
594 iso_c_binding_symbol;
595 #undef NAMED_INTCST
596 #undef NAMED_REALCST
597 #undef NAMED_CMPXCST
598 #undef NAMED_LOGCST
599 #undef NAMED_CHARKNDCST
600 #undef NAMED_CHARCST
601 #undef DERIVED_TYPE
602 #undef PROCEDURE
603
604 typedef enum
605 {
606   INTMOD_NONE = 0, INTMOD_ISO_FORTRAN_ENV, INTMOD_ISO_C_BINDING
607 }
608 intmod_id;
609
610 typedef struct
611 {
612   char name[GFC_MAX_SYMBOL_LEN + 1];
613   int value;  /* Used for both integer and character values.  */
614   bt f90_type;
615 }
616 CInteropKind_t;
617
618 /* Array of structs, where the structs represent the C interop kinds.
619    The list will be implemented based on a hash of the kind name since
620    these could be accessed multiple times.
621    Declared in trans-types.c as a global, since it's in that file
622    that the list is initialized.  */
623 extern CInteropKind_t c_interop_kinds_table[];
624
625 /* Symbol attribute structure.  */
626 typedef struct
627 {
628   /* Variable attributes.  */
629   unsigned allocatable:1, dimension:1, external:1, intrinsic:1,
630     optional:1, pointer:1, target:1, value:1, volatile_:1,
631     dummy:1, result:1, assign:1, threadprivate:1, not_always_present:1,
632     implied_index:1;
633
634   ENUM_BITFIELD (save_state) save:2;
635
636   unsigned data:1,              /* Symbol is named in a DATA statement.  */
637     protected:1,                /* Symbol has been marked as protected.  */
638     use_assoc:1,                /* Symbol has been use-associated.  */
639     use_only:1;                 /* Symbol has been use-associated, with ONLY.  */
640
641   unsigned in_namelist:1, in_common:1, in_equivalence:1;
642   unsigned function:1, subroutine:1, generic:1, generic_copy:1;
643   unsigned implicit_type:1;     /* Type defined via implicit rules.  */
644   unsigned untyped:1;           /* No implicit type could be found.  */
645
646   unsigned is_bind_c:1;         /* say if is bound to C */
647
648   /* These flags are both in the typespec and attribute.  The attribute
649      list is what gets read from/written to a module file.  The typespec
650      is created from a decl being processed.  */
651   unsigned is_c_interop:1;      /* It's c interoperable.  */
652   unsigned is_iso_c:1;          /* Symbol is from iso_c_binding.  */
653
654   /* Function/subroutine attributes */
655   unsigned sequence:1, elemental:1, pure:1, recursive:1;
656   unsigned unmaskable:1, masked:1, contained:1, mod_proc:1;
657
658   /* This is set if the subroutine doesn't return.  Currently, this
659      is only possible for intrinsic subroutines.  */
660   unsigned noreturn:1;
661
662   /* Set if this procedure is an alternate entry point.  These procedures
663      don't have any code associated, and the backend will turn them into
664      thunks to the master function.  */
665   unsigned entry:1;
666
667   /* Set if this is the master function for a procedure with multiple
668      entry points.  */
669   unsigned entry_master:1;
670
671   /* Set if this is the master function for a function with multiple
672      entry points where characteristics of the entry points differ.  */
673   unsigned mixed_entry_master:1;
674
675   /* Set if a function must always be referenced by an explicit interface.  */
676   unsigned always_explicit:1;
677
678   /* Set if the symbol has been referenced in an expression.  No further
679      modification of type or type parameters is permitted.  */
680   unsigned referenced:1;
681
682   /* Set if the symbol has ambiguous interfaces.  */
683   unsigned ambiguous_interfaces:1;
684
685   /* Set if the is the symbol for the main program.  This is the least
686      cumbersome way to communicate this function property without
687      strcmp'ing with __MAIN everywhere.  */
688   unsigned is_main_program:1;
689
690   /* Mutually exclusive multibit attributes.  */
691   ENUM_BITFIELD (gfc_access) access:2;
692   ENUM_BITFIELD (sym_intent) intent:2;
693   ENUM_BITFIELD (sym_flavor) flavor:4;
694   ENUM_BITFIELD (ifsrc) if_source:2;
695
696   ENUM_BITFIELD (procedure_type) proc:3;
697
698   /* Special attributes for Cray pointers, pointees.  */
699   unsigned cray_pointer:1, cray_pointee:1;
700
701   /* The symbol is a derived type with allocatable components, possibly
702      nested.  */
703   unsigned alloc_comp:1;
704
705   /* The namespace where the VOLATILE attribute has been set.  */
706   struct gfc_namespace *volatile_ns;
707 }
708 symbol_attribute;
709
710
711 /* The following three structures are used to identify a location in
712    the sources.
713
714    gfc_file is used to maintain a tree of the source files and how
715    they include each other
716
717    gfc_linebuf holds a single line of source code and information
718    which file it resides in
719
720    locus point to the sourceline and the character in the source
721    line.
722 */
723
724 typedef struct gfc_file
725 {
726   struct gfc_file *included_by, *next, *up;
727   int inclusion_line, line;
728   char *filename;
729 } gfc_file;
730
731 typedef struct gfc_linebuf
732 {
733 #ifdef USE_MAPPED_LOCATION
734   source_location location;
735 #else
736   int linenum;
737 #endif
738   struct gfc_file *file;
739   struct gfc_linebuf *next;
740
741   int truncated;
742
743   char line[1];
744 } gfc_linebuf;
745
746 #define gfc_linebuf_header_size (offsetof (gfc_linebuf, line))
747
748 typedef struct
749 {
750   char *nextc;
751   gfc_linebuf *lb;
752 } locus;
753
754 /* In order for the "gfc" format checking to work correctly, you must
755    have declared a typedef locus first.  */
756 #if GCC_VERSION >= 4001
757 #define ATTRIBUTE_GCC_GFC(m, n) __attribute__ ((__format__ (__gcc_gfc__, m, n))) ATTRIBUTE_NONNULL(m)
758 #else
759 #define ATTRIBUTE_GCC_GFC(m, n) ATTRIBUTE_NONNULL(m)
760 #endif
761
762
763 extern int gfc_suppress_error;
764
765
766 /* Character length structures hold the expression that gives the
767    length of a character variable.  We avoid putting these into
768    gfc_typespec because doing so prevents us from doing structure
769    copies and forces us to deallocate any typespecs we create, as well
770    as structures that contain typespecs.  They also can have multiple
771    character typespecs pointing to them.
772
773    These structures form a singly linked list within the current
774    namespace and are deallocated with the namespace.  It is possible to
775    end up with gfc_charlen structures that have nothing pointing to them.  */
776
777 typedef struct gfc_charlen
778 {
779   struct gfc_expr *length;
780   struct gfc_charlen *next;
781   tree backend_decl;
782
783   int resolved;
784 }
785 gfc_charlen;
786
787 #define gfc_get_charlen() gfc_getmem(sizeof(gfc_charlen))
788
789 /* Type specification structure.  FIXME: derived and cl could be union???  */
790 typedef struct
791 {
792   bt type;
793   int kind;
794   struct gfc_symbol *derived;
795   gfc_charlen *cl;      /* For character types only.  */
796   int is_c_interop;
797   int is_iso_c;
798   bt f90_type; 
799 }
800 gfc_typespec;
801
802 /* Array specification.  */
803 typedef struct
804 {
805   int rank;     /* A rank of zero means that a variable is a scalar.  */
806   array_type type;
807   struct gfc_expr *lower[GFC_MAX_DIMENSIONS], *upper[GFC_MAX_DIMENSIONS];
808
809   /* These two fields are used with the Cray Pointer extension.  */
810   bool cray_pointee; /* True iff this spec belongs to a cray pointee.  */
811   bool cp_was_assumed; /* AS_ASSUMED_SIZE cp arrays are converted to
812                         AS_EXPLICIT, but we want to remember that we
813                         did this.  */
814
815 }
816 gfc_array_spec;
817
818 #define gfc_get_array_spec() gfc_getmem(sizeof(gfc_array_spec))
819
820
821 /* Components of derived types.  */
822 typedef struct gfc_component
823 {
824   const char *name;
825   gfc_typespec ts;
826
827   int pointer, allocatable, dimension;
828   gfc_access access;
829   gfc_array_spec *as;
830
831   tree backend_decl;
832   locus loc;
833   struct gfc_expr *initializer;
834   struct gfc_component *next;
835 }
836 gfc_component;
837
838 #define gfc_get_component() gfc_getmem(sizeof(gfc_component))
839
840 /* Formal argument lists are lists of symbols.  */
841 typedef struct gfc_formal_arglist
842 {
843   /* Symbol representing the argument at this position in the arglist.  */
844   struct gfc_symbol *sym;
845   /* Points to the next formal argument.  */
846   struct gfc_formal_arglist *next;
847 }
848 gfc_formal_arglist;
849
850 #define gfc_get_formal_arglist() gfc_getmem(sizeof(gfc_formal_arglist))
851
852
853 /* The gfc_actual_arglist structure is for actual arguments.  */
854 typedef struct gfc_actual_arglist
855 {
856   const char *name;
857   /* Alternate return label when the expr member is null.  */
858   struct gfc_st_label *label;
859
860   /* This is set to the type of an eventual omitted optional
861      argument. This is used to determine if a hidden string length
862      argument has to be added to a function call.  */
863   bt missing_arg_type;
864
865   struct gfc_expr *expr;
866   struct gfc_actual_arglist *next;
867 }
868 gfc_actual_arglist;
869
870 #define gfc_get_actual_arglist() gfc_getmem(sizeof(gfc_actual_arglist))
871
872
873 /* Because a symbol can belong to multiple namelists, they must be
874    linked externally to the symbol itself.  */
875 typedef struct gfc_namelist
876 {
877   struct gfc_symbol *sym;
878   struct gfc_namelist *next;
879 }
880 gfc_namelist;
881
882 #define gfc_get_namelist() gfc_getmem(sizeof(gfc_namelist))
883
884 enum
885 {
886   OMP_LIST_PRIVATE,
887   OMP_LIST_FIRSTPRIVATE,
888   OMP_LIST_LASTPRIVATE,
889   OMP_LIST_COPYPRIVATE,
890   OMP_LIST_SHARED,
891   OMP_LIST_COPYIN,
892   OMP_LIST_PLUS,
893   OMP_LIST_REDUCTION_FIRST = OMP_LIST_PLUS,
894   OMP_LIST_MULT,
895   OMP_LIST_SUB,
896   OMP_LIST_AND,
897   OMP_LIST_OR,
898   OMP_LIST_EQV,
899   OMP_LIST_NEQV,
900   OMP_LIST_MAX,
901   OMP_LIST_MIN,
902   OMP_LIST_IAND,
903   OMP_LIST_IOR,
904   OMP_LIST_IEOR,
905   OMP_LIST_REDUCTION_LAST = OMP_LIST_IEOR,
906   OMP_LIST_NUM
907 };
908
909 /* Because a symbol can belong to multiple namelists, they must be
910    linked externally to the symbol itself.  */
911 typedef struct gfc_omp_clauses
912 {
913   struct gfc_expr *if_expr;
914   struct gfc_expr *num_threads;
915   gfc_namelist *lists[OMP_LIST_NUM];
916   enum
917     {
918       OMP_SCHED_NONE,
919       OMP_SCHED_STATIC,
920       OMP_SCHED_DYNAMIC,
921       OMP_SCHED_GUIDED,
922       OMP_SCHED_RUNTIME
923     } sched_kind;
924   struct gfc_expr *chunk_size;
925   enum
926     {
927       OMP_DEFAULT_UNKNOWN,
928       OMP_DEFAULT_NONE,
929       OMP_DEFAULT_PRIVATE,
930       OMP_DEFAULT_SHARED
931     } default_sharing;
932   bool nowait, ordered;
933 }
934 gfc_omp_clauses;
935
936 #define gfc_get_omp_clauses() gfc_getmem(sizeof(gfc_omp_clauses))
937
938
939 /* The gfc_st_label structure is a doubly linked list attached to a
940    namespace that records the usage of statement labels within that
941    space.  */
942 /* TODO: Make format/statement specifics a union.  */
943 typedef struct gfc_st_label
944 {
945   BBT_HEADER(gfc_st_label);
946
947   int value;
948
949   gfc_sl_type defined, referenced;
950
951   struct gfc_expr *format;
952
953   tree backend_decl;
954
955   locus where;
956 }
957 gfc_st_label;
958
959
960 /* gfc_interface()-- Interfaces are lists of symbols strung together.  */
961 typedef struct gfc_interface
962 {
963   struct gfc_symbol *sym;
964   locus where;
965   struct gfc_interface *next;
966 }
967 gfc_interface;
968
969 #define gfc_get_interface() gfc_getmem(sizeof(gfc_interface))
970
971
972 /* User operator nodes.  These are like stripped down symbols.  */
973 typedef struct
974 {
975   const char *name;
976
977   gfc_interface *operator;
978   struct gfc_namespace *ns;
979   gfc_access access;
980 }
981 gfc_user_op;
982
983 /* Symbol nodes.  These are important things.  They are what the
984    standard refers to as "entities".  The possibly multiple names that
985    refer to the same entity are accomplished by a binary tree of
986    symtree structures that is balanced by the red-black method-- more
987    than one symtree node can point to any given symbol.  */
988
989 typedef struct gfc_symbol
990 {
991   const char *name;     /* Primary name, before renaming */
992   const char *module;   /* Module this symbol came from */
993   locus declared_at;
994
995   gfc_typespec ts;
996   symbol_attribute attr;
997
998   /* The interface member points to the formal argument list if the
999      symbol is a function or subroutine name.  If the symbol is a
1000      generic name, the generic member points to the list of
1001      interfaces.  */
1002
1003   gfc_interface *generic;
1004   gfc_access component_access;
1005
1006   gfc_formal_arglist *formal;
1007   struct gfc_namespace *formal_ns;
1008
1009   struct gfc_expr *value;       /* Parameter/Initializer value */
1010   gfc_array_spec *as;
1011   struct gfc_symbol *result;    /* function result symbol */
1012   gfc_component *components;    /* Derived type components */
1013
1014   /* Defined only for Cray pointees; points to their pointer.  */
1015   struct gfc_symbol *cp_pointer;
1016
1017   struct gfc_symbol *common_next;       /* Links for COMMON syms */
1018
1019   /* This is in fact a gfc_common_head but it is only used for pointer
1020      comparisons to check if symbols are in the same common block.  */
1021   struct gfc_common_head* common_head;
1022
1023   /* Make sure setup code for dummy arguments is generated in the correct
1024      order.  */
1025   int dummy_order;
1026
1027   int entry_id;
1028
1029   gfc_namelist *namelist, *namelist_tail;
1030
1031   /* Change management fields.  Symbols that might be modified by the
1032      current statement have the mark member nonzero and are kept in a
1033      singly linked list through the tlink field.  Of these symbols,
1034      symbols with old_symbol equal to NULL are symbols created within
1035      the current statement.  Otherwise, old_symbol points to a copy of
1036      the old symbol.  */
1037
1038   struct gfc_symbol *old_symbol, *tlink;
1039   unsigned mark:1, new:1;
1040   /* Nonzero if all equivalences associated with this symbol have been
1041      processed.  */
1042   unsigned equiv_built:1;
1043   /* Set if this variable is used as an index name in a FORALL.  */
1044   unsigned forall_index:1;
1045   int refs;
1046   struct gfc_namespace *ns;     /* namespace containing this symbol */
1047
1048   tree backend_decl;
1049    
1050   /* Identity of the intrinsic module the symbol comes from, or
1051      INTMOD_NONE if it's not imported from a intrinsic module.  */
1052   intmod_id from_intmod;
1053   /* Identity of the symbol from intrinsic modules, from enums maintained
1054      separately by each intrinsic module.  Used together with from_intmod,
1055      it uniquely identifies a symbol from an intrinsic module.  */
1056   int intmod_sym_id;
1057
1058   /* This may be repetitive, since the typespec now has a binding
1059      label field.  */
1060   char binding_label[GFC_MAX_BINDING_LABEL_LEN + 1];
1061   /* Store a reference to the common_block, if this symbol is in one.  */
1062   struct gfc_common_head *common_block;
1063 }
1064 gfc_symbol;
1065
1066
1067 /* This structure is used to keep track of symbols in common blocks.  */
1068 typedef struct gfc_common_head
1069 {
1070   locus where;
1071   char use_assoc, saved, threadprivate;
1072   char name[GFC_MAX_SYMBOL_LEN + 1];
1073   struct gfc_symbol *head;
1074   char binding_label[GFC_MAX_BINDING_LABEL_LEN + 1];
1075   int is_bind_c;
1076 }
1077 gfc_common_head;
1078
1079 #define gfc_get_common_head() gfc_getmem(sizeof(gfc_common_head))
1080
1081
1082 /* A list of all the alternate entry points for a procedure.  */
1083
1084 typedef struct gfc_entry_list
1085 {
1086   /* The symbol for this entry point.  */
1087   gfc_symbol *sym;
1088   /* The zero-based id of this entry point.  */
1089   int id;
1090   /* The LABEL_EXPR marking this entry point.  */
1091   tree label;
1092   /* The nest item in the list.  */
1093   struct gfc_entry_list *next;
1094 }
1095 gfc_entry_list;
1096
1097 #define gfc_get_entry_list() \
1098   (gfc_entry_list *) gfc_getmem(sizeof(gfc_entry_list))
1099
1100 /* Within a namespace, symbols are pointed to by symtree nodes that
1101    are linked together in a balanced binary tree.  There can be
1102    several symtrees pointing to the same symbol node via USE
1103    statements.  */
1104
1105 typedef struct gfc_symtree
1106 {
1107   BBT_HEADER (gfc_symtree);
1108   const char *name;
1109   int ambiguous;
1110   union
1111   {
1112     gfc_symbol *sym;            /* Symbol associated with this node */
1113     gfc_user_op *uop;
1114     gfc_common_head *common;
1115   }
1116   n;
1117
1118 }
1119 gfc_symtree;
1120
1121 /* A linked list of derived types in the namespace.  */
1122 typedef struct gfc_dt_list
1123 {
1124   struct gfc_symbol *derived;
1125   struct gfc_dt_list *next;
1126 }
1127 gfc_dt_list;
1128
1129 #define gfc_get_dt_list() gfc_getmem(sizeof(gfc_dt_list))
1130
1131   /* A list of all derived types.  */
1132   extern gfc_dt_list *gfc_derived_types;
1133
1134 /* A namespace describes the contents of procedure, module or
1135    interface block.  */
1136 /* ??? Anything else use these?  */
1137
1138 typedef struct gfc_namespace
1139 {
1140   /* Tree containing all the symbols in this namespace.  */
1141   gfc_symtree *sym_root;
1142   /* Tree containing all the user-defined operators in the namespace.  */
1143   gfc_symtree *uop_root;
1144   /* Tree containing all the common blocks.  */
1145   gfc_symtree *common_root;
1146
1147   /* If set_flag[letter] is set, an implicit type has been set for letter.  */
1148   int set_flag[GFC_LETTERS];
1149   /* Keeps track of the implicit types associated with the letters.  */
1150   gfc_typespec default_type[GFC_LETTERS];
1151
1152   /* If this is a namespace of a procedure, this points to the procedure.  */
1153   struct gfc_symbol *proc_name;
1154   /* If this is the namespace of a unit which contains executable
1155      code, this points to it.  */
1156   struct gfc_code *code;
1157
1158   /* Points to the equivalences set up in this namespace.  */
1159   struct gfc_equiv *equiv;
1160
1161   /* Points to the equivalence groups produced by trans_common.  */
1162   struct gfc_equiv_list *equiv_lists;
1163
1164   gfc_interface *operator[GFC_INTRINSIC_OPS];
1165
1166   /* Points to the parent namespace, i.e. the namespace of a module or
1167      procedure in which the procedure belonging to this namespace is
1168      contained. The parent namespace points to this namespace either
1169      directly via CONTAINED, or indirectly via the chain built by
1170      SIBLING.  */
1171   struct gfc_namespace *parent;
1172   /* CONTAINED points to the first contained namespace. Sibling
1173      namespaces are chained via SIBLING.  */
1174   struct gfc_namespace  *contained, *sibling;
1175
1176   gfc_common_head blank_common;
1177   gfc_access default_access, operator_access[GFC_INTRINSIC_OPS];
1178
1179   gfc_st_label *st_labels;
1180   /* This list holds information about all the data initializers in
1181      this namespace.  */
1182   struct gfc_data *data;
1183
1184   gfc_charlen *cl_list;
1185
1186   int save_all, seen_save, seen_implicit_none;
1187
1188   /* Normally we don't need to refcount namespaces.  However when we read
1189      a module containing a function with multiple entry points, this
1190      will appear as several functions with the same formal namespace.  */
1191   int refs;
1192
1193   /* A list of all alternate entry points to this procedure (or NULL).  */
1194   gfc_entry_list *entries;
1195
1196   /* Set to 1 if namespace is a BLOCK DATA program unit.  */
1197   int is_block_data;
1198
1199   /* Set to 1 if namespace is an interface body with "IMPORT" used.  */
1200   int has_import_set;
1201 }
1202 gfc_namespace;
1203
1204 extern gfc_namespace *gfc_current_ns;
1205
1206 /* Global symbols are symbols of global scope. Currently we only use
1207    this to detect collisions already when parsing.
1208    TODO: Extend to verify procedure calls.  */
1209
1210 typedef struct gfc_gsymbol
1211 {
1212   BBT_HEADER(gfc_gsymbol);
1213
1214   const char *name;
1215   const char *sym_name;
1216   const char *mod_name;
1217   const char *binding_label;
1218   enum { GSYM_UNKNOWN=1, GSYM_PROGRAM, GSYM_FUNCTION, GSYM_SUBROUTINE,
1219         GSYM_MODULE, GSYM_COMMON, GSYM_BLOCK_DATA } type;
1220
1221   int defined, used;
1222   locus where;
1223 }
1224 gfc_gsymbol;
1225
1226 extern gfc_gsymbol *gfc_gsym_root;
1227
1228 /* Information on interfaces being built.  */
1229 typedef struct
1230 {
1231   interface_type type;
1232   gfc_symbol *sym;
1233   gfc_namespace *ns;
1234   gfc_user_op *uop;
1235   gfc_intrinsic_op op;
1236 }
1237 gfc_interface_info;
1238
1239 extern gfc_interface_info current_interface;
1240
1241
1242 /* Array reference.  */
1243 typedef struct gfc_array_ref
1244 {
1245   ar_type type;
1246   int dimen;                    /* # of components in the reference */
1247   locus where;
1248   gfc_array_spec *as;
1249
1250   locus c_where[GFC_MAX_DIMENSIONS];    /* All expressions can be NULL */
1251   struct gfc_expr *start[GFC_MAX_DIMENSIONS], *end[GFC_MAX_DIMENSIONS],
1252     *stride[GFC_MAX_DIMENSIONS];
1253
1254   enum
1255   { DIMEN_ELEMENT = 1, DIMEN_RANGE, DIMEN_VECTOR, DIMEN_UNKNOWN }
1256   dimen_type[GFC_MAX_DIMENSIONS];
1257
1258   struct gfc_expr *offset;
1259 }
1260 gfc_array_ref;
1261
1262 #define gfc_get_array_ref() gfc_getmem(sizeof(gfc_array_ref))
1263
1264
1265 /* Component reference nodes.  A variable is stored as an expression
1266    node that points to the base symbol.  After that, a singly linked
1267    list of component reference nodes gives the variable's complete
1268    resolution.  The array_ref component may be present and comes
1269    before the component component.  */
1270
1271 typedef enum
1272   { REF_ARRAY, REF_COMPONENT, REF_SUBSTRING }
1273 ref_type;
1274
1275 typedef struct gfc_ref
1276 {
1277   ref_type type;
1278
1279   union
1280   {
1281     struct gfc_array_ref ar;
1282
1283     struct
1284     {
1285       gfc_component *component;
1286       gfc_symbol *sym;
1287     }
1288     c;
1289
1290     struct
1291     {
1292       struct gfc_expr *start, *end;     /* Substring */
1293       gfc_charlen *length;
1294     }
1295     ss;
1296
1297   }
1298   u;
1299
1300   struct gfc_ref *next;
1301 }
1302 gfc_ref;
1303
1304 #define gfc_get_ref() gfc_getmem(sizeof(gfc_ref))
1305
1306
1307 /* Structures representing intrinsic symbols and their arguments lists.  */
1308 typedef struct gfc_intrinsic_arg
1309 {
1310   char name[GFC_MAX_SYMBOL_LEN + 1];
1311
1312   gfc_typespec ts;
1313   int optional;
1314   gfc_actual_arglist *actual;
1315
1316   struct gfc_intrinsic_arg *next;
1317
1318 }
1319 gfc_intrinsic_arg;
1320
1321
1322 /* Specifies the various kinds of check functions used to verify the
1323    argument lists of intrinsic functions. fX with X an integer refer
1324    to check functions of intrinsics with X arguments. f1m is used for
1325    the MAX and MIN intrinsics which can have an arbitrary number of
1326    arguments, f3ml is used for the MINLOC and MAXLOC intrinsics as
1327    these have special semantics.  */
1328
1329 typedef union
1330 {
1331   try (*f0)(void);
1332   try (*f1)(struct gfc_expr *);
1333   try (*f1m)(gfc_actual_arglist *);
1334   try (*f2)(struct gfc_expr *, struct gfc_expr *);
1335   try (*f3)(struct gfc_expr *, struct gfc_expr *, struct gfc_expr *);
1336   try (*f3ml)(gfc_actual_arglist *);
1337   try (*f3red)(gfc_actual_arglist *);
1338   try (*f4)(struct gfc_expr *, struct gfc_expr *, struct gfc_expr *,
1339             struct gfc_expr *);
1340   try (*f5)(struct gfc_expr *, struct gfc_expr *, struct gfc_expr *,
1341             struct gfc_expr *, struct gfc_expr *);
1342 }
1343 gfc_check_f;
1344
1345 /* Like gfc_check_f, these specify the type of the simplification
1346    function associated with an intrinsic. The fX are just like in
1347    gfc_check_f. cc is used for type conversion functions.  */
1348
1349 typedef union
1350 {
1351   struct gfc_expr *(*f0)(void);
1352   struct gfc_expr *(*f1)(struct gfc_expr *);
1353   struct gfc_expr *(*f2)(struct gfc_expr *, struct gfc_expr *);
1354   struct gfc_expr *(*f3)(struct gfc_expr *, struct gfc_expr *,
1355                          struct gfc_expr *);
1356   struct gfc_expr *(*f4)(struct gfc_expr *, struct gfc_expr *,
1357                          struct gfc_expr *, struct gfc_expr *);
1358   struct gfc_expr *(*f5)(struct gfc_expr *, struct gfc_expr *,
1359                          struct gfc_expr *, struct gfc_expr *,
1360                          struct gfc_expr *);
1361   struct gfc_expr *(*cc)(struct gfc_expr *, bt, int);
1362 }
1363 gfc_simplify_f;
1364
1365 /* Again like gfc_check_f, these specify the type of the resolution
1366    function associated with an intrinsic. The fX are just like in
1367    gfc_check_f. f1m is used for MIN and MAX, s1 is used for abort().  */
1368
1369 typedef union
1370 {
1371   void (*f0)(struct gfc_expr *);
1372   void (*f1)(struct gfc_expr *, struct gfc_expr *);
1373   void (*f1m)(struct gfc_expr *, struct gfc_actual_arglist *);
1374   void (*f2)(struct gfc_expr *, struct gfc_expr *, struct gfc_expr *);
1375   void (*f3)(struct gfc_expr *, struct gfc_expr *, struct gfc_expr *,
1376              struct gfc_expr *);
1377   void (*f4)(struct gfc_expr *, struct gfc_expr *, struct gfc_expr *,
1378              struct gfc_expr *, struct gfc_expr *);
1379   void (*f5)(struct gfc_expr *, struct gfc_expr *, struct gfc_expr *,
1380              struct gfc_expr *, struct gfc_expr *, struct gfc_expr *);
1381   void (*s1)(struct gfc_code *);
1382 }
1383 gfc_resolve_f;
1384
1385
1386 typedef struct gfc_intrinsic_sym
1387 {
1388   const char *name, *lib_name;
1389   gfc_intrinsic_arg *formal;
1390   gfc_typespec ts;
1391   int elemental, pure, generic, specific, actual_ok, standard, noreturn;
1392
1393   gfc_simplify_f simplify;
1394   gfc_check_f check;
1395   gfc_resolve_f resolve;
1396   struct gfc_intrinsic_sym *specific_head, *next;
1397   gfc_isym_id id;
1398
1399 }
1400 gfc_intrinsic_sym;
1401
1402
1403 /* Expression nodes.  The expression node types deserve explanations,
1404    since the last couple can be easily misconstrued:
1405
1406    EXPR_OP         Operator node pointing to one or two other nodes
1407    EXPR_FUNCTION   Function call, symbol points to function's name
1408    EXPR_CONSTANT   A scalar constant: Logical, String, Real, Int or Complex
1409    EXPR_VARIABLE   An Lvalue with a root symbol and possible reference list
1410                    which expresses structure, array and substring refs.
1411    EXPR_NULL       The NULL pointer value (which also has a basic type).
1412    EXPR_SUBSTRING  A substring of a constant string
1413    EXPR_STRUCTURE  A structure constructor
1414    EXPR_ARRAY      An array constructor.  */
1415
1416 #include <gmp.h>
1417 #include <mpfr.h>
1418 #define GFC_RND_MODE GMP_RNDN
1419
1420 typedef struct gfc_expr
1421 {
1422   expr_t expr_type;
1423
1424   gfc_typespec ts;      /* These two refer to the overall expression */
1425
1426   int rank;
1427   mpz_t *shape;         /* Can be NULL if shape is unknown at compile time */
1428
1429   /* Nonnull for functions and structure constructors */
1430   gfc_symtree *symtree;
1431
1432   gfc_ref *ref;
1433
1434   locus where;
1435
1436   /* True if the expression is a call to a function that returns an array,
1437      and if we have decided not to allocate temporary data for that array.  */
1438   unsigned int inline_noncopying_intrinsic : 1;
1439
1440   /* Used to quickly find a given constructor by its offset.  */
1441   splay_tree con_by_offset;
1442
1443   /* If an expression comes from a Hollerith constant or compile-time
1444      evaluation of a transfer statement, it may have a prescribed target-
1445      memory representation, and these cannot always be backformed from
1446      the value.  */
1447   struct
1448   {
1449     int length;
1450     char *string;
1451   }
1452   representation;
1453
1454   union
1455   {
1456     int logical;
1457
1458     mpz_t integer;
1459
1460     mpfr_t real;
1461
1462     struct
1463     {
1464       mpfr_t r, i;
1465     }
1466     complex;
1467
1468     struct
1469     {
1470       gfc_intrinsic_op operator;
1471       gfc_user_op *uop;
1472       struct gfc_expr *op1, *op2;
1473     }
1474     op;
1475
1476     struct
1477     {
1478       gfc_actual_arglist *actual;
1479       const char *name; /* Points to the ultimate name of the function */
1480       gfc_intrinsic_sym *isym;
1481       gfc_symbol *esym;
1482     }
1483     function;
1484
1485     struct
1486     {
1487       int length;
1488       char *string;
1489     }
1490     character;
1491
1492     struct gfc_constructor *constructor;
1493   }
1494   value;
1495
1496 }
1497 gfc_expr;
1498
1499
1500 #define gfc_get_shape(rank) ((mpz_t *) gfc_getmem((rank)*sizeof(mpz_t)))
1501
1502 /* Structures for information associated with different kinds of
1503    numbers.  The first set of integer parameters define all there is
1504    to know about a particular kind.  The rest of the elements are
1505    computed from the first elements.  */
1506
1507 typedef struct
1508 {
1509   /* Values really representable by the target.  */
1510   mpz_t huge, pedantic_min_int, min_int;
1511
1512   int kind, radix, digits, bit_size, range;
1513
1514   /* True if the C type of the given name maps to this precision.
1515      Note that more than one bit can be set.  */
1516   unsigned int c_char : 1;
1517   unsigned int c_short : 1;
1518   unsigned int c_int : 1;
1519   unsigned int c_long : 1;
1520   unsigned int c_long_long : 1;
1521 }
1522 gfc_integer_info;
1523
1524 extern gfc_integer_info gfc_integer_kinds[];
1525
1526
1527 typedef struct
1528 {
1529   int kind, bit_size;
1530
1531   /* True if the C++ type bool, C99 type _Bool, maps to this precision.  */
1532   unsigned int c_bool : 1;
1533 }
1534 gfc_logical_info;
1535
1536 extern gfc_logical_info gfc_logical_kinds[];
1537
1538
1539 typedef struct
1540 {
1541   mpfr_t epsilon, huge, tiny, subnormal;
1542   int kind, radix, digits, min_exponent, max_exponent;
1543   int range, precision;
1544
1545   /* The precision of the type as reported by GET_MODE_PRECISION.  */
1546   int mode_precision;
1547
1548   /* True if the C type of the given name maps to this precision.
1549      Note that more than one bit can be set.  */
1550   unsigned int c_float : 1;
1551   unsigned int c_double : 1;
1552   unsigned int c_long_double : 1;
1553 }
1554 gfc_real_info;
1555
1556 extern gfc_real_info gfc_real_kinds[];
1557
1558
1559 /* Equivalence structures.  Equivalent lvalues are linked along the
1560    *eq pointer, equivalence sets are strung along the *next node.  */
1561 typedef struct gfc_equiv
1562 {
1563   struct gfc_equiv *next, *eq;
1564   gfc_expr *expr;
1565   const char *module;
1566   int used;
1567 }
1568 gfc_equiv;
1569
1570 #define gfc_get_equiv() gfc_getmem(sizeof(gfc_equiv))
1571
1572 /* Holds a single equivalence member after processing.  */
1573 typedef struct gfc_equiv_info
1574 {
1575   gfc_symbol *sym;
1576   HOST_WIDE_INT offset;
1577   HOST_WIDE_INT length;
1578   struct gfc_equiv_info *next;
1579 } gfc_equiv_info;
1580
1581 /* Holds equivalence groups, after they have been processed.  */
1582 typedef struct gfc_equiv_list
1583 {
1584   gfc_equiv_info *equiv;
1585   struct gfc_equiv_list *next;
1586 } gfc_equiv_list;
1587
1588 /* gfc_case stores the selector list of a case statement.  The *low
1589    and *high pointers can point to the same expression in the case of
1590    a single value.  If *high is NULL, the selection is from *low
1591    upwards, if *low is NULL the selection is *high downwards.
1592
1593    This structure has separate fields to allow single and double linked
1594    lists of CASEs at the same time.  The singe linked list along the NEXT
1595    field is a list of cases for a single CASE label.  The double linked
1596    list along the LEFT/RIGHT fields is used to detect overlap and to
1597    build a table of the cases for SELECT constructs with a CHARACTER
1598    case expression.  */
1599
1600 typedef struct gfc_case
1601 {
1602   /* Where we saw this case.  */
1603   locus where;
1604   int n;
1605
1606   /* Case range values.  If (low == high), it's a single value.  If one of
1607      the labels is NULL, it's an unbounded case.  If both are NULL, this
1608      represents the default case.  */
1609   gfc_expr *low, *high;
1610
1611   /* Next case label in the list of cases for a single CASE label.  */
1612   struct gfc_case *next;
1613
1614   /* Used for detecting overlap, and for code generation.  */
1615   struct gfc_case *left, *right;
1616
1617   /* True if this case label can never be matched.  */
1618   int unreachable;
1619 }
1620 gfc_case;
1621
1622 #define gfc_get_case() gfc_getmem(sizeof(gfc_case))
1623
1624
1625 typedef struct
1626 {
1627   gfc_expr *var, *start, *end, *step;
1628 }
1629 gfc_iterator;
1630
1631 #define gfc_get_iterator() gfc_getmem(sizeof(gfc_iterator))
1632
1633
1634 /* Allocation structure for ALLOCATE, DEALLOCATE and NULLIFY statements.  */
1635
1636 typedef struct gfc_alloc
1637 {
1638   gfc_expr *expr;
1639   struct gfc_alloc *next;
1640 }
1641 gfc_alloc;
1642
1643 #define gfc_get_alloc() gfc_getmem(sizeof(gfc_alloc))
1644
1645
1646 typedef struct
1647 {
1648   gfc_expr *unit, *file, *status, *access, *form, *recl,
1649     *blank, *position, *action, *delim, *pad, *iostat, *iomsg, *convert;
1650   gfc_st_label *err;
1651 }
1652 gfc_open;
1653
1654
1655 typedef struct
1656 {
1657   gfc_expr *unit, *status, *iostat, *iomsg;
1658   gfc_st_label *err;
1659 }
1660 gfc_close;
1661
1662
1663 typedef struct
1664 {
1665   gfc_expr *unit, *iostat, *iomsg;
1666   gfc_st_label *err;
1667 }
1668 gfc_filepos;
1669
1670
1671 typedef struct
1672 {
1673   gfc_expr *unit, *file, *iostat, *exist, *opened, *number, *named,
1674     *name, *access, *sequential, *direct, *form, *formatted,
1675     *unformatted, *recl, *nextrec, *blank, *position, *action, *read,
1676     *write, *readwrite, *delim, *pad, *iolength, *iomsg, *convert, *strm_pos;
1677
1678   gfc_st_label *err;
1679
1680 }
1681 gfc_inquire;
1682
1683
1684 typedef struct
1685 {
1686   gfc_expr *io_unit, *format_expr, *rec, *advance, *iostat, *size, *iomsg;
1687
1688   gfc_symbol *namelist;
1689   /* A format_label of `format_asterisk' indicates the "*" format */
1690   gfc_st_label *format_label;
1691   gfc_st_label *err, *end, *eor;
1692
1693   locus eor_where, end_where, err_where;
1694 }
1695 gfc_dt;
1696
1697
1698 typedef struct gfc_forall_iterator
1699 {
1700   gfc_expr *var, *start, *end, *stride;
1701   struct gfc_forall_iterator *next;
1702 }
1703 gfc_forall_iterator;
1704
1705
1706 /* Executable statements that fill gfc_code structures.  */
1707 typedef enum
1708 {
1709   EXEC_NOP = 1, EXEC_ASSIGN, EXEC_LABEL_ASSIGN, EXEC_POINTER_ASSIGN,
1710   EXEC_GOTO, EXEC_CALL, EXEC_ASSIGN_CALL, EXEC_RETURN, EXEC_ENTRY,
1711   EXEC_PAUSE, EXEC_STOP, EXEC_CONTINUE, EXEC_INIT_ASSIGN,
1712   EXEC_IF, EXEC_ARITHMETIC_IF, EXEC_DO, EXEC_DO_WHILE, EXEC_SELECT,
1713   EXEC_FORALL, EXEC_WHERE, EXEC_CYCLE, EXEC_EXIT,
1714   EXEC_ALLOCATE, EXEC_DEALLOCATE,
1715   EXEC_OPEN, EXEC_CLOSE,
1716   EXEC_READ, EXEC_WRITE, EXEC_IOLENGTH, EXEC_TRANSFER, EXEC_DT_END,
1717   EXEC_BACKSPACE, EXEC_ENDFILE, EXEC_INQUIRE, EXEC_REWIND, EXEC_FLUSH,
1718   EXEC_OMP_CRITICAL, EXEC_OMP_DO, EXEC_OMP_FLUSH, EXEC_OMP_MASTER,
1719   EXEC_OMP_ORDERED, EXEC_OMP_PARALLEL, EXEC_OMP_PARALLEL_DO,
1720   EXEC_OMP_PARALLEL_SECTIONS, EXEC_OMP_PARALLEL_WORKSHARE,
1721   EXEC_OMP_SECTIONS, EXEC_OMP_SINGLE, EXEC_OMP_WORKSHARE,
1722   EXEC_OMP_ATOMIC, EXEC_OMP_BARRIER, EXEC_OMP_END_NOWAIT,
1723   EXEC_OMP_END_SINGLE
1724 }
1725 gfc_exec_op;
1726
1727 typedef struct gfc_code
1728 {
1729   gfc_exec_op op;
1730
1731   struct gfc_code *block, *next;
1732   locus loc;
1733
1734   gfc_st_label *here, *label, *label2, *label3;
1735   gfc_symtree *symtree;
1736   gfc_expr *expr, *expr2;
1737   /* A name isn't sufficient to identify a subroutine, we need the actual
1738      symbol for the interface definition.
1739   const char *sub_name;  */
1740   gfc_symbol *resolved_sym;
1741
1742   union
1743   {
1744     gfc_actual_arglist *actual;
1745     gfc_case *case_list;
1746     gfc_iterator *iterator;
1747     gfc_alloc *alloc_list;
1748     gfc_open *open;
1749     gfc_close *close;
1750     gfc_filepos *filepos;
1751     gfc_inquire *inquire;
1752     gfc_dt *dt;
1753     gfc_forall_iterator *forall_iterator;
1754     struct gfc_code *whichloop;
1755     int stop_code;
1756     gfc_entry_list *entry;
1757     gfc_omp_clauses *omp_clauses;
1758     const char *omp_name;
1759     gfc_namelist *omp_namelist;
1760     bool omp_bool;
1761   }
1762   ext;          /* Points to additional structures required by statement */
1763
1764   /* Backend_decl is used for cycle and break labels in do loops, and
1765      probably for other constructs as well, once we translate them.  */
1766   tree backend_decl;
1767 }
1768 gfc_code;
1769
1770
1771 /* Storage for DATA statements.  */
1772 typedef struct gfc_data_variable
1773 {
1774   gfc_expr *expr;
1775   gfc_iterator iter;
1776   struct gfc_data_variable *list, *next;
1777 }
1778 gfc_data_variable;
1779
1780
1781 typedef struct gfc_data_value
1782 {
1783   unsigned int repeat;
1784   gfc_expr *expr;
1785   struct gfc_data_value *next;
1786 }
1787 gfc_data_value;
1788
1789
1790 typedef struct gfc_data
1791 {
1792   gfc_data_variable *var;
1793   gfc_data_value *value;
1794   locus where;
1795
1796   struct gfc_data *next;
1797 }
1798 gfc_data;
1799
1800 #define gfc_get_data_variable() gfc_getmem(sizeof(gfc_data_variable))
1801 #define gfc_get_data_value() gfc_getmem(sizeof(gfc_data_value))
1802 #define gfc_get_data() gfc_getmem(sizeof(gfc_data))
1803
1804
1805 /* Structure for holding compile options */
1806 typedef struct
1807 {
1808   char *module_dir;
1809   gfc_source_form source_form;
1810   /* Maximum line lengths in fixed- and free-form source, respectively.
1811      When fixed_line_length or free_line_length are 0, the whole line is used,
1812      regardless of length.
1813
1814      If the user requests a fixed_line_length <7 then gfc_init_options()
1815      emits a fatal error.  */
1816   int fixed_line_length;
1817   int free_line_length;
1818   /* Maximum number of continuation lines in fixed- and free-form source,
1819      respectively.  */
1820   int max_continue_fixed;
1821   int max_continue_free;
1822   int max_identifier_length;
1823   int verbose;
1824
1825   int warn_aliasing;
1826   int warn_ampersand;
1827   int warn_conversion;
1828   int warn_implicit_interface;
1829   int warn_line_truncation;
1830   int warn_surprising;
1831   int warn_tabs;
1832   int warn_underflow;
1833   int warn_character_truncation;
1834   int max_errors;
1835
1836   int flag_all_intrinsics;
1837   int flag_default_double;
1838   int flag_default_integer;
1839   int flag_default_real;
1840   int flag_dollar_ok;
1841   int flag_underscoring;
1842   int flag_second_underscore;
1843   int flag_implicit_none;
1844   int flag_max_stack_var_size;
1845   int flag_range_check;
1846   int flag_pack_derived;
1847   int flag_repack_arrays;
1848   int flag_preprocessed;
1849   int flag_f2c;
1850   int flag_automatic;
1851   int flag_backslash;
1852   int flag_backtrace;
1853   int flag_allow_leading_underscore;
1854   int flag_dump_core;
1855   int flag_external_blas;
1856   int blas_matmul_limit;
1857   int flag_cray_pointer;
1858   int flag_d_lines;
1859   int flag_openmp;
1860
1861   int fpe;
1862
1863   int warn_std;
1864   int allow_std;
1865   int warn_nonstd_intrinsics;
1866   int fshort_enums;
1867   int convert;
1868   int record_marker;
1869   int max_subrecord_length;
1870 }
1871 gfc_option_t;
1872
1873 extern gfc_option_t gfc_option;
1874
1875 /* Constructor nodes for array and structure constructors.  */
1876 typedef struct gfc_constructor
1877 {
1878   gfc_expr *expr;
1879   gfc_iterator *iterator;
1880   locus where;
1881   struct gfc_constructor *next;
1882   struct
1883   {
1884     mpz_t offset; /* Record the offset of array element which appears in
1885                      data statement like "data a(5)/4/".  */
1886     gfc_component *component; /* Record the component being initialized.  */
1887   }
1888   n;
1889   mpz_t repeat; /* Record the repeat number of initial values in data
1890                  statement like "data a/5*10/".  */
1891 }
1892 gfc_constructor;
1893
1894
1895 typedef struct iterator_stack
1896 {
1897   gfc_symtree *variable;
1898   mpz_t value;
1899   struct iterator_stack *prev;
1900 }
1901 iterator_stack;
1902 extern iterator_stack *iter_stack;
1903
1904 /************************ Function prototypes *************************/
1905
1906 /* data.c  */
1907 void gfc_formalize_init_value (gfc_symbol *);
1908 void gfc_get_section_index (gfc_array_ref *, mpz_t *, mpz_t *);
1909 try gfc_assign_data_value (gfc_expr *, gfc_expr *, mpz_t);
1910 void gfc_assign_data_value_range (gfc_expr *, gfc_expr *, mpz_t, mpz_t);
1911 void gfc_advance_section (mpz_t *, gfc_array_ref *, mpz_t *);
1912
1913 /* decl.c */
1914 bool gfc_in_match_data (void);
1915 void gfc_set_in_match_data (bool);
1916
1917 /* scanner.c */
1918 void gfc_scanner_done_1 (void);
1919 void gfc_scanner_init_1 (void);
1920
1921 void gfc_add_include_path (const char *, bool);
1922 void gfc_add_intrinsic_modules_path (const char *);
1923 void gfc_release_include_path (void);
1924 FILE *gfc_open_included_file (const char *, bool, bool);
1925 FILE *gfc_open_intrinsic_module (const char *);
1926
1927 int gfc_at_end (void);
1928 int gfc_at_eof (void);
1929 int gfc_at_bol (void);
1930 int gfc_at_eol (void);
1931 void gfc_advance_line (void);
1932 int gfc_check_include (void);
1933
1934 void gfc_skip_comments (void);
1935 int gfc_next_char_literal (int);
1936 int gfc_next_char (void);
1937 int gfc_peek_char (void);
1938 void gfc_error_recovery (void);
1939 void gfc_gobble_whitespace (void);
1940 try gfc_new_file (void);
1941 const char * gfc_read_orig_filename (const char *, const char **);
1942
1943 extern gfc_source_form gfc_current_form;
1944 extern const char *gfc_source_file;
1945 extern locus gfc_current_locus;
1946
1947 /* misc.c */
1948 void *gfc_getmem (size_t) ATTRIBUTE_MALLOC;
1949 void gfc_free (void *);
1950 int gfc_terminal_width (void);
1951 void gfc_clear_ts (gfc_typespec *);
1952 FILE *gfc_open_file (const char *);
1953 const char *gfc_basic_typename (bt);
1954 const char *gfc_typename (gfc_typespec *);
1955
1956 #define gfc_op2string(OP) (OP == INTRINSIC_ASSIGN ? \
1957                            "=" : gfc_code2string (intrinsic_operators, OP))
1958
1959 const char *gfc_code2string (const mstring *, int);
1960 int gfc_string2code (const mstring *, const char *);
1961 const char *gfc_intent_string (sym_intent);
1962
1963 void gfc_init_1 (void);
1964 void gfc_init_2 (void);
1965 void gfc_done_1 (void);
1966 void gfc_done_2 (void);
1967
1968 int get_c_kind (const char *, CInteropKind_t *);
1969
1970 /* options.c */
1971 unsigned int gfc_init_options (unsigned int, const char **);
1972 int gfc_handle_option (size_t, const char *, int);
1973 bool gfc_post_options (const char **);
1974
1975 /* iresolve.c */
1976 const char * gfc_get_string (const char *, ...) ATTRIBUTE_PRINTF_1;
1977
1978 /* error.c */
1979
1980 typedef struct gfc_error_buf
1981 {
1982   int flag;
1983   size_t allocated, index;
1984   char *message;
1985 } gfc_error_buf;
1986
1987 void gfc_error_init_1 (void);
1988 void gfc_buffer_error (int);
1989
1990 void gfc_warning (const char *, ...) ATTRIBUTE_GCC_GFC(1,2);
1991 void gfc_warning_now (const char *, ...) ATTRIBUTE_GCC_GFC(1,2);
1992 void gfc_clear_warning (void);
1993 void gfc_warning_check (void);
1994
1995 void gfc_error (const char *, ...) ATTRIBUTE_GCC_GFC(1,2);
1996 void gfc_error_now (const char *, ...) ATTRIBUTE_GCC_GFC(1,2);
1997 void gfc_fatal_error (const char *, ...) ATTRIBUTE_NORETURN ATTRIBUTE_GCC_GFC(1,2);
1998 void gfc_internal_error (const char *, ...) ATTRIBUTE_NORETURN ATTRIBUTE_GCC_GFC(1,2);
1999 void gfc_clear_error (void);
2000 int gfc_error_check (void);
2001 int gfc_error_flag_test (void);
2002
2003 notification gfc_notification_std (int);
2004 try gfc_notify_std (int, const char *, ...) ATTRIBUTE_GCC_GFC(2,3);
2005
2006 /* A general purpose syntax error.  */
2007 #define gfc_syntax_error(ST)    \
2008   gfc_error ("Syntax error in %s statement at %C", gfc_ascii_statement (ST));
2009
2010 void gfc_push_error (gfc_error_buf *);
2011 void gfc_pop_error (gfc_error_buf *);
2012 void gfc_free_error (gfc_error_buf *);
2013
2014 void gfc_status (const char *, ...) ATTRIBUTE_PRINTF_1;
2015 void gfc_status_char (char);
2016
2017 void gfc_get_errors (int *, int *);
2018
2019 /* arith.c */
2020 void gfc_arith_init_1 (void);
2021 void gfc_arith_done_1 (void);
2022 gfc_expr *gfc_enum_initializer (gfc_expr *, locus);
2023 arith gfc_check_integer_range (mpz_t p, int kind);
2024
2025 /* trans-types.c */
2026 try gfc_validate_c_kind (gfc_typespec *);
2027 try gfc_check_any_c_kind (gfc_typespec *);
2028 int gfc_validate_kind (bt, int, bool);
2029 extern int gfc_index_integer_kind;
2030 extern int gfc_default_integer_kind;
2031 extern int gfc_max_integer_kind;
2032 extern int gfc_default_real_kind;
2033 extern int gfc_default_double_kind;
2034 extern int gfc_default_character_kind;
2035 extern int gfc_default_logical_kind;
2036 extern int gfc_default_complex_kind;
2037 extern int gfc_c_int_kind;
2038 extern int gfc_intio_kind;
2039 extern int gfc_charlen_int_kind;
2040 extern int gfc_numeric_storage_size;
2041 extern int gfc_character_storage_size;
2042
2043 /* symbol.c */
2044 void gfc_clear_new_implicit (void);
2045 try gfc_add_new_implicit_range (int, int);
2046 try gfc_merge_new_implicit (gfc_typespec *);
2047 void gfc_set_implicit_none (void);
2048 void gfc_check_function_type (gfc_namespace *);
2049
2050 gfc_typespec *gfc_get_default_type (gfc_symbol *, gfc_namespace *);
2051 try gfc_set_default_type (gfc_symbol *, int, gfc_namespace *);
2052
2053 void gfc_set_component_attr (gfc_component *, symbol_attribute *);
2054 void gfc_get_component_attr (symbol_attribute *, gfc_component *);
2055
2056 void gfc_set_sym_referenced (gfc_symbol *);
2057
2058 try gfc_add_attribute (symbol_attribute *, locus *);
2059 try gfc_add_allocatable (symbol_attribute *, locus *);
2060 try gfc_add_dimension (symbol_attribute *, const char *, locus *);
2061 try gfc_add_external (symbol_attribute *, locus *);
2062 try gfc_add_intrinsic (symbol_attribute *, locus *);
2063 try gfc_add_optional (symbol_attribute *, locus *);
2064 try gfc_add_pointer (symbol_attribute *, locus *);
2065 try gfc_add_cray_pointer (symbol_attribute *, locus *);
2066 try gfc_add_cray_pointee (symbol_attribute *, locus *);
2067 try gfc_mod_pointee_as (gfc_array_spec *);
2068 try gfc_add_protected (symbol_attribute *, const char *, locus *);
2069 try gfc_add_result (symbol_attribute *, const char *, locus *);
2070 try gfc_add_save (symbol_attribute *, const char *, locus *);
2071 try gfc_add_threadprivate (symbol_attribute *, const char *, locus *);
2072 try gfc_add_saved_common (symbol_attribute *, locus *);
2073 try gfc_add_target (symbol_attribute *, locus *);
2074 try gfc_add_dummy (symbol_attribute *, const char *, locus *);
2075 try gfc_add_generic (symbol_attribute *, const char *, locus *);
2076 try gfc_add_common (symbol_attribute *, locus *);
2077 try gfc_add_in_common (symbol_attribute *, const char *, locus *);
2078 try gfc_add_in_equivalence (symbol_attribute *, const char *, locus *);
2079 try gfc_add_data (symbol_attribute *, const char *, locus *);
2080 try gfc_add_in_namelist (symbol_attribute *, const char *, locus *);
2081 try gfc_add_sequence (symbol_attribute *, const char *, locus *);
2082 try gfc_add_elemental (symbol_attribute *, locus *);
2083 try gfc_add_pure (symbol_attribute *, locus *);
2084 try gfc_add_recursive (symbol_attribute *, locus *);
2085 try gfc_add_function (symbol_attribute *, const char *, locus *);
2086 try gfc_add_subroutine (symbol_attribute *, const char *, locus *);
2087 try gfc_add_volatile (symbol_attribute *, const char *, locus *);
2088
2089 try gfc_add_access (symbol_attribute *, gfc_access, const char *, locus *);
2090 try gfc_add_is_bind_c(symbol_attribute *, const char *, locus *, int);
2091 try gfc_add_value (symbol_attribute *, const char *, locus *);
2092 try gfc_add_flavor (symbol_attribute *, sym_flavor, const char *, locus *);
2093 try gfc_add_entry (symbol_attribute *, const char *, locus *);
2094 try gfc_add_procedure (symbol_attribute *, procedure_type,
2095                        const char *, locus *);
2096 try gfc_add_intent (symbol_attribute *, sym_intent, locus *);
2097 try gfc_add_explicit_interface (gfc_symbol *, ifsrc,
2098                                 gfc_formal_arglist *, locus *);
2099 try gfc_add_type (gfc_symbol *, gfc_typespec *, locus *);
2100
2101 void gfc_clear_attr (symbol_attribute *);
2102 try gfc_missing_attr (symbol_attribute *, locus *);
2103 try gfc_copy_attr (symbol_attribute *, symbol_attribute *, locus *);
2104
2105 try gfc_add_component (gfc_symbol *, const char *, gfc_component **);
2106 gfc_symbol *gfc_use_derived (gfc_symbol *);
2107 gfc_symtree *gfc_use_derived_tree (gfc_symtree *);
2108 gfc_component *gfc_find_component (gfc_symbol *, const char *);
2109
2110 gfc_st_label *gfc_get_st_label (int);
2111 void gfc_free_st_label (gfc_st_label *);
2112 void gfc_define_st_label (gfc_st_label *, gfc_sl_type, locus *);
2113 try gfc_reference_st_label (gfc_st_label *, gfc_sl_type);
2114
2115 gfc_namespace *gfc_get_namespace (gfc_namespace *, int);
2116 gfc_symtree *gfc_new_symtree (gfc_symtree **, const char *);
2117 gfc_symtree *gfc_find_symtree (gfc_symtree *, const char *);
2118 gfc_user_op *gfc_get_uop (const char *);
2119 gfc_user_op *gfc_find_uop (const char *, gfc_namespace *);
2120 void gfc_free_symbol (gfc_symbol *);
2121 gfc_symbol *gfc_new_symbol (const char *, gfc_namespace *);
2122 int gfc_find_symbol (const char *, gfc_namespace *, int, gfc_symbol **);
2123 int gfc_find_sym_tree (const char *, gfc_namespace *, int, gfc_symtree **);
2124 int gfc_get_symbol (const char *, gfc_namespace *, gfc_symbol **);
2125 try verify_c_interop (gfc_typespec *, const char *name, locus *where);
2126 try verify_c_interop_param (gfc_symbol *);
2127 try verify_bind_c_sym (gfc_symbol *, gfc_typespec *, int, gfc_common_head *);
2128 try verify_bind_c_derived_type (gfc_symbol *);
2129 try verify_com_block_vars_c_interop (gfc_common_head *);
2130 void generate_isocbinding_symbol (const char *, iso_c_binding_symbol, char *);
2131 gfc_symbol *get_iso_c_sym (gfc_symbol *, char *, char *, int);
2132 int gfc_get_sym_tree (const char *, gfc_namespace *, gfc_symtree **);
2133 int gfc_get_ha_symbol (const char *, gfc_symbol **);
2134 int gfc_get_ha_sym_tree (const char *, gfc_symtree **);
2135
2136 int gfc_symbols_could_alias (gfc_symbol *, gfc_symbol *);
2137
2138 void gfc_undo_symbols (void);
2139 void gfc_commit_symbols (void);
2140 void gfc_commit_symbol (gfc_symbol *);
2141 void gfc_free_namespace (gfc_namespace *);
2142
2143 void gfc_symbol_init_2 (void);
2144 void gfc_symbol_done_2 (void);
2145
2146 void gfc_traverse_symtree (gfc_symtree *, void (*)(gfc_symtree *));
2147 void gfc_traverse_ns (gfc_namespace *, void (*)(gfc_symbol *));
2148 void gfc_traverse_user_op (gfc_namespace *, void (*)(gfc_user_op *));
2149 void gfc_save_all (gfc_namespace *);
2150
2151 void gfc_symbol_state (void);
2152
2153 gfc_gsymbol *gfc_get_gsymbol (const char *);
2154 gfc_gsymbol *gfc_find_gsymbol (gfc_gsymbol *, const char *);
2155
2156 /* intrinsic.c */
2157 extern int gfc_init_expr;
2158
2159 /* Given a symbol that we have decided is intrinsic, mark it as such
2160    by placing it into a special module that is otherwise impossible to
2161    read or write.  */
2162
2163 #define gfc_intrinsic_symbol(SYM) SYM->module = gfc_get_string ("(intrinsic)")
2164
2165 void gfc_intrinsic_init_1 (void);
2166 void gfc_intrinsic_done_1 (void);
2167
2168 char gfc_type_letter (bt);
2169 gfc_symbol * gfc_get_intrinsic_sub_symbol (const char *);
2170 try gfc_convert_type (gfc_expr *, gfc_typespec *, int);
2171 try gfc_convert_type_warn (gfc_expr *, gfc_typespec *, int, int);
2172 int gfc_generic_intrinsic (const char *);
2173 int gfc_specific_intrinsic (const char *);
2174 int gfc_intrinsic_name (const char *, int);
2175 int gfc_intrinsic_actual_ok (const char *, const bool);
2176 gfc_intrinsic_sym *gfc_find_function (const char *);
2177 gfc_intrinsic_sym *gfc_find_subroutine (const char *);
2178
2179 match gfc_intrinsic_func_interface (gfc_expr *, int);
2180 match gfc_intrinsic_sub_interface (gfc_code *, int);
2181
2182 /* match.c -- FIXME */
2183 void gfc_free_iterator (gfc_iterator *, int);
2184 void gfc_free_forall_iterator (gfc_forall_iterator *);
2185 void gfc_free_alloc_list (gfc_alloc *);
2186 void gfc_free_namelist (gfc_namelist *);
2187 void gfc_free_equiv (gfc_equiv *);
2188 void gfc_free_data (gfc_data *);
2189 void gfc_free_case_list (gfc_case *);
2190
2191 /* matchexp.c -- FIXME too?  */
2192 gfc_expr *gfc_get_parentheses (gfc_expr *);
2193
2194 /* openmp.c */
2195 void gfc_free_omp_clauses (gfc_omp_clauses *);
2196 void gfc_resolve_omp_directive (gfc_code *, gfc_namespace *);
2197 void gfc_resolve_do_iterator (gfc_code *, gfc_symbol *);
2198 void gfc_resolve_omp_parallel_blocks (gfc_code *, gfc_namespace *);
2199 void gfc_resolve_omp_do_blocks (gfc_code *, gfc_namespace *);
2200
2201 /* expr.c */
2202 void gfc_free_actual_arglist (gfc_actual_arglist *);
2203 gfc_actual_arglist *gfc_copy_actual_arglist (gfc_actual_arglist *);
2204 const char *gfc_extract_int (gfc_expr *, int *);
2205 gfc_expr *gfc_expr_to_initialize (gfc_expr *);
2206
2207 gfc_expr *gfc_build_conversion (gfc_expr *);
2208 void gfc_free_ref_list (gfc_ref *);
2209 void gfc_type_convert_binary (gfc_expr *);
2210 int gfc_is_constant_expr (gfc_expr *);
2211 try gfc_simplify_expr (gfc_expr *, int);
2212 int gfc_has_vector_index (gfc_expr *);
2213
2214 gfc_expr *gfc_get_expr (void);
2215 void gfc_free_expr (gfc_expr *);
2216 void gfc_replace_expr (gfc_expr *, gfc_expr *);
2217 gfc_expr *gfc_int_expr (int);
2218 gfc_expr *gfc_logical_expr (int, locus *);
2219 mpz_t *gfc_copy_shape (mpz_t *, int);
2220 mpz_t *gfc_copy_shape_excluding (mpz_t *, int, gfc_expr *);
2221 gfc_expr *gfc_copy_expr (gfc_expr *);
2222
2223 try gfc_specification_expr (gfc_expr *);
2224
2225 int gfc_numeric_ts (gfc_typespec *);
2226 int gfc_kind_max (gfc_expr *, gfc_expr *);
2227
2228 try gfc_check_conformance (const char *, gfc_expr *, gfc_expr *);
2229 try gfc_check_assign (gfc_expr *, gfc_expr *, int);
2230 try gfc_check_pointer_assign (gfc_expr *, gfc_expr *);
2231 try gfc_check_assign_symbol (gfc_symbol *, gfc_expr *);
2232
2233 gfc_expr *gfc_default_initializer (gfc_typespec *);
2234 gfc_expr *gfc_get_variable_expr (gfc_symtree *);
2235
2236 void gfc_expr_set_symbols_referenced (gfc_expr *);
2237
2238 /* st.c */
2239 extern gfc_code new_st;
2240
2241 void gfc_clear_new_st (void);
2242 gfc_code *gfc_get_code (void);
2243 gfc_code *gfc_append_code (gfc_code *, gfc_code *);
2244 void gfc_free_statement (gfc_code *);
2245 void gfc_free_statements (gfc_code *);
2246
2247 /* resolve.c */
2248 try gfc_resolve_expr (gfc_expr *);
2249 void gfc_resolve (gfc_namespace *);
2250 void gfc_resolve_blocks (gfc_code *, gfc_namespace *);
2251 int gfc_impure_variable (gfc_symbol *);
2252 int gfc_pure (gfc_symbol *);
2253 int gfc_elemental (gfc_symbol *);
2254 try gfc_resolve_iterator (gfc_iterator *, bool);
2255 try gfc_resolve_index (gfc_expr *, int);
2256 try gfc_resolve_dim_arg (gfc_expr *);
2257 int gfc_is_formal_arg (void);
2258 match gfc_iso_c_sub_interface(gfc_code *, gfc_symbol *);
2259
2260
2261 /* array.c */
2262 void gfc_free_array_spec (gfc_array_spec *);
2263 gfc_array_ref *gfc_copy_array_ref (gfc_array_ref *);
2264
2265 try gfc_set_array_spec (gfc_symbol *, gfc_array_spec *, locus *);
2266 gfc_array_spec *gfc_copy_array_spec (gfc_array_spec *);
2267 try gfc_resolve_array_spec (gfc_array_spec *, int);
2268
2269 int gfc_compare_array_spec (gfc_array_spec *, gfc_array_spec *);
2270
2271 gfc_expr *gfc_start_constructor (bt, int, locus *);
2272 void gfc_append_constructor (gfc_expr *, gfc_expr *);
2273 void gfc_free_constructor (gfc_constructor *);
2274 void gfc_simplify_iterator_var (gfc_expr *);
2275 try gfc_expand_constructor (gfc_expr *);
2276 int gfc_constant_ac (gfc_expr *);
2277 int gfc_expanded_ac (gfc_expr *);
2278 void gfc_resolve_character_array_constructor (gfc_expr *);
2279 try gfc_resolve_array_constructor (gfc_expr *);
2280 try gfc_check_constructor_type (gfc_expr *);
2281 try gfc_check_iter_variable (gfc_expr *);
2282 try gfc_check_constructor (gfc_expr *, try (*)(gfc_expr *));
2283 gfc_constructor *gfc_copy_constructor (gfc_constructor *);
2284 gfc_expr *gfc_get_array_element (gfc_expr *, int);
2285 try gfc_array_size (gfc_expr *, mpz_t *);
2286 try gfc_array_dimen_size (gfc_expr *, int, mpz_t *);
2287 try gfc_array_ref_shape (gfc_array_ref *, mpz_t *);
2288 gfc_array_ref *gfc_find_array_ref (gfc_expr *);
2289 void gfc_insert_constructor (gfc_expr *, gfc_constructor *);
2290 gfc_constructor *gfc_get_constructor (void);
2291 tree gfc_conv_array_initializer (tree type, gfc_expr *);
2292 try spec_size (gfc_array_spec *, mpz_t *);
2293 try spec_dimen_size (gfc_array_spec *, int, mpz_t *);
2294 int gfc_is_compile_time_shape (gfc_array_spec *);
2295
2296 /* interface.c -- FIXME: some of these should be in symbol.c */
2297 void gfc_free_interface (gfc_interface *);
2298 int gfc_compare_derived_types (gfc_symbol *, gfc_symbol *);
2299 int gfc_compare_types (gfc_typespec *, gfc_typespec *);
2300 void gfc_check_interfaces (gfc_namespace *);
2301 void gfc_procedure_use (gfc_symbol *, gfc_actual_arglist **, locus *);
2302 gfc_symbol *gfc_search_interface (gfc_interface *, int,
2303                                   gfc_actual_arglist **);
2304 try gfc_extend_expr (gfc_expr *);
2305 void gfc_free_formal_arglist (gfc_formal_arglist *);
2306 try gfc_extend_assign (gfc_code *, gfc_namespace *);
2307 try gfc_add_interface (gfc_symbol *);
2308
2309 /* io.c */
2310 extern gfc_st_label format_asterisk;
2311
2312 void gfc_free_open (gfc_open *);
2313 try gfc_resolve_open (gfc_open *);
2314 void gfc_free_close (gfc_close *);
2315 try gfc_resolve_close (gfc_close *);
2316 void gfc_free_filepos (gfc_filepos *);
2317 try gfc_resolve_filepos (gfc_filepos *);
2318 void gfc_free_inquire (gfc_inquire *);
2319 try gfc_resolve_inquire (gfc_inquire *);
2320 void gfc_free_dt (gfc_dt *);
2321 try gfc_resolve_dt (gfc_dt *);
2322
2323 /* module.c */
2324 void gfc_module_init_2 (void);
2325 void gfc_module_done_2 (void);
2326 void gfc_dump_module (const char *, int);
2327 bool gfc_check_access (gfc_access, gfc_access);
2328
2329 /* primary.c */
2330 symbol_attribute gfc_variable_attr (gfc_expr *, gfc_typespec *);
2331 symbol_attribute gfc_expr_attr (gfc_expr *);
2332 match gfc_match_rvalue (gfc_expr **);
2333
2334 /* trans.c */
2335 void gfc_generate_code (gfc_namespace *);
2336 void gfc_generate_module_code (gfc_namespace *);
2337
2338 /* bbt.c */
2339 typedef int (*compare_fn) (void *, void *);
2340 void gfc_insert_bbt (void *, void *, compare_fn);
2341 void gfc_delete_bbt (void *, void *, compare_fn);
2342
2343 /* dump-parse-tree.c */
2344 void gfc_show_actual_arglist (gfc_actual_arglist *);
2345 void gfc_show_array_ref (gfc_array_ref *);
2346 void gfc_show_array_spec (gfc_array_spec *);
2347 void gfc_show_attr (symbol_attribute *);
2348 void gfc_show_code (int, gfc_code *);
2349 void gfc_show_components (gfc_symbol *);
2350 void gfc_show_constructor (gfc_constructor *);
2351 void gfc_show_equiv (gfc_equiv *);
2352 void gfc_show_expr (gfc_expr *);
2353 void gfc_show_namelist (gfc_namelist *);
2354 void gfc_show_namespace (gfc_namespace *);
2355 void gfc_show_ref (gfc_ref *);
2356 void gfc_show_symbol (gfc_symbol *);
2357 void gfc_show_typespec (gfc_typespec *);
2358
2359 /* parse.c */
2360 try gfc_parse_file (void);
2361 void global_used (gfc_gsymbol *, locus *);
2362
2363 /* dependency.c */
2364 int gfc_dep_compare_expr (gfc_expr *, gfc_expr *);
2365
2366 #endif /* GCC_GFORTRAN_H  */