1 /* This file contains the definitions and documentation for the common
2 tree codes used in the GNU C and C++ compilers (see c-common.def
3 for the standard codes).
4 Copyright (C) 2000 Free Software Foundation, Inc. Written by
5 Benjamin Chelf (chelf@codesourcery.com).
7 This file is part of GNU CC.
9 GNU CC is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2, or (at your option)
14 GNU CC is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with GNU CC; see the file COPYING. If not, write to
21 the Free Software Foundation, 59 Temple Place - Suite 330,
22 Boston, MA 02111-1307, USA. */
28 #include "splay-tree.h"
39 /* If non-NULL, the address of a language-specific function for
40 expanding statements. */
41 void (*lang_expand_stmt
) PARAMS ((tree
));
43 /* If non-NULL, the address of a language-specific function for
44 expanding a DECL_STMT. After the language-independent cases are
45 handled, this function will be called. If this function is not
46 defined, it is assumed that declarations other than those for
47 variables and labels do not require any RTL generation. */
48 void (*lang_expand_decl_stmt
) PARAMS ((tree
));
50 static tree prune_unused_decls
PARAMS ((tree
*, int *, void *));
52 /* Create an empty statement tree rooted at T. */
58 /* We create a trivial EXPR_STMT so that last_tree is never NULL in
59 what follows. We remove the extraneous statement in
61 *t
= build_nt (EXPR_STMT
, void_zero_node
);
63 last_expr_type
= NULL_TREE
;
66 /* T is a statement. Add it to the statement-tree. */
72 /* Add T to the statement-tree. */
73 TREE_CHAIN (last_tree
) = t
;
75 /* When we expand a statement-tree, we must know whether or not the
76 statements are full-expresions. We record that fact here. */
77 STMT_IS_FULL_EXPR_P (last_tree
) = stmts_are_full_exprs_p ();
81 /* Create a declaration statement for the declaration given by the
90 /* We need the type to last until instantiation time. */
91 decl_stmt
= build_stmt (DECL_STMT
, decl
);
95 /* Add a scope-statement to the statement-tree. BEGIN_P indicates
96 whether this statements opens or closes a scope. PARTIAL_P is true
97 for a partial scope, i.e, the scope that begins after a label when
98 an object that needs a cleanup is created. If BEGIN_P is nonzero,
99 returns a new TREE_LIST representing the top of the SCOPE_STMT
100 stack. The TREE_PURPOSE is the new SCOPE_STMT. If BEGIN_P is
101 zero, returns a TREE_LIST whose TREE_VALUE is the new SCOPE_STMT,
102 and whose TREE_PURPOSE is the matching SCOPE_STMT iwth
103 SCOPE_BEGIN_P set. */
106 add_scope_stmt (begin_p
, partial_p
)
113 /* Build the statement. */
114 ss
= build_stmt (SCOPE_STMT
, NULL_TREE
);
115 SCOPE_BEGIN_P (ss
) = begin_p
;
116 SCOPE_PARTIAL_P (ss
) = partial_p
;
118 /* Keep the scope stack up to date. */
121 *current_scope_stmt_stack ()
122 = tree_cons (ss
, NULL_TREE
, *current_scope_stmt_stack ());
123 top
= *current_scope_stmt_stack ();
127 top
= *current_scope_stmt_stack ();
128 TREE_VALUE (top
) = ss
;
129 *current_scope_stmt_stack () = TREE_CHAIN (top
);
132 /* Add the new statement to the statement-tree. */
138 /* Remove declarations of internal variables that are not used from a
139 stmt tree. To qualify, the variable must have a name and must have
140 a zero DECL_SOURCE_LINE. We tried to remove all variables for
141 which TREE_USED was false, but it turns out that there's tons of
142 variables for which TREE_USED is false but that are still in fact
146 prune_unused_decls (tp
, walk_subtrees
, data
)
148 int *walk_subtrees ATTRIBUTE_UNUSED
;
149 void *data ATTRIBUTE_UNUSED
;
159 if (TREE_CODE (t
) == DECL_STMT
)
161 tree d
= DECL_STMT_DECL (t
);
162 if (!TREE_USED (d
) && DECL_NAME (d
) && DECL_SOURCE_LINE (d
) == 0)
164 *tp
= TREE_CHAIN (t
);
165 /* Recurse on the new value of tp, otherwise we will skip
166 the next statement. */
167 return prune_unused_decls (tp
, walk_subtrees
, data
);
170 else if (TREE_CODE (t
) == SCOPE_STMT
)
172 /* Remove all unused decls from the BLOCK of this SCOPE_STMT. */
173 tree block
= SCOPE_STMT_BLOCK (t
);
179 for (vp
= &BLOCK_VARS (block
); *vp
; )
182 if (! TREE_USED (v
) && DECL_NAME (v
) && DECL_SOURCE_LINE (v
) == 0)
183 *vp
= TREE_CHAIN (v
); /* drop */
185 vp
= &TREE_CHAIN (v
); /* advance */
187 /* If there are now no variables, the entire BLOCK can be dropped.
188 (This causes SCOPE_NULLIFIED_P (t) to be true.) */
189 if (BLOCK_VARS (block
) == NULL_TREE
)
190 SCOPE_STMT_BLOCK (t
) = NULL_TREE
;
196 /* Finish the statement tree rooted at T. */
204 /* Remove the fake extra statement added in begin_stmt_tree. */
205 stmt
= TREE_CHAIN (*t
);
207 last_tree
= NULL_TREE
;
209 /* Remove unused decls from the stmt tree. */
210 walk_stmt_tree (t
, prune_unused_decls
, NULL
);
214 /* The line-number recorded in the outermost statement in a function
215 is the line number of the end of the function. */
216 STMT_LINENO (stmt
) = lineno
;
217 STMT_LINENO_FOR_FN_P (stmt
) = 1;
221 /* Build a generic statement based on the given type of node and
222 arguments. Similar to `build_nt', except that we set
223 TREE_COMPLEXITY to be the current line number. */
226 build_stmt
VPARAMS ((enum tree_code code
, ...))
228 #ifndef ANSI_PROTOTYPES
238 #ifndef ANSI_PROTOTYPES
239 code
= va_arg (p
, enum tree_code
);
242 t
= make_node (code
);
243 length
= TREE_CODE_LENGTH (code
);
244 TREE_COMPLEXITY (t
) = lineno
;
246 for (i
= 0; i
< length
; i
++)
247 TREE_OPERAND (t
, i
) = va_arg (p
, tree
);
253 /* Some statements, like for-statements or if-statements, require a
254 condition. This condition can be a declaration. If T is such a
255 declaration it is processed, and an expression appropriate to use
256 as the condition is returned. Otherwise, T itself is returned. */
262 if (t
&& TREE_CODE (t
) == TREE_LIST
)
264 expand_stmt (TREE_PURPOSE (t
));
265 return TREE_VALUE (t
);
271 /* Create RTL for the local static variable DECL. */
274 make_rtl_for_local_static (decl
)
277 const char *asmspec
= NULL
;
279 /* If we inlined this variable, we could see it's declaration
281 if (TREE_ASM_WRITTEN (decl
))
284 /* If the DECL_ASSEMBLER_NAME is not the same as the DECL_NAME, then
285 either we already created RTL for this DECL (and since it was a
286 local variable, its DECL_ASSEMBLER_NAME got hacked up to prevent
287 clashes with other local statics with the same name by a previous
288 call to make_decl_rtl), or the user explicitly requested a
289 particular assembly name for this variable, using the GNU
290 extension for this purpose:
294 There's no way to know which case we're in, here. But, it turns
295 out we're safe. If there's already RTL, then
296 rest_of_decl_compilation ignores the ASMSPEC parameter, so we
297 may as well not pass it in. If there isn't RTL, then we didn't
298 already create RTL, which means that the modification to
299 DECL_ASSEMBLER_NAME came only via the explicit extension. */
300 if (DECL_ASSEMBLER_NAME (decl
) != DECL_NAME (decl
)
302 asmspec
= IDENTIFIER_POINTER (DECL_ASSEMBLER_NAME (decl
));
304 rest_of_decl_compilation (decl
, asmspec
, /*top_level=*/0, /*at_end=*/0);
307 /* Let the back-end know about DECL. */
310 emit_local_var (decl
)
313 /* Create RTL for this variable. */
314 if (!DECL_RTL (decl
))
316 if (DECL_C_HARD_REGISTER (decl
))
317 /* The user specified an assembler name for this variable.
319 rest_of_decl_compilation
320 (decl
, IDENTIFIER_POINTER (DECL_ASSEMBLER_NAME (decl
)),
321 /*top_level=*/0, /*at_end=*/0);
326 /* Actually do the initialization. */
327 if (stmts_are_full_exprs_p ())
328 expand_start_target_temps ();
330 expand_decl_init (decl
);
332 if (stmts_are_full_exprs_p ())
333 expand_end_target_temps ();
336 /* Helper for generating the RTL at the beginning of a scope. */
339 genrtl_do_pushlevel ()
341 emit_line_note (input_filename
, lineno
);
345 /* Generate the RTL for DESTINATION, which is a GOTO_STMT. */
348 genrtl_goto_stmt (destination
)
351 if (TREE_CODE (destination
) == IDENTIFIER_NODE
)
354 /* We warn about unused labels with -Wunused. That means we have to
355 mark the used labels as used. */
356 if (TREE_CODE (destination
) == LABEL_DECL
)
357 TREE_USED (destination
) = 1;
359 emit_line_note (input_filename
, lineno
);
361 if (TREE_CODE (destination
) == LABEL_DECL
)
363 label_rtx (destination
);
364 expand_goto (destination
);
367 expand_computed_goto (destination
);
370 /* Generate the RTL for EXPR, which is an EXPR_STMT. */
373 genrtl_expr_stmt (expr
)
376 if (expr
!= NULL_TREE
)
378 emit_line_note (input_filename
, lineno
);
380 if (stmts_are_full_exprs_p ())
381 expand_start_target_temps ();
383 if (expr
!= error_mark_node
)
384 expand_expr_stmt (expr
);
386 if (stmts_are_full_exprs_p ())
387 expand_end_target_temps ();
391 /* Generate the RTL for T, which is a DECL_STMT. */
398 emit_line_note (input_filename
, lineno
);
399 decl
= DECL_STMT_DECL (t
);
400 /* If this is a declaration for an automatic local
401 variable, initialize it. Note that we might also see a
402 declaration for a namespace-scope object (declared with
403 `extern'). We don't have to handle the initialization
404 of those objects here; they can only be declarations,
405 rather than definitions. */
406 if (TREE_CODE (decl
) == VAR_DECL
407 && !TREE_STATIC (decl
)
408 && !DECL_EXTERNAL (decl
))
410 /* Let the back-end know about this variable. */
411 if (!anon_aggr_type_p (TREE_TYPE (decl
)))
412 emit_local_var (decl
);
414 expand_anon_union_decl (decl
, NULL_TREE
,
415 DECL_ANON_UNION_ELEMS (decl
));
417 else if (TREE_CODE (decl
) == VAR_DECL
&& TREE_STATIC (decl
))
419 if (DECL_ARTIFICIAL (decl
) && ! TREE_USED (decl
))
420 /* Do not emit unused decls. This is not just an
421 optimization. We really do not want to emit
422 __PRETTY_FUNCTION__ etc, if they're never used. */
423 DECL_IGNORED_P (decl
) = 1;
425 make_rtl_for_local_static (decl
);
427 else if (TREE_CODE (decl
) == LABEL_DECL
428 && C_DECLARED_LABEL_FLAG (decl
))
429 declare_nonlocal_label (decl
);
430 else if (lang_expand_decl_stmt
)
431 (*lang_expand_decl_stmt
) (t
);
434 /* Generate the RTL for T, which is an IF_STMT. */
441 genrtl_do_pushlevel ();
442 cond
= expand_cond (IF_COND (t
));
443 emit_line_note (input_filename
, lineno
);
444 expand_start_cond (cond
, 0);
446 expand_stmt (THEN_CLAUSE (t
));
449 expand_start_else ();
450 expand_stmt (ELSE_CLAUSE (t
));
455 /* Generate the RTL for T, which is a WHILE_STMT. */
458 genrtl_while_stmt (t
)
463 emit_line_note (input_filename
, lineno
);
464 expand_start_loop (1);
465 genrtl_do_pushlevel ();
467 cond
= expand_cond (WHILE_COND (t
));
468 emit_line_note (input_filename
, lineno
);
469 expand_exit_loop_if_false (0, cond
);
470 genrtl_do_pushlevel ();
472 expand_stmt (WHILE_BODY (t
));
477 /* Generate the RTL for T, which is a DO_STMT. */
483 tree cond
= DO_COND (t
);
485 /* Recognize the common special-case of do { ... } while (0) and do
486 not emit the loop widgetry in this case. In particular this
487 avoids cluttering the rtl with dummy loop notes, which can affect
488 alignment of adjacent labels. */
489 if (integer_zerop (cond
))
491 expand_start_null_loop ();
492 expand_stmt (DO_BODY (t
));
493 expand_end_null_loop ();
498 emit_line_note (input_filename
, lineno
);
499 expand_start_loop_continue_elsewhere (1);
501 expand_stmt (DO_BODY (t
));
503 expand_loop_continue_here ();
504 cond
= expand_cond (cond
);
505 emit_line_note (input_filename
, lineno
);
506 expand_exit_loop_if_false (0, cond
);
511 /* Build the node for a return statement and return it. */
514 build_return_stmt (expr
)
517 return (build_stmt (RETURN_STMT
, expr
));
520 /* Generate the RTL for STMT, which is a RETURN_STMT. */
523 genrtl_return_stmt (stmt
)
526 tree expr
= RETURN_EXPR (stmt
);
528 emit_line_note (input_filename
, lineno
);
530 expand_null_return ();
533 expand_start_target_temps ();
534 expand_return (expr
);
535 expand_end_target_temps ();
539 /* Generate the RTL for T, which is a FOR_STMT. */
546 const char *saved_filename
;
549 if (NEW_FOR_SCOPE_P (t
))
550 genrtl_do_pushlevel ();
552 expand_stmt (FOR_INIT_STMT (t
));
554 /* Expand the initialization. */
556 emit_line_note (input_filename
, lineno
);
557 expand_start_loop_continue_elsewhere (1);
558 genrtl_do_pushlevel ();
559 cond
= expand_cond (FOR_COND (t
));
561 /* Save the filename and line number so that we expand the FOR_EXPR
562 we can reset them back to the saved values. */
563 saved_filename
= input_filename
;
564 saved_lineno
= lineno
;
566 /* Expand the condition. */
567 emit_line_note (input_filename
, lineno
);
569 expand_exit_loop_if_false (0, cond
);
571 /* Expand the body. */
572 genrtl_do_pushlevel ();
573 expand_stmt (FOR_BODY (t
));
575 /* Expand the increment expression. */
576 input_filename
= saved_filename
;
577 lineno
= saved_lineno
;
578 emit_line_note (input_filename
, lineno
);
579 expand_loop_continue_here ();
581 genrtl_expr_stmt (FOR_EXPR (t
));
585 /* Build a break statement node and return it. */
590 return (build_stmt (BREAK_STMT
));
593 /* Generate the RTL for a BREAK_STMT. */
598 emit_line_note (input_filename
, lineno
);
599 if ( ! expand_exit_something ())
600 error ("break statement not within loop or switch");
603 /* Build a continue statement node and return it. */
606 build_continue_stmt ()
608 return (build_stmt (CONTINUE_STMT
));
611 /* Generate the RTL for a CONTINUE_STMT. */
614 genrtl_continue_stmt ()
616 emit_line_note (input_filename
, lineno
);
617 if (! expand_continue_loop (0))
618 error ("continue statement not within a loop");
621 /* Generate the RTL for T, which is a SCOPE_STMT. */
624 genrtl_scope_stmt (t
)
627 if (!SCOPE_NO_CLEANUPS_P (t
))
629 if (SCOPE_BEGIN_P (t
))
630 expand_start_bindings_and_block (2 * SCOPE_NULLIFIED_P (t
),
631 SCOPE_STMT_BLOCK (t
));
632 else if (SCOPE_END_P (t
))
633 expand_end_bindings (NULL_TREE
, !SCOPE_NULLIFIED_P (t
), 0);
635 else if (!SCOPE_NULLIFIED_P (t
))
637 rtx note
= emit_note (NULL
,
639 ? NOTE_INSN_BLOCK_BEG
640 : NOTE_INSN_BLOCK_END
));
641 NOTE_BLOCK (note
) = SCOPE_STMT_BLOCK (t
);
645 /* Generate the RTL for T, which is a SWITCH_STMT. */
648 genrtl_switch_stmt (t
)
652 genrtl_do_pushlevel ();
654 cond
= expand_cond (SWITCH_COND (t
));
655 if (cond
== error_mark_node
)
656 /* The code is in error, but we don't want expand_end_case to
658 cond
= boolean_false_node
;
660 emit_line_note (input_filename
, lineno
);
661 expand_start_case (1, cond
, TREE_TYPE (cond
), "switch statement");
662 expand_stmt (SWITCH_BODY (t
));
663 expand_end_case (cond
);
666 /* Create a CASE_LABEL tree node and return it. */
669 build_case_label (low_value
, high_value
, label_decl
)
674 return build_stmt (CASE_LABEL
, low_value
, high_value
, label_decl
);
678 /* Generate the RTL for a CASE_LABEL. */
681 genrtl_case_label (case_label
)
687 cleanup
= last_cleanup_this_contour ();
690 static int explained
= 0;
691 warning_with_decl (TREE_PURPOSE (cleanup
),
692 "destructor needed for `%#D'");
693 warning ("where case label appears here");
696 warning ("(enclose actions of previous case statements requiring destructors in their own scope.)");
701 add_case_node (CASE_LOW (case_label
), CASE_HIGH (case_label
),
702 CASE_LABEL_DECL (case_label
), &duplicate
);
705 /* Generate the RTL for T, which is a COMPOUND_STMT. */
708 genrtl_compound_stmt (t
)
711 expand_stmt (COMPOUND_BODY (t
));
714 /* Generate the RTL for an ASM_STMT. */
717 genrtl_asm_stmt (cv_qualifier
, string
, output_operands
,
718 input_operands
, clobbers
)
721 tree output_operands
;
725 if (cv_qualifier
!= NULL_TREE
726 && cv_qualifier
!= ridpointers
[(int) RID_VOLATILE
])
728 warning ("%s qualifier ignored on asm",
729 IDENTIFIER_POINTER (cv_qualifier
));
730 cv_qualifier
= NULL_TREE
;
733 emit_line_note (input_filename
, lineno
);
734 if (output_operands
!= NULL_TREE
|| input_operands
!= NULL_TREE
735 || clobbers
!= NULL_TREE
)
736 c_expand_asm_operands (string
, output_operands
,
739 cv_qualifier
!= NULL_TREE
,
740 input_filename
, lineno
);
745 /* Generate the RTL for a DECL_CLEANUP. */
748 genrtl_decl_cleanup (decl
, cleanup
)
752 if (!decl
|| (DECL_SIZE (decl
) && TREE_TYPE (decl
) != error_mark_node
))
753 expand_decl_cleanup (decl
, cleanup
);
756 /* We're about to expand T, a statement. Set up appropriate context
757 for the substitution. */
763 if (!STMT_LINENO_FOR_FN_P (t
))
764 lineno
= STMT_LINENO (t
);
765 current_stmt_tree ()->stmts_are_full_exprs_p
= STMT_IS_FULL_EXPR_P (t
);
768 /* Generate the RTL for the statement T, its substatements, and any
769 other statements at its nesting level. */
775 while (t
&& t
!= error_mark_node
)
777 int saved_stmts_are_full_exprs_p
;
779 /* Set up context appropriately for handling this statement. */
780 saved_stmts_are_full_exprs_p
= stmts_are_full_exprs_p ();
783 switch (TREE_CODE (t
))
786 genrtl_return_stmt (t
);
790 genrtl_expr_stmt (EXPR_STMT_EXPR (t
));
794 genrtl_decl_stmt (t
);
802 genrtl_while_stmt (t
);
814 genrtl_compound_stmt (t
);
818 genrtl_break_stmt ();
822 genrtl_continue_stmt ();
826 genrtl_switch_stmt (t
);
830 genrtl_case_label (t
);
834 expand_label (LABEL_STMT_LABEL (t
));
838 genrtl_goto_stmt (GOTO_DESTINATION (t
));
842 genrtl_asm_stmt (ASM_CV_QUAL (t
), ASM_STRING (t
),
843 ASM_OUTPUTS (t
), ASM_INPUTS (t
), ASM_CLOBBERS (t
));
847 genrtl_scope_stmt (t
);
851 if (lang_expand_stmt
)
852 (*lang_expand_stmt
) (t
);
858 /* Restore saved state. */
859 current_stmt_tree ()->stmts_are_full_exprs_p
=
860 saved_stmts_are_full_exprs_p
;
862 /* Go on to the next statement in this scope. */