1 /* Language independent return value optimizations
2 Copyright (C) 2004, 2005 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GCC is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING. If not, write to
18 the Free Software Foundation, 51 Franklin Street, Fifth Floor,
19 Boston, MA 02110-1301, USA. */
23 #include "coretypes.h"
28 #include "basic-block.h"
30 #include "diagnostic.h"
31 #include "tree-flow.h"
33 #include "tree-dump.h"
34 #include "tree-pass.h"
35 #include "langhooks.h"
37 /* This file implements return value optimizations for functions which
38 return aggregate types.
40 Basically this pass searches the function for return statements which
41 return a local aggregate. When converted to RTL such statements will
42 generate a copy from the local aggregate to final return value destination
43 mandated by the target's ABI.
45 That copy can often be avoided by directly constructing the return value
46 into the final destination mandated by the target's ABI.
48 This is basically a generic equivalent to the C++ front-end's
49 Named Return Value optimization. */
53 /* This is the temporary (a VAR_DECL) which appears in all of
54 this function's RETURN_EXPR statements. */
57 /* This is the function's RESULT_DECL. We will replace all occurrences
58 of VAR with RESULT_DECL when we apply this optimization. */
62 static tree
finalize_nrv_r (tree
*, int *, void *);
64 /* Callback for the tree walker.
66 If TP refers to a RETURN_EXPR, then set the expression being returned
69 If TP refers to nrv_data->var, then replace nrv_data->var with
72 If we reach a node where we know all the subtrees are uninteresting,
73 then set *WALK_SUBTREES to zero. */
76 finalize_nrv_r (tree
*tp
, int *walk_subtrees
, void *data
)
78 struct nrv_data
*dp
= (struct nrv_data
*)data
;
80 /* No need to walk into types. */
84 /* Otherwise replace all occurrences of VAR with RESULT. */
85 else if (*tp
== dp
->var
)
92 /* Main entry point for return value optimizations.
94 If this function always returns the same local variable, and that
95 local variable is an aggregate type, then replace the variable with
96 the function's DECL_RESULT.
98 This is the equivalent of the C++ named return value optimization
99 applied to optimized trees in a language independent form. If we
100 ever encounter languages which prevent this kind of optimization,
101 then we could either have the languages register the optimization or
102 we could change the gating function to check the current language. */
107 tree result
= DECL_RESULT (current_function_decl
);
108 tree result_type
= TREE_TYPE (result
);
111 block_stmt_iterator bsi
;
112 struct nrv_data data
;
114 /* If this function does not return an aggregate type in memory, then
115 there is nothing to do. */
116 if (!aggregate_value_p (result
, current_function_decl
))
119 /* Look through each block for assignments to the RESULT_DECL. */
122 for (bsi
= bsi_start (bb
); !bsi_end_p (bsi
); bsi_next (&bsi
))
124 tree stmt
= bsi_stmt (bsi
);
127 if (TREE_CODE (stmt
) == RETURN_EXPR
)
129 /* In a function with an aggregate return value, the
130 gimplifier has changed all non-empty RETURN_EXPRs to
131 return the RESULT_DECL. */
132 ret_expr
= TREE_OPERAND (stmt
, 0);
134 gcc_assert (ret_expr
== result
);
136 else if (TREE_CODE (stmt
) == GIMPLE_MODIFY_STMT
137 && GIMPLE_STMT_OPERAND (stmt
, 0) == result
)
139 ret_expr
= GIMPLE_STMT_OPERAND (stmt
, 1);
141 /* Now verify that this return statement uses the same value
142 as any previously encountered return statement. */
145 /* If we found a return statement using a different variable
146 than previous return statements, then we can not perform
147 NRV optimizations. */
148 if (found
!= ret_expr
)
154 /* The returned value must be a local automatic variable of the
155 same type and alignment as the function's result. */
156 if (TREE_CODE (found
) != VAR_DECL
157 || TREE_THIS_VOLATILE (found
)
158 || DECL_CONTEXT (found
) != current_function_decl
159 || TREE_STATIC (found
)
160 || TREE_ADDRESSABLE (found
)
161 || DECL_ALIGN (found
) > DECL_ALIGN (result
)
162 || !lang_hooks
.types_compatible_p (TREE_TYPE (found
),
172 /* If dumping details, then note once and only the NRV replacement. */
173 if (dump_file
&& (dump_flags
& TDF_DETAILS
))
175 fprintf (dump_file
, "NRV Replaced: ");
176 print_generic_expr (dump_file
, found
, dump_flags
);
177 fprintf (dump_file
, " with: ");
178 print_generic_expr (dump_file
, result
, dump_flags
);
179 fprintf (dump_file
, "\n");
182 /* At this point we know that all the return statements return the
183 same local which has suitable attributes for NRV. Copy debugging
184 information from FOUND to RESULT. */
185 DECL_NAME (result
) = DECL_NAME (found
);
186 DECL_SOURCE_LOCATION (result
) = DECL_SOURCE_LOCATION (found
);
187 DECL_ABSTRACT_ORIGIN (result
) = DECL_ABSTRACT_ORIGIN (found
);
188 TREE_ADDRESSABLE (result
) = TREE_ADDRESSABLE (found
);
190 /* Now walk through the function changing all references to VAR to be
193 data
.result
= result
;
196 for (bsi
= bsi_start (bb
); !bsi_end_p (bsi
); )
198 tree
*tp
= bsi_stmt_ptr (bsi
);
199 /* If this is a copy from VAR to RESULT, remove it. */
200 if (TREE_CODE (*tp
) == GIMPLE_MODIFY_STMT
201 && GIMPLE_STMT_OPERAND (*tp
, 0) == result
202 && GIMPLE_STMT_OPERAND (*tp
, 1) == found
)
203 bsi_remove (&bsi
, true);
206 walk_tree (tp
, finalize_nrv_r
, &data
, 0);
212 /* FOUND is no longer used. Ensure it gets removed. */
213 var_ann (found
)->used
= 0;
217 struct tree_opt_pass pass_nrv
=
221 tree_nrv
, /* execute */
224 0, /* static_pass_number */
225 TV_TREE_NRV
, /* tv_id */
226 PROP_cfg
, /* properties_required */
227 0, /* properties_provided */
228 0, /* properties_destroyed */
229 0, /* todo_flags_start */
230 TODO_dump_func
| TODO_ggc_collect
, /* todo_flags_finish */
234 /* Determine (pessimistically) whether DEST is available for NRV
235 optimization, where DEST is expected to be the LHS of a modify
236 expression where the RHS is a function returning an aggregate.
238 We search for a base VAR_DECL and look to see if it, or any of its
239 subvars are clobbered. Note that we could do better, for example, by
240 attempting to doing points-to analysis on INDIRECT_REFs. */
243 dest_safe_for_nrv_p (tree dest
)
245 switch (TREE_CODE (dest
))
250 if (is_call_clobbered (dest
))
252 for (subvar
= get_subvars_for_var (dest
);
254 subvar
= subvar
->next
)
255 if (is_call_clobbered (subvar
->var
))
261 return dest_safe_for_nrv_p (TREE_OPERAND (dest
, 0));
267 /* Walk through the function looking for GIMPLE_MODIFY_STMTs with calls that
268 return in memory on the RHS. For each of these, determine whether it is
269 safe to pass the address of the LHS as the return slot, and mark the
270 call appropriately if so.
272 The NRV shares the return slot with a local variable in the callee; this
273 optimization shares the return slot with the target of the call within
274 the caller. If the NRV is performed (which we can't know in general),
275 this optimization is safe if the address of the target has not
276 escaped prior to the call. If it has, modifications to the local
277 variable will produce visible changes elsewhere, as in PR c++/19317. */
280 execute_return_slot_opt (void)
286 block_stmt_iterator i
;
287 for (i
= bsi_start (bb
); !bsi_end_p (i
); bsi_next (&i
))
289 tree stmt
= bsi_stmt (i
);
292 if (TREE_CODE (stmt
) == GIMPLE_MODIFY_STMT
293 && (call
= GIMPLE_STMT_OPERAND (stmt
, 1),
294 TREE_CODE (call
) == CALL_EXPR
)
295 && !CALL_EXPR_RETURN_SLOT_OPT (call
)
296 && aggregate_value_p (call
, call
))
297 /* Check if the location being assigned to is
299 CALL_EXPR_RETURN_SLOT_OPT (call
) =
300 dest_safe_for_nrv_p (GIMPLE_STMT_OPERAND (stmt
, 0)) ? 1 : 0;
306 struct tree_opt_pass pass_return_slot
=
308 "retslot", /* name */
310 execute_return_slot_opt
, /* execute */
313 0, /* static_pass_number */
315 PROP_ssa
| PROP_alias
, /* properties_required */
316 0, /* properties_provided */
317 0, /* properties_destroyed */
318 0, /* todo_flags_start */
319 0, /* todo_flags_finish */