1 /* Build expressions with type checking for C compiler.
2 Copyright (C) 1987, 1988, 1989, 1992 Free Software Foundation, Inc.
4 This file is part of GNU CC.
6 GNU CC 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 GNU CC 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 GNU CC; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
21 /* This file is part of the C front end.
22 It is responsible for implementing iterators,
23 both their declarations and the expansion of statements using them. */
33 static void expand_stmt_with_iterators_1 ();
34 static tree
collect_iterators();
35 static void iterator_loop_prologue ();
36 static void iterator_loop_epilogue ();
37 static void add_ixpansion ();
38 static void delete_ixpansion();
39 static int top_level_ixpansion_p ();
40 static void istack_sublevel_to_current ();
42 /* A special obstack, and a pointer to the start of
43 all the data in it (so we can free everything easily). */
44 static struct obstack ixp_obstack
;
45 static char *ixp_firstobj
;
48 KEEPING TRACK OF EXPANSIONS
50 In order to clean out expansions corresponding to statements inside
51 "{(...)}" constructs we have to keep track of all expansions. The
52 cleanup is needed when an automatic, or implicit, expansion on
53 iterator, say X, happens to a statement which contains a {(...)}
54 form with a statement already expanded on X. In this case we have
55 to go back and cleanup the inner expansion. This can be further
56 complicated by the fact that {(...)} can be nested.
58 To make this cleanup possible, we keep lists of all expansions, and
59 to make it work for nested constructs, we keep a stack. The list at
60 the top of the stack (ITER_STACK.CURRENT_LEVEL) corresponds to the
61 currently parsed level. All expansions of the levels below the
62 current one are kept in one list whose head is pointed to by
63 ITER_STACK.SUBLEVEL_FIRST (SUBLEVEL_LAST is there for making merges
64 easy). The process works as follows:
66 -- On "({" a new node is added to the stack by PUSH_ITERATOR_STACK.
67 The sublevel list is not changed at this point.
69 -- On "})" the list for the current level is appended to the sublevel
72 -- On ";" sublevel lists are appended to the current level lists.
73 The reason is this: if they have not been superseded by the
74 expansion at the current level, they still might be
75 superseded later by the expansion on the higher level.
76 The levels do not have to distinguish levels below, so we
77 can merge the lists together. */
81 tree ixdecl
; /* Iterator decl */
82 rtx ixprologue_start
; /* First insn of epilogue. NULL means */
83 /* explicit (FOR) expansion*/
87 struct ixpansion
*next
; /* Next in the list */
90 struct iter_stack_node
92 struct ixpansion
*first
; /* Head of list of ixpansions */
93 struct ixpansion
*last
; /* Last node in list of ixpansions */
94 struct iter_stack_node
*next
; /* Next level iterator stack node */
97 struct iter_stack_node
*iter_stack
;
99 struct iter_stack_node sublevel_ixpansions
;
101 /* Initialize our obstack once per compilation. */
106 gcc_obstack_init (&ixp_obstack
);
107 ixp_firstobj
= (char *) obstack_alloc (&ixp_obstack
, 0);
110 /* Handle the start of an explicit `for' loop for iterator IDECL. */
113 iterator_for_loop_start (idecl
)
116 ITERATOR_BOUND_P (idecl
) = 1;
117 add_ixpansion (idecl
, 0, 0, 0, 0);
118 iterator_loop_prologue (idecl
, 0, 0);
121 /* Handle the end of an explicit `for' loop for iterator IDECL. */
124 iterator_for_loop_end (idecl
)
127 iterator_loop_epilogue (idecl
, 0, 0);
128 ITERATOR_BOUND_P (idecl
) = 0;
132 ITERATOR RTL EXPANSIONS
134 Expanding simple statements with iterators is straightforward:
135 collect the list of all free iterators in the statement, and
136 generate a loop for each of them.
138 An iterator is "free" if it has not been "bound" by a FOR
139 operator. The DECL_RTL of the iterator is the loop counter. */
141 /* Expand a statement STMT, possibly containing iterator usage, into RTL. */
144 iterator_expand (stmt
)
147 tree iter_list
= collect_iterators (stmt
, NULL_TREE
);
148 expand_stmt_with_iterators_1 (stmt
, iter_list
);
149 istack_sublevel_to_current ();
154 expand_stmt_with_iterators_1 (stmt
, iter_list
)
155 tree stmt
, iter_list
;
158 expand_expr_stmt (stmt
);
161 tree current_iterator
= TREE_VALUE (iter_list
);
162 tree iter_list_tail
= TREE_CHAIN (iter_list
);
163 rtx p_start
, p_end
, e_start
, e_end
;
165 iterator_loop_prologue (current_iterator
, &p_start
, &p_end
);
166 expand_stmt_with_iterators_1 (stmt
, iter_list_tail
);
167 iterator_loop_epilogue (current_iterator
, &e_start
, &e_end
);
169 /** Delete all inner expansions based on current_iterator **/
170 /** before adding the outer one. **/
172 delete_ixpansion (current_iterator
);
173 add_ixpansion (current_iterator
, p_start
, p_end
, e_start
, e_end
);
178 /* Return a list containing all the free (i.e. not bound by a
179 containing `for' statement) iterators mentioned in EXP, plus those
180 in LIST. Do not add duplicate entries to the list. */
183 collect_iterators (exp
, list
)
186 if (exp
== 0) return list
;
188 switch (TREE_CODE (exp
))
191 if (! ITERATOR_P (exp
) || ITERATOR_BOUND_P (exp
))
193 if (value_member (exp
, list
))
195 return tree_cons (NULL_TREE
, exp
, list
);
200 for (tail
= exp
; tail
; tail
= TREE_CHAIN (tail
))
201 list
= collect_iterators (TREE_VALUE (tail
), list
);
205 /* we do not automatically iterate blocks -- one must */
206 /* use the FOR construct to do that */
212 switch (TREE_CODE_CLASS (TREE_CODE (exp
)))
215 return collect_iterators (TREE_OPERAND (exp
, 0), list
);
219 return collect_iterators (TREE_OPERAND (exp
, 0),
220 collect_iterators (TREE_OPERAND (exp
, 1),
226 int num_args
= tree_code_length
[(int) TREE_CODE (exp
)];
229 /* Some tree codes have RTL, not trees, as operands. */
230 switch (TREE_CODE (exp
))
236 case METHOD_CALL_EXPR
:
239 case WITH_CLEANUP_EXPR
:
246 for (i
= 0; i
< num_args
; i
++)
247 list
= collect_iterators (TREE_OPERAND (exp
, i
), list
);
256 /* Emit rtl for the start of a loop for iterator IDECL.
258 If necessary, create loop counter rtx and store it as DECL_RTL of IDECL.
260 The prologue normally starts and ends with notes, which are returned
261 by this function in *START_NOTE and *END_NODE.
262 If START_NOTE and END_NODE are 0, we don't make those notes. */
265 iterator_loop_prologue (idecl
, start_note
, end_note
)
267 rtx
*start_note
, *end_note
;
269 /* Force the save_expr in DECL_INITIAL to be calculated
270 if it hasn't been calculated yet. */
271 expand_expr (DECL_INITIAL (idecl
), 0, VOIDmode
, 0);
273 if (DECL_RTL (idecl
) == 0)
277 *start_note
= emit_note (0, NOTE_INSN_DELETED
);
278 /* Initialize counter. */
279 expand_expr (build (MODIFY_EXPR
, TREE_TYPE (idecl
),
280 idecl
, integer_zero_node
),
283 expand_start_loop_continue_elsewhere (1);
285 ITERATOR_BOUND_P (idecl
) = 1;
288 *end_note
= emit_note (0, NOTE_INSN_DELETED
);
291 /* Similar to the previous function, but for the end of the loop.
293 DECL_RTL is zeroed unless we are inside "({...})". The reason for that is
296 When we create two (or more) loops based on the same IDECL, and
297 both inside the same "({...})" construct, we must be prepared to
298 delete both of the loops and create a single one on the level
299 above, i.e. enclosing the "({...})". The new loop has to use the
300 same counter rtl because the references to the iterator decl
301 (IDECL) have already been expanded as references to the counter
304 It is incorrect to use the same counter reg in different functions,
305 and it is desirable to use different counters in disjoint loops
306 when we know there's no need to combine them (because then they can
307 get allocated separately). */
310 iterator_loop_epilogue (idecl
, start_note
, end_note
)
312 rtx
*start_note
, *end_note
;
317 *start_note
= emit_note (0, NOTE_INSN_DELETED
);
318 expand_loop_continue_here ();
319 incr
= build_binary_op (PLUS_EXPR
, idecl
, integer_one_node
, 0);
320 expand_expr (build (MODIFY_EXPR
, TREE_TYPE (idecl
), idecl
, incr
),
322 test
= build_binary_op (LT_EXPR
, idecl
, DECL_INITIAL (idecl
), 0);
323 expand_exit_loop_if_false (0, test
);
326 ITERATOR_BOUND_P (idecl
) = 0;
327 /* we can reset rtl since there is not chance that this expansion */
328 /* would be superceded by a higher level one */
329 if (top_level_ixpansion_p ())
330 DECL_RTL (idecl
) = 0;
332 *end_note
= emit_note (0, NOTE_INSN_DELETED
);
335 /* Return true if we are not currently inside a "({...})" construct. */
338 top_level_ixpansion_p ()
340 return iter_stack
== 0;
343 /* Given two chains of iter_stack_nodes,
344 append the nodes in X into Y. */
348 struct iter_stack_node
*x
, *y
;
360 y
->last
->next
= x
->first
;
367 #define ISN_ZERO(X) (X).first=(X).last=0
369 /* Move the ixpansions in sublevel_ixpansions into the current
370 node on the iter_stack, or discard them if the iter_stack is empty.
371 We do this at the end of a statement. */
374 istack_sublevel_to_current ()
376 /* At the top level we can throw away sublevel's expansions **/
377 /* because there is nobody above us to ask for a cleanup **/
379 /** Merging with empty sublevel list is a no-op **/
380 if (sublevel_ixpansions
.last
)
381 isn_append (&sublevel_ixpansions
, iter_stack
);
384 obstack_free (&ixp_obstack
, ixp_firstobj
);
386 ISN_ZERO (sublevel_ixpansions
);
389 /* Push a new node on the iter_stack, when we enter a ({...}). */
392 push_iterator_stack ()
394 struct iter_stack_node
*new_top
395 = (struct iter_stack_node
*)
396 obstack_alloc (&ixp_obstack
, sizeof (struct iter_stack_node
));
400 new_top
->next
= iter_stack
;
401 iter_stack
= new_top
;
404 /* Pop iter_stack, moving the ixpansions in the node being popped
405 into sublevel_ixpansions. */
408 pop_iterator_stack ()
413 isn_append (iter_stack
, &sublevel_ixpansions
);
414 /** Pop current level node: */
415 iter_stack
= iter_stack
->next
;
419 /* Record an iterator expansion ("ixpansion") for IDECL.
420 The remaining paramters are the notes in the loop entry
424 add_ixpansion (idecl
, pro_start
, pro_end
, epi_start
, epi_end
)
426 rtx pro_start
, pro_end
, epi_start
, epi_end
;
428 struct ixpansion
* newix
;
430 /* Do nothing if we are not inside "({...})",
431 as in that case this expansion can't need subsequent RTL modification. */
435 newix
= (struct ixpansion
*) obstack_alloc (&ixp_obstack
,
436 sizeof (struct ixpansion
));
437 newix
->ixdecl
= idecl
;
438 newix
->ixprologue_start
= pro_start
;
439 newix
->ixprologue_end
= pro_end
;
440 newix
->ixepilogue_start
= epi_start
;
441 newix
->ixepilogue_end
= epi_end
;
443 newix
->next
= iter_stack
->first
;
444 iter_stack
->first
= newix
;
445 if (iter_stack
->last
== 0)
446 iter_stack
->last
= newix
;
449 /* Delete the RTL for all ixpansions for iterator IDECL
450 in our sublevels. We do this when we make a larger
451 containing expansion for IDECL. */
454 delete_ixpansion (idecl
)
457 struct ixpansion
* previx
= 0, *ix
;
459 for (ix
= sublevel_ixpansions
.first
; ix
; ix
= ix
->next
)
460 if (ix
->ixdecl
== idecl
)
462 /** zero means that this is a mark for FOR -- **/
463 /** we do not delete anything, just issue an error. **/
465 if (ix
->ixprologue_start
== 0)
466 error_with_decl (idecl
,
467 "`for (%s)' appears within implicit iteration");
471 /* We delete all insns, including notes because leaving loop */
472 /* notes and barriers produced by iterator expansion would */
473 /* be misleading to other phases */
475 for (insn
= NEXT_INSN (ix
->ixprologue_start
);
476 insn
!= ix
->ixprologue_end
;
477 insn
= NEXT_INSN (insn
))
479 for (insn
= NEXT_INSN (ix
->ixepilogue_start
);
480 insn
!= ix
->ixepilogue_end
;
481 insn
= NEXT_INSN (insn
))
485 /* Delete this ixpansion from sublevel_ixpansions. */
487 previx
->next
= ix
->next
;
489 sublevel_ixpansions
.first
= ix
->next
;
490 if (sublevel_ixpansions
.last
== ix
)
491 sublevel_ixpansions
.last
= previx
;
497 #ifdef DEBUG_ITERATORS
499 /* The functions below are for use from source level debugger.
500 They print short forms of iterator lists and the iterator stack. */
502 /* Print the name of the iterator D. */
510 if (TREE_CODE (d
) == VAR_DECL
)
512 tree tname
= DECL_NAME (d
);
513 char *dname
= IDENTIFIER_POINTER (tname
);
514 fprintf (stderr
, dname
);
517 fprintf (stderr
, "<<Not a Decl!!!>>");
520 fprintf (stderr
, "<<NULL!!>>");
523 /* Print Iterator List -- names only */
530 for (current
= head
; current
; current
= next
)
532 tree node
= TREE_VALUE (current
);
534 next
= TREE_CHAIN (current
);
535 if (next
) fprintf (stderr
, ",");
537 fprintf (stderr
, "\n");
540 /* Print IXpansion List */
544 struct ixpansion
*head
;
546 struct ixpansion
*current
, *next
;
547 fprintf (stderr
, "> ");
549 fprintf (stderr
, "(empty)");
551 for (current
=head
; current
; current
= next
)
553 tree node
= current
->ixdecl
;
555 next
= current
->next
;
557 fprintf (stderr
, ",");
559 fprintf (stderr
, "\n");
563 /* Print Iterator Stack*/
568 struct iter_stack_node
*stack_node
;
570 fprintf (stderr
, "--SubLevel: ");
571 pixl (sublevel_ixpansions
.first
);
572 fprintf (stderr
, "--Stack:--\n");
573 for (stack_node
= iter_stack
;
575 stack_node
= stack_node
->next
)
576 pixl (stack_node
->first
);
579 #endif /* DEBUG_ITERATORS */