1 /* Header for array handling functions
2 Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2012
3 Free Software Foundation, Inc.
4 Contributed by Paul Brook
6 This file is part of GCC.
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
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
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/>. */
22 /* Generate code to free an array. */
23 tree
gfc_array_deallocate (tree
, tree
, tree
, tree
, tree
, gfc_expr
*);
25 /* Generate code to initialize and 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
, tree
, tree
, tree
,
28 tree
, tree
*, gfc_expr
*);
30 /* Allow the bounds of a loop to be set from a callee's array spec. */
31 void gfc_set_loop_bounds_from_array_spec (gfc_interface_mapping
*,
32 gfc_se
*, gfc_array_spec
*);
34 /* Generate code to create a temporary array. */
35 tree
gfc_trans_create_temp_array (stmtblock_t
*, stmtblock_t
*, gfc_ss
*,
36 tree
, tree
, bool, bool, bool, locus
*);
38 /* Generate function entry code for allocation of compiler allocated array
40 void gfc_trans_auto_array_allocation (tree
, gfc_symbol
*, gfc_wrapped_block
*);
41 /* Generate entry and exit code for dummy array parameters. */
42 void gfc_trans_dummy_array_bias (gfc_symbol
*, tree
, gfc_wrapped_block
*);
43 /* Generate entry and exit code for g77 calling convention arrays. */
44 void gfc_trans_g77_array (gfc_symbol
*, gfc_wrapped_block
*);
45 /* Generate code to deallocate an array, if it is allocated. */
46 tree
gfc_trans_dealloc_allocated (tree
, bool);
48 tree
gfc_duplicate_allocatable (tree dest
, tree src
, tree type
, int rank
);
50 tree
gfc_copy_allocatable_data (tree dest
, tree src
, tree type
, int rank
);
52 tree
gfc_nullify_alloc_comp (gfc_symbol
*, tree
, int);
54 tree
gfc_deallocate_alloc_comp (gfc_symbol
*, tree
, int);
56 tree
gfc_copy_alloc_comp (gfc_symbol
*, tree
, tree
, int);
58 tree
gfc_copy_only_alloc_comp (gfc_symbol
*, tree
, tree
, int);
60 tree
gfc_alloc_allocatable_for_assignment (gfc_loopinfo
*, gfc_expr
*, gfc_expr
*);
62 bool gfc_is_reallocatable_lhs (gfc_expr
*);
64 /* Add initialization for deferred arrays. */
65 void gfc_trans_deferred_array (gfc_symbol
*, gfc_wrapped_block
*);
66 /* Generate an initializer for a static pointer or allocatable array. */
67 void gfc_trans_static_array_pointer (gfc_symbol
*);
69 /* Get the procedure interface for a function call. */
70 gfc_symbol
*gfc_get_proc_ifc_for_expr (gfc_expr
*);
71 /* Generate scalarization information for an expression. */
72 gfc_ss
*gfc_walk_expr (gfc_expr
*);
73 /* Workhorse for gfc_walk_expr. */
74 gfc_ss
*gfc_walk_subexpr (gfc_ss
*, gfc_expr
*);
75 /* Workhorse for gfc_walk_variable_expr. */
76 gfc_ss
*gfc_walk_array_ref (gfc_ss
*, gfc_expr
*, gfc_ref
* ref
);
77 /* Walk the arguments of an elemental function. */
78 gfc_ss
*gfc_walk_elemental_function_args (gfc_ss
*, gfc_actual_arglist
*,
79 gfc_symbol
*, gfc_ss_type
);
80 /* Walk an intrinsic function. */
81 gfc_ss
*gfc_walk_intrinsic_function (gfc_ss
*, gfc_expr
*,
83 /* Reverse the order of an SS chain. */
84 gfc_ss
*gfc_reverse_ss (gfc_ss
*);
86 /* Free the SS associated with a loop. */
87 void gfc_cleanup_loop (gfc_loopinfo
*);
88 /* Associate a SS chain with a loop. */
89 void gfc_add_ss_to_loop (gfc_loopinfo
*, gfc_ss
*);
90 /* Mark a SS chain as used in this loop. */
91 void gfc_mark_ss_chain_used (gfc_ss
*, unsigned);
92 /* Free a gfc_ss chain. */
93 void gfc_free_ss_chain (gfc_ss
*);
94 /* Free a single gfc_ss element. */
95 void gfc_free_ss (gfc_ss
*);
96 /* Allocate a new array type ss. */
97 gfc_ss
*gfc_get_array_ss (gfc_ss
*, gfc_expr
*, int, gfc_ss_type
);
98 /* Allocate a new temporary type ss. */
99 gfc_ss
*gfc_get_temp_ss (tree
, tree
, int);
100 /* Allocate a new scalar type ss. */
101 gfc_ss
*gfc_get_scalar_ss (gfc_ss
*, gfc_expr
*);
103 /* Calculates the lower bound and stride of array sections. */
104 void gfc_conv_ss_startstride (gfc_loopinfo
*);
106 void gfc_init_loopinfo (gfc_loopinfo
*);
107 void gfc_copy_loopinfo_to_se (gfc_se
*, gfc_loopinfo
*);
109 /* Marks the start of a scalarized expression, and declares loop variables. */
110 void gfc_start_scalarized_body (gfc_loopinfo
*, stmtblock_t
*);
111 /* Generates one actual loop for a scalarized expression. */
112 void gfc_trans_scalarized_loop_end (gfc_loopinfo
*, int, stmtblock_t
*);
113 /* Generates the actual loops for a scalarized expression. */
114 void gfc_trans_scalarizing_loops (gfc_loopinfo
*, stmtblock_t
*);
115 /* Mark the end of the main loop body and the start of the copying loop. */
116 void gfc_trans_scalarized_loop_boundary (gfc_loopinfo
*, stmtblock_t
*);
117 /* Initialize the scalarization loop parameters. */
118 void gfc_conv_loop_setup (gfc_loopinfo
*, locus
*);
119 /* Set each array's delta. */
120 void gfc_set_delta (gfc_loopinfo
*);
121 /* Resolve array assignment dependencies. */
122 void gfc_conv_resolve_dependencies (gfc_loopinfo
*, gfc_ss
*, gfc_ss
*);
123 /* Build a null array descriptor constructor. */
124 tree
gfc_build_null_descriptor (tree
);
126 /* Get a single array element. */
127 void gfc_conv_array_ref (gfc_se
*, gfc_array_ref
*, gfc_symbol
*, locus
*);
128 /* Translate a reference to a temporary array. */
129 void gfc_conv_tmp_array_ref (gfc_se
* se
);
130 /* Translate a reference to an array temporary. */
131 void gfc_conv_tmp_ref (gfc_se
*);
133 /* Evaluate an array expression. */
134 void gfc_conv_expr_descriptor (gfc_se
*, gfc_expr
*, gfc_ss
*);
135 /* Convert an array for passing as an actual function parameter. */
136 void gfc_conv_array_parameter (gfc_se
*, gfc_expr
*, gfc_ss
*, bool,
137 const gfc_symbol
*, const char *, tree
*);
138 /* Evaluate and transpose a matrix expression. */
139 void gfc_conv_array_transpose (gfc_se
*, gfc_expr
*);
141 /* These work with both descriptors and descriptorless arrays. */
142 tree
gfc_conv_array_data (tree
);
143 tree
gfc_conv_array_offset (tree
);
144 /* Return either an INT_CST or an expression for that part of the descriptor. */
145 tree
gfc_conv_array_stride (tree
, int);
146 tree
gfc_conv_array_lbound (tree
, int);
147 tree
gfc_conv_array_ubound (tree
, int);
149 /* Set cobounds of an array. */
150 void gfc_trans_array_cobounds (tree
, stmtblock_t
*, const gfc_symbol
*);
152 /* Build expressions for accessing components of an array descriptor. */
153 tree
gfc_conv_descriptor_data_get (tree
);
154 tree
gfc_conv_descriptor_data_addr (tree
);
155 tree
gfc_conv_descriptor_offset_get (tree
);
156 tree
gfc_conv_descriptor_dtype (tree
);
157 tree
gfc_conv_descriptor_stride_get (tree
, tree
);
158 tree
gfc_conv_descriptor_lbound_get (tree
, tree
);
159 tree
gfc_conv_descriptor_ubound_get (tree
, tree
);
160 tree
gfc_conv_descriptor_token (tree
);
162 void gfc_conv_descriptor_data_set (stmtblock_t
*, tree
, tree
);
163 void gfc_conv_descriptor_offset_set (stmtblock_t
*, tree
, tree
);
164 void gfc_conv_descriptor_stride_set (stmtblock_t
*, tree
, tree
, tree
);
165 void gfc_conv_descriptor_lbound_set (stmtblock_t
*, tree
, tree
, tree
);
166 void gfc_conv_descriptor_ubound_set (stmtblock_t
*, tree
, tree
, tree
);
168 /* Shift lower bound of descriptor, updating ubound and offset. */
169 void gfc_conv_shift_descriptor_lbound (stmtblock_t
*, tree
, int, tree
);
171 /* Add pre-loop scalarization code for intrinsic functions which require
173 void gfc_add_intrinsic_ss_code (gfc_loopinfo
*, gfc_ss
*);
175 /* Functions for constant array constructor processing. */
176 unsigned HOST_WIDE_INT
gfc_constant_array_constructor_p (gfc_constructor_base
);
177 tree
gfc_build_constant_array_constructor (gfc_expr
*, tree
);
179 /* Copy a string from src to dest. */
180 void gfc_trans_string_copy (stmtblock_t
*, tree
, tree
, int, tree
, tree
, int);
182 /* Calculate extent / size of an array. */
183 tree
gfc_conv_array_extent_dim (tree
, tree
, tree
*);
184 tree
gfc_conv_descriptor_size (tree
, int);
185 tree
gfc_conv_descriptor_cosize (tree
, int, int);