gcc/fortran/gfortran.h

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