gcc/fortran/trans-array.h

   1 /* Header for array handling functions
   2    Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008
   3    Free Software Foundation, Inc.
   4    Contributed by Paul Brook
   5
   6 This file is part of GCC.
   7
   8 GCC is free software; you can redistribute it and/or modify it under
   9 the terms of the GNU General Public License as published by the Free
  10 Software Foundation; either version 3, or (at your option) any later
  11 version.
  12
  13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  15 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  16 for more details.
  17
  18 You should have received a copy of the GNU General Public License
  19 along with GCC; see the file COPYING3.  If not see
  20 <http://www.gnu.org/licenses/>.  */
  21
  22 /* Generate code to free an array.  */
  23 tree gfc_array_deallocate (tree, tree, gfc_expr*);
  24
  25 /* Generate code to initialize an allocate an array.  Statements are added to
  26    se, which should contain an expression for the array descriptor.  */
  27 bool gfc_array_allocate (gfc_se *, gfc_expr *, tree);
  28
  29 /* Allow the bounds of a loop to be set from a callee's array spec.  */
  30 void gfc_set_loop_bounds_from_array_spec (gfc_interface_mapping *,
  31                                           gfc_se *, gfc_array_spec *);
  32
  33 /* Generate code to create a temporary array.  */
  34 tree gfc_trans_create_temp_array (stmtblock_t *, stmtblock_t *, gfc_loopinfo *,
  35                                   gfc_ss_info *, tree, tree, bool, bool, bool,
  36                                   locus *);
  37
  38 /* Generate function entry code for allocation of compiler allocated array
  39    variables.  */
  40 tree gfc_trans_auto_array_allocation (tree, gfc_symbol *, tree);
  41 /* Generate entry and exit code for dummy array parameters.  */
  42 tree gfc_trans_dummy_array_bias (gfc_symbol *, tree, tree);
  43 /* Generate entry and exit code for g77 calling convention arrays.  */
  44 tree gfc_trans_g77_array (gfc_symbol *, tree);
  45 /* Generate code to deallocate an array, if it is allocated.  */
  46 tree gfc_trans_dealloc_allocated (tree);
  47
  48 tree gfc_duplicate_allocatable(tree dest, tree src, tree type, int rank);
  49
  50 tree gfc_nullify_alloc_comp (gfc_symbol *, tree, int);
  51
  52 tree gfc_deallocate_alloc_comp (gfc_symbol *, tree, int);
  53
  54 tree gfc_copy_alloc_comp (gfc_symbol *, tree, tree, int);
  55
  56 /* Add initialization for deferred arrays.  */
  57 tree gfc_trans_deferred_array (gfc_symbol *, tree);
  58 /* Generate an initializer for a static pointer or allocatable array.  */
  59 void gfc_trans_static_array_pointer (gfc_symbol *);
  60
  61 /* Generate scalarization information for an expression.  */
  62 gfc_ss *gfc_walk_expr (gfc_expr *);
  63 /* Walk the arguments of an elemental function.  */
  64 gfc_ss *gfc_walk_elemental_function_args (gfc_ss *, gfc_actual_arglist *,
  65                                           gfc_ss_type);
  66 /* Walk an intrinsic function.  */
  67 gfc_ss *gfc_walk_intrinsic_function (gfc_ss *, gfc_expr *,
  68                                      gfc_intrinsic_sym *);
  69 /* Reverse the order of an SS chain.  */
  70 gfc_ss *gfc_reverse_ss (gfc_ss *);
  71
  72 /* Free the SS associated with a loop.  */
  73 void gfc_cleanup_loop (gfc_loopinfo *);
  74 /* Associate a SS chain with a loop.  */
  75 void gfc_add_ss_to_loop (gfc_loopinfo *, gfc_ss *);
  76 /* Mark a SS chain as used in this loop.  */
  77 void gfc_mark_ss_chain_used (gfc_ss *, unsigned);
  78
  79 /* Calculates the lower bound and stride of array sections.  */
  80 void gfc_conv_ss_startstride (gfc_loopinfo *);
  81
  82 void gfc_init_loopinfo (gfc_loopinfo *);
  83 void gfc_copy_loopinfo_to_se (gfc_se *, gfc_loopinfo *);
  84
  85 /* Marks the start of a scalarized expression, and declares loop variables.  */
  86 void gfc_start_scalarized_body (gfc_loopinfo *, stmtblock_t *);
  87 /* Generates the actual loops for a scalarized expression.  */
  88 void gfc_trans_scalarizing_loops (gfc_loopinfo *, stmtblock_t *);
  89 /* Mark the end of the main loop body and the start of the copying loop.  */
  90 void gfc_trans_scalarized_loop_boundary (gfc_loopinfo *, stmtblock_t *);
  91 /* Initialize the scalarization loop parameters.  */
  92 void gfc_conv_loop_setup (gfc_loopinfo *, locus *);
  93 /* Resolve array assignment dependencies.  */
  94 void gfc_conv_resolve_dependencies (gfc_loopinfo *, gfc_ss *, gfc_ss *);
  95 /* Build a null array descriptor constructor.  */
  96 tree gfc_build_null_descriptor (tree);
  97
  98 /* Get a single array element.  */
  99 void gfc_conv_array_ref (gfc_se *, gfc_array_ref *, gfc_symbol *, locus *);
 100 /* Translate a reference to a temporary array.  */
 101 void gfc_conv_tmp_array_ref (gfc_se * se);
 102 /* Translate a reference to an array temporary.  */
 103 void gfc_conv_tmp_ref (gfc_se *);
 104
 105 /* Evaluate an array expression.  */
 106 void gfc_conv_expr_descriptor (gfc_se *, gfc_expr *, gfc_ss *);
 107 /* Convert an array for passing as an actual function parameter.  */
 108 void gfc_conv_array_parameter (gfc_se *, gfc_expr *, gfc_ss *, int,
 109                                const gfc_symbol *, const char *, tree *);
 110 /* Evaluate and transpose a matrix expression.  */
 111 void gfc_conv_array_transpose (gfc_se *, gfc_expr *);
 112
 113 /* These work with both descriptors and descriptorless arrays.  */
 114 tree gfc_conv_array_data (tree);
 115 tree gfc_conv_array_offset (tree);
 116 /* Return either an INT_CST or an expression for that part of the descriptor.  */
 117 tree gfc_conv_array_stride (tree, int);
 118 tree gfc_conv_array_lbound (tree, int);
 119 tree gfc_conv_array_ubound (tree, int);
 120
 121 /* Build expressions for accessing components of an array descriptor.  */
 122 tree gfc_conv_descriptor_data_get (tree);
 123 tree gfc_conv_descriptor_data_addr (tree);
 124 tree gfc_conv_descriptor_offset_get (tree);
 125 tree gfc_conv_descriptor_dtype (tree);
 126 tree gfc_conv_descriptor_stride_get (tree, tree);
 127 tree gfc_conv_descriptor_lbound_get (tree, tree);
 128 tree gfc_conv_descriptor_ubound_get (tree, tree);
 129
 130 void gfc_conv_descriptor_data_set (stmtblock_t *, tree, tree);
 131 void gfc_conv_descriptor_offset_set (stmtblock_t *, tree, tree);
 132 void gfc_conv_descriptor_stride_set (stmtblock_t *, tree, tree, tree);
 133 void gfc_conv_descriptor_lbound_set (stmtblock_t *, tree, tree, tree);
 134 void gfc_conv_descriptor_ubound_set (stmtblock_t *, tree, tree, tree);
 135
 136 /* Add pre-loop scalarization code for intrinsic functions which require
 137    special handling.  */
 138 void gfc_add_intrinsic_ss_code (gfc_loopinfo *, gfc_ss *);
 139
 140 /* Functions for constant array constructor processing.  */
 141 unsigned HOST_WIDE_INT gfc_constant_array_constructor_p (gfc_constructor *);
 142 tree gfc_build_constant_array_constructor (gfc_expr *, tree);
 143
 144 /* Copy a string from src to dest.  */
 145 void gfc_trans_string_copy (stmtblock_t *, tree, tree, int, tree, tree, int);