1 |
712 |
jeremybenn |
/* 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
|
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, tree, tree, tree, gfc_expr*);
|
24 |
|
|
|
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 *);
|
29 |
|
|
|
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 *);
|
33 |
|
|
|
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 *);
|
37 |
|
|
|
38 |
|
|
/* Generate function entry code for allocation of compiler allocated array
|
39 |
|
|
variables. */
|
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);
|
47 |
|
|
|
48 |
|
|
tree gfc_duplicate_allocatable (tree dest, tree src, tree type, int rank);
|
49 |
|
|
|
50 |
|
|
tree gfc_copy_allocatable_data (tree dest, tree src, tree type, int rank);
|
51 |
|
|
|
52 |
|
|
tree gfc_nullify_alloc_comp (gfc_symbol *, tree, int);
|
53 |
|
|
|
54 |
|
|
tree gfc_deallocate_alloc_comp (gfc_symbol *, tree, int);
|
55 |
|
|
|
56 |
|
|
tree gfc_copy_alloc_comp (gfc_symbol *, tree, tree, int);
|
57 |
|
|
|
58 |
|
|
tree gfc_copy_only_alloc_comp (gfc_symbol *, tree, tree, int);
|
59 |
|
|
|
60 |
|
|
tree gfc_alloc_allocatable_for_assignment (gfc_loopinfo*, gfc_expr*, gfc_expr*);
|
61 |
|
|
|
62 |
|
|
bool gfc_is_reallocatable_lhs (gfc_expr *);
|
63 |
|
|
|
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 *);
|
68 |
|
|
|
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 *,
|
82 |
|
|
gfc_intrinsic_sym *);
|
83 |
|
|
/* Reverse the order of an SS chain. */
|
84 |
|
|
gfc_ss *gfc_reverse_ss (gfc_ss *);
|
85 |
|
|
|
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 *);
|
102 |
|
|
|
103 |
|
|
/* Calculates the lower bound and stride of array sections. */
|
104 |
|
|
void gfc_conv_ss_startstride (gfc_loopinfo *);
|
105 |
|
|
|
106 |
|
|
void gfc_init_loopinfo (gfc_loopinfo *);
|
107 |
|
|
void gfc_copy_loopinfo_to_se (gfc_se *, gfc_loopinfo *);
|
108 |
|
|
|
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);
|
125 |
|
|
|
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 *);
|
132 |
|
|
|
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 *);
|
140 |
|
|
|
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);
|
148 |
|
|
|
149 |
|
|
/* Set cobounds of an array. */
|
150 |
|
|
void gfc_trans_array_cobounds (tree, stmtblock_t *, const gfc_symbol *);
|
151 |
|
|
|
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);
|
161 |
|
|
|
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);
|
167 |
|
|
|
168 |
|
|
/* Shift lower bound of descriptor, updating ubound and offset. */
|
169 |
|
|
void gfc_conv_shift_descriptor_lbound (stmtblock_t*, tree, int, tree);
|
170 |
|
|
|
171 |
|
|
/* Add pre-loop scalarization code for intrinsic functions which require
|
172 |
|
|
special handling. */
|
173 |
|
|
void gfc_add_intrinsic_ss_code (gfc_loopinfo *, gfc_ss *);
|
174 |
|
|
|
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);
|
178 |
|
|
|
179 |
|
|
/* Copy a string from src to dest. */
|
180 |
|
|
void gfc_trans_string_copy (stmtblock_t *, tree, tree, int, tree, tree, int);
|
181 |
|
|
|
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);
|