OSDN Git Service

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