1 /* Header for array handling functions
2 Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007 Free Software
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 2, 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 COPYING. If not, write to the Free
20 Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
23 /* Generate code to free an array. */
24 tree gfc_array_deallocate (tree, tree);
26 /* Generate code to initialize an allocate an array. Statements are added to
27 se, which should contain an expression for the array descriptor. */
28 bool gfc_array_allocate (gfc_se *, gfc_expr *, tree);
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_loopinfo *,
36 gfc_ss_info *, tree, bool, bool, bool);
38 /* Generate function entry code for allocation of compiler allocated array
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);
48 tree gfc_duplicate_allocatable(tree dest, tree src, tree type, int rank);
50 tree gfc_nullify_alloc_comp (gfc_symbol *, tree, int);
52 tree gfc_deallocate_alloc_comp (gfc_symbol *, tree, int);
54 tree gfc_copy_alloc_comp (gfc_symbol *, tree, tree, int);
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 *);
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 *,
66 /* Walk an intrinsic function. */
67 gfc_ss *gfc_walk_intrinsic_function (gfc_ss *, gfc_expr *,
69 /* Reverse the order of an SS chain. */
70 gfc_ss *gfc_reverse_ss (gfc_ss *);
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);
79 /* Calculates the lower bound and stride of array sections. */
80 void gfc_conv_ss_startstride (gfc_loopinfo *);
82 void gfc_init_loopinfo (gfc_loopinfo *);
83 void gfc_copy_loopinfo_to_se (gfc_se *, gfc_loopinfo *);
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 *);
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);
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 *);
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 /* Evaluate and transpose a matrix expression. */
110 void gfc_conv_array_transpose (gfc_se *, gfc_expr *);
112 /* These work with both descriptors and descriptorless arrays. */
113 tree gfc_conv_array_data (tree);
114 tree gfc_conv_array_offset (tree);
115 /* Return either an INT_CST or an expression for that part of the descriptor. */
116 tree gfc_conv_array_stride (tree, int);
117 tree gfc_conv_array_lbound (tree, int);
118 tree gfc_conv_array_ubound (tree, int);
120 /* Build expressions for accessing components of an array descriptor. */
121 tree gfc_conv_descriptor_data_get (tree);
122 void gfc_conv_descriptor_data_set_internal (stmtblock_t *, tree, tree, bool);
123 #define gfc_conv_descriptor_data_set(BLOCK, T1, T2) \
124 gfc_conv_descriptor_data_set_internal ((BLOCK), (T1), (T2), false)
125 #define gfc_conv_descriptor_data_set_tuples(BLOCK, T1, T2) \
126 gfc_conv_descriptor_data_set_internal ((BLOCK), (T1), (T2), true)
127 tree gfc_conv_descriptor_data_addr (tree);
128 tree gfc_conv_descriptor_offset (tree);
129 tree gfc_conv_descriptor_dtype (tree);
130 tree gfc_conv_descriptor_stride (tree, tree);
131 tree gfc_conv_descriptor_lbound (tree, tree);
132 tree gfc_conv_descriptor_ubound (tree, tree);
134 /* Add pre-loop scalarization code for intrinsic functions which require
136 void gfc_add_intrinsic_ss_code (gfc_loopinfo *, gfc_ss *);
138 /* Functions for constant array constructor processing. */
139 unsigned HOST_WIDE_INT gfc_constant_array_constructor_p (gfc_constructor *);
140 tree gfc_build_constant_array_constructor (gfc_expr *, tree);