gcc/fortran/trans-array.h

   1 /* Header for array handling functions
   2    Copyright (C) 2002, 2003 Free Software Foundation, Inc.
   3    Contributed by Paul Brook
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 2, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING.  If not, write to the Free
  19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  20 02111-1307, USA.  */
  21
  22 /* Generate code to free an array.  */
  23 tree gfc_array_deallocate (tree);
  24
  25 /* Generate code to initialise an allocate an array.  Statements are added to
  26    se, which should contain an expression for the array descriptor.  */
  27 void gfc_array_allocate (gfc_se *, gfc_ref *, tree);
  28
  29 /* Generate code to allocate a temporary array.  */
  30 tree gfc_trans_allocate_temp_array (gfc_loopinfo *, gfc_ss_info *, tree,
  31                                     tree);
  32
  33 /* Generate function entry code for allocation of compiler allocated array
  34    variables.  */
  35 tree gfc_trans_auto_array_allocation (tree, gfc_symbol *, tree);
  36 /* Generate entry and exit code for dummy array parameters.  */
  37 tree gfc_trans_dummy_array_bias (gfc_symbol *, tree, tree);
  38 /* Generate entry and exit code for g77 calling convention arrays.  */
  39 tree gfc_trans_g77_array (gfc_symbol *, tree);
  40 /* Add initialisation for deferred arrays.  */
  41 tree gfc_trans_deferred_array (gfc_symbol *, tree);
  42 /* Generate an initializer for a static pointer or allocatable array.  */
  43 void gfc_trans_static_array_pointer (gfc_symbol *);
  44
  45 /* Generate scalarization information for an expression.  */
  46 gfc_ss *gfc_walk_expr (gfc_expr *);
  47 /* Walk the arguments of an intrinsic function.  */
  48 gfc_ss *gfc_walk_elemental_function_args (gfc_ss *, gfc_expr *, gfc_ss_type);
  49 /* Walk an intrinsic function.  */
  50 gfc_ss *gfc_walk_intrinsic_function (gfc_ss *, gfc_expr *,
  51                                      gfc_intrinsic_sym *);
  52
  53 /* Free the SS assocuated with a loop.  */
  54 void gfc_cleanup_loop (gfc_loopinfo *);
  55 /* Associate a SS chain with a loop.  */
  56 void gfc_add_ss_to_loop (gfc_loopinfo *, gfc_ss *);
  57 /* Mark a SS chain as used in this loop.  */
  58 void gfc_mark_ss_chain_used (gfc_ss *, unsigned);
  59
  60 /* Calculates the lower bound and stride of array sections.  */
  61 void gfc_conv_ss_startstride (gfc_loopinfo *);
  62
  63 void gfc_init_loopinfo (gfc_loopinfo *);
  64 void gfc_copy_loopinfo_to_se (gfc_se *, gfc_loopinfo *);
  65
  66 /* Marks the start of a scalarized expression, and declares loop variables.  */
  67 void gfc_start_scalarized_body (gfc_loopinfo *, stmtblock_t *);
  68 /* Generates the actual loops for a scalarized expression.  */
  69 void gfc_trans_scalarizing_loops (gfc_loopinfo *, stmtblock_t *);
  70 /* Mark the end of the main loop body and the start of the copying loop.  */
  71 void gfc_trans_scalarized_loop_boundary (gfc_loopinfo *, stmtblock_t *);
  72 /* Initialise the scalarization loop parameters.  */
  73 void gfc_conv_loop_setup (gfc_loopinfo *);
  74 /* Resolve array assignment dependencies.  */
  75 void gfc_conv_resolve_dependencies (gfc_loopinfo *, gfc_ss *, gfc_ss *);
  76 /* Build an null array descriptor constructor.  */
  77 tree gfc_build_null_descriptor (tree);
  78
  79 /* Get a single array element.  */
  80 void gfc_conv_array_ref (gfc_se *, gfc_array_ref *);
  81 /* Translate a reference to a temporary array.  */
  82 void gfc_conv_tmp_array_ref (gfc_se * se);
  83 /* Translate a reference to an array temporary.  */
  84 void gfc_conv_tmp_ref (gfc_se *);
  85
  86 /* Evaluate an array expression.  */
  87 void gfc_conv_expr_descriptor (gfc_se *, gfc_expr *, gfc_ss *);
  88 /* Convert an array for passing as an actual function parameter.  */
  89 void gfc_conv_array_parameter (gfc_se *, gfc_expr *, gfc_ss *, int);
  90
  91 /* These work with both descriptors and descriptorless arrays.  */
  92 tree gfc_conv_array_data (tree);
  93 tree gfc_conv_array_offset (tree);
  94 /* Return either an INT_CST or an expression for that part of the descriptor. */
  95 tree gfc_conv_array_stride (tree, int);
  96 tree gfc_conv_array_lbound (tree, int);
  97 tree gfc_conv_array_ubound (tree, int);
  98
  99 /* The remaining space available for stack variables.  */
 100 extern unsigned HOST_WIDE_INT gfc_stack_space_left;
 101 /* Returns true if a variable of specified size should go on the stack.  */
 102 int gfc_can_put_var_on_stack (tree);
 103
 104 /* Build expressions for accessing components of an array descriptor.  */
 105 tree gfc_conv_descriptor_data (tree);
 106 tree gfc_conv_descriptor_offset (tree);
 107 tree gfc_conv_descriptor_dtype (tree);
 108 tree gfc_conv_descriptor_stride (tree, tree);
 109 tree gfc_conv_descriptor_lbound (tree, tree);
 110 tree gfc_conv_descriptor_ubound (tree, tree);
 111
 112 /* Dependency checking for WHERE and FORALL.  */
 113 int gfc_check_dependency (gfc_expr *, gfc_expr *, gfc_expr **, int);
 114 /* Dependency checking for function calls.  */
 115 int gfc_check_fncall_dependency (gfc_expr *, gfc_expr *);
 116
 117 /* Add pre-loop scalarization code for intrinsic functions which require
 118    special handling.  */
 119 void gfc_add_intrinsic_ss_code (gfc_loopinfo *, gfc_ss *);