1 /* Language independent return value optimizations
2 Copyright (C) 2004-2013 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 3, 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 COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
22 #include "coretypes.h"
26 #include "basic-block.h"
27 #include "tree-pretty-print.h"
29 #include "gimple-iterator.h"
30 #include "gimple-walk.h"
31 #include "gimple-ssa.h"
32 #include "stringpool.h"
33 #include "tree-ssanames.h"
34 #include "tree-pass.h"
35 #include "langhooks.h"
36 #include "flags.h" /* For "optimize" in gate_pass_return_slot.
37 FIXME: That should be up to the pass manager,
38 but pass_nrv is not in pass_all_optimizations. */
40 /* This file implements return value optimizations for functions which
41 return aggregate types.
43 Basically this pass searches the function for return statements which
44 return a local aggregate. When converted to RTL such statements will
45 generate a copy from the local aggregate to final return value destination
46 mandated by the target's ABI.
48 That copy can often be avoided by directly constructing the return value
49 into the final destination mandated by the target's ABI.
51 This is basically a generic equivalent to the C++ front-end's
52 Named Return Value optimization. */
56 /* This is the temporary (a VAR_DECL) which appears in all of
57 this function's RETURN_EXPR statements. */
60 /* This is the function's RESULT_DECL. We will replace all occurrences
61 of VAR with RESULT_DECL when we apply this optimization. */
66 static tree
finalize_nrv_r (tree
*, int *, void *);
68 /* Callback for the tree walker.
70 If TP refers to a RETURN_EXPR, then set the expression being returned
73 If TP refers to nrv_data->var, then replace nrv_data->var with
76 If we reach a node where we know all the subtrees are uninteresting,
77 then set *WALK_SUBTREES to zero. */
80 finalize_nrv_r (tree
*tp
, int *walk_subtrees
, void *data
)
82 struct walk_stmt_info
*wi
= (struct walk_stmt_info
*) data
;
83 struct nrv_data
*dp
= (struct nrv_data
*) wi
->info
;
85 /* No need to walk into types. */
89 /* Otherwise replace all occurrences of VAR with RESULT. */
90 else if (*tp
== dp
->var
)
100 /* Main entry point for return value optimizations.
102 If this function always returns the same local variable, and that
103 local variable is an aggregate type, then replace the variable with
104 the function's DECL_RESULT.
106 This is the equivalent of the C++ named return value optimization
107 applied to optimized trees in a language independent form. If we
108 ever encounter languages which prevent this kind of optimization,
109 then we could either have the languages register the optimization or
110 we could change the gating function to check the current language. */
115 tree result
= DECL_RESULT (current_function_decl
);
116 tree result_type
= TREE_TYPE (result
);
119 gimple_stmt_iterator gsi
;
120 struct nrv_data data
;
122 /* If this function does not return an aggregate type in memory, then
123 there is nothing to do. */
124 if (!aggregate_value_p (result
, current_function_decl
))
127 /* If a GIMPLE type is returned in memory, finalize_nrv_r might create
129 if (is_gimple_reg_type (result_type
))
132 /* If the front end already did something like this, don't do it here. */
133 if (DECL_NAME (result
))
136 /* If the result has its address taken then it might be modified
137 by means not detected in the following loop. Bail out in this
139 if (TREE_ADDRESSABLE (result
))
142 /* Look through each block for assignments to the RESULT_DECL. */
145 for (gsi
= gsi_start_bb (bb
); !gsi_end_p (gsi
); gsi_next (&gsi
))
147 gimple stmt
= gsi_stmt (gsi
);
150 if (gimple_code (stmt
) == GIMPLE_RETURN
)
152 /* In a function with an aggregate return value, the
153 gimplifier has changed all non-empty RETURN_EXPRs to
154 return the RESULT_DECL. */
155 ret_val
= gimple_return_retval (stmt
);
157 gcc_assert (ret_val
== result
);
159 else if (gimple_has_lhs (stmt
)
160 && gimple_get_lhs (stmt
) == result
)
164 if (!gimple_assign_copy_p (stmt
))
167 rhs
= gimple_assign_rhs1 (stmt
);
169 /* Now verify that this return statement uses the same value
170 as any previously encountered return statement. */
173 /* If we found a return statement using a different variable
174 than previous return statements, then we can not perform
175 NRV optimizations. */
182 /* The returned value must be a local automatic variable of the
183 same type and alignment as the function's result. */
184 if (TREE_CODE (found
) != VAR_DECL
185 || TREE_THIS_VOLATILE (found
)
186 || DECL_CONTEXT (found
) != current_function_decl
187 || TREE_STATIC (found
)
188 || TREE_ADDRESSABLE (found
)
189 || DECL_ALIGN (found
) > DECL_ALIGN (result
)
190 || !useless_type_conversion_p (result_type
,
194 else if (gimple_has_lhs (stmt
))
196 tree addr
= get_base_address (gimple_get_lhs (stmt
));
197 /* If there's any MODIFY of component of RESULT,
199 if (addr
&& addr
== result
)
208 /* If dumping details, then note once and only the NRV replacement. */
209 if (dump_file
&& (dump_flags
& TDF_DETAILS
))
211 fprintf (dump_file
, "NRV Replaced: ");
212 print_generic_expr (dump_file
, found
, dump_flags
);
213 fprintf (dump_file
, " with: ");
214 print_generic_expr (dump_file
, result
, dump_flags
);
215 fprintf (dump_file
, "\n");
218 /* At this point we know that all the return statements return the
219 same local which has suitable attributes for NRV. Copy debugging
220 information from FOUND to RESULT if it will be useful. But don't set
221 DECL_ABSTRACT_ORIGIN to point at another function. */
222 if (!DECL_IGNORED_P (found
)
223 && !(DECL_ABSTRACT_ORIGIN (found
)
224 && DECL_CONTEXT (DECL_ABSTRACT_ORIGIN (found
)) != current_function_decl
))
226 DECL_NAME (result
) = DECL_NAME (found
);
227 DECL_SOURCE_LOCATION (result
) = DECL_SOURCE_LOCATION (found
);
228 DECL_ABSTRACT_ORIGIN (result
) = DECL_ABSTRACT_ORIGIN (found
);
231 TREE_ADDRESSABLE (result
) |= TREE_ADDRESSABLE (found
);
233 /* Now walk through the function changing all references to VAR to be
236 data
.result
= result
;
239 for (gsi
= gsi_start_bb (bb
); !gsi_end_p (gsi
); )
241 gimple stmt
= gsi_stmt (gsi
);
242 /* If this is a copy from VAR to RESULT, remove it. */
243 if (gimple_assign_copy_p (stmt
)
244 && gimple_assign_lhs (stmt
) == result
245 && gimple_assign_rhs1 (stmt
) == found
)
247 unlink_stmt_vdef (stmt
);
248 gsi_remove (&gsi
, true);
253 struct walk_stmt_info wi
;
254 memset (&wi
, 0, sizeof (wi
));
257 walk_gimple_op (stmt
, finalize_nrv_r
, &wi
);
265 SET_DECL_VALUE_EXPR (found
, result
);
266 DECL_HAS_VALUE_EXPR_P (found
) = 1;
272 gate_pass_return_slot (void)
279 const pass_data pass_data_nrv
=
281 GIMPLE_PASS
, /* type */
283 OPTGROUP_NONE
, /* optinfo_flags */
285 true, /* has_execute */
286 TV_TREE_NRV
, /* tv_id */
287 ( PROP_ssa
| PROP_cfg
), /* properties_required */
288 0, /* properties_provided */
289 0, /* properties_destroyed */
290 0, /* todo_flags_start */
291 0, /* todo_flags_finish */
294 class pass_nrv
: public gimple_opt_pass
297 pass_nrv (gcc::context
*ctxt
)
298 : gimple_opt_pass (pass_data_nrv
, ctxt
)
301 /* opt_pass methods: */
302 bool gate () { return gate_pass_return_slot (); }
303 unsigned int execute () { return tree_nrv (); }
310 make_pass_nrv (gcc::context
*ctxt
)
312 return new pass_nrv (ctxt
);
315 /* Determine (pessimistically) whether DEST is available for NRV
316 optimization, where DEST is expected to be the LHS of a modify
317 expression where the RHS is a function returning an aggregate.
319 DEST is available if it is not clobbered or used by the call. */
322 dest_safe_for_nrv_p (gimple call
)
324 tree dest
= gimple_call_lhs (call
);
326 dest
= get_base_address (dest
);
330 if (TREE_CODE (dest
) == SSA_NAME
)
333 if (call_may_clobber_ref_p (call
, dest
)
334 || ref_maybe_used_by_stmt_p (call
, dest
))
340 /* Walk through the function looking for GIMPLE_ASSIGNs with calls that
341 return in memory on the RHS. For each of these, determine whether it is
342 safe to pass the address of the LHS as the return slot, and mark the
343 call appropriately if so.
345 The NRV shares the return slot with a local variable in the callee; this
346 optimization shares the return slot with the target of the call within
347 the caller. If the NRV is performed (which we can't know in general),
348 this optimization is safe if the address of the target has not
349 escaped prior to the call. If it has, modifications to the local
350 variable will produce visible changes elsewhere, as in PR c++/19317. */
353 execute_return_slot_opt (void)
359 gimple_stmt_iterator gsi
;
360 for (gsi
= gsi_start_bb (bb
); !gsi_end_p (gsi
); gsi_next (&gsi
))
362 gimple stmt
= gsi_stmt (gsi
);
365 if (is_gimple_call (stmt
)
366 && gimple_call_lhs (stmt
)
367 && !gimple_call_return_slot_opt_p (stmt
)
368 && aggregate_value_p (TREE_TYPE (gimple_call_lhs (stmt
)),
369 gimple_call_fndecl (stmt
)))
371 /* Check if the location being assigned to is
372 clobbered by the call. */
373 slot_opt_p
= dest_safe_for_nrv_p (stmt
);
374 gimple_call_set_return_slot_opt (stmt
, slot_opt_p
);
383 const pass_data pass_data_return_slot
=
385 GIMPLE_PASS
, /* type */
386 "retslot", /* name */
387 OPTGROUP_NONE
, /* optinfo_flags */
388 false, /* has_gate */
389 true, /* has_execute */
391 PROP_ssa
, /* properties_required */
392 0, /* properties_provided */
393 0, /* properties_destroyed */
394 0, /* todo_flags_start */
395 0, /* todo_flags_finish */
398 class pass_return_slot
: public gimple_opt_pass
401 pass_return_slot (gcc::context
*ctxt
)
402 : gimple_opt_pass (pass_data_return_slot
, ctxt
)
405 /* opt_pass methods: */
406 unsigned int execute () { return execute_return_slot_opt (); }
408 }; // class pass_return_slot
413 make_pass_return_slot (gcc::context
*ctxt
)
415 return new pass_return_slot (ctxt
);