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
)))
220 int num_args
= tree_code_length
[TREE_CODE (exp
)];
223 for (i
= 0; i
< num_args
; i
++)
224 list
= collect_iterators (TREE_OPERAND (exp
, i
), list
);
233 /* Emit rtl for the start of a loop for iterator IDECL.
235 If necessary, create loop counter rtx and store it as DECL_RTL of IDECL.
237 The prologue normally starts and ends with notes, which are returned
238 by this function in *START_NOTE and *END_NODE.
239 If START_NOTE and END_NODE are 0, we don't make those notes. */
242 iterator_loop_prologue (idecl
, start_note
, end_note
)
244 rtx
*start_note
, *end_note
;
246 /* Force the save_expr in DECL_INITIAL to be calculated
247 if it hasn't been calculated yet. */
248 expand_expr (DECL_INITIAL (idecl
), 0, VOIDmode
, 0);
250 if (DECL_RTL (idecl
) == 0)
254 *start_note
= emit_note (0, NOTE_INSN_DELETED
);
255 /* Initialize counter. */
256 expand_expr (build (MODIFY_EXPR
, TREE_TYPE (idecl
),
257 idecl
, integer_zero_node
),
260 expand_start_loop_continue_elsewhere (1);
262 ITERATOR_BOUND_P (idecl
) = 1;
265 *end_note
= emit_note (0, NOTE_INSN_DELETED
);
268 /* Similar to the previous function, but for the end of the loop.
270 DECL_RTL is zeroed unless we are inside "({...})". The reason for that is
273 When we create two (or more) loops based on the same IDECL, and
274 both inside the same "({...})" construct, we must be prepared to
275 delete both of the loops and create a single one on the level
276 above, i.e. enclosing the "({...})". The new loop has to use the
277 same counter rtl because the references to the iterator decl
278 (IDECL) have already been expanded as references to the counter
281 It is incorrect to use the same counter reg in different functions,
282 and it is desirable to use different counters in disjoint loops
283 when we know there's no need to combine them (because then they can
284 get allocated separately). */
287 iterator_loop_epilogue (idecl
, start_note
, end_note
)
289 rtx
*start_note
, *end_note
;
294 *start_note
= emit_note (0, NOTE_INSN_DELETED
);
295 expand_loop_continue_here ();
296 incr
= build_binary_op (PLUS_EXPR
, idecl
, integer_one_node
, 0);
297 expand_expr (build (MODIFY_EXPR
, TREE_TYPE (idecl
), idecl
, incr
),
299 test
= build_binary_op (LT_EXPR
, idecl
, DECL_INITIAL (idecl
), 0);
300 expand_exit_loop_if_false (0, test
);
303 ITERATOR_BOUND_P (idecl
) = 0;
304 /* we can reset rtl since there is not chance that this expansion */
305 /* would be superceded by a higher level one */
306 if (top_level_ixpansion_p ())
307 DECL_RTL (idecl
) = 0;
309 *end_note
= emit_note (0, NOTE_INSN_DELETED
);
312 /* Return true if we are not currently inside a "({...})" construct. */
315 top_level_ixpansion_p ()
317 return iter_stack
== 0;
320 /* Given two chains of iter_stack_nodes,
321 append the nodes in X into Y. */
325 struct iter_stack_node
*x
, *y
;
337 y
->last
->next
= x
->first
;
344 #define ISN_ZERO(X) (X).first=(X).last=0
346 /* Move the ixpansions in sublevel_ixpansions into the current
347 node on the iter_stack, or discard them if the iter_stack is empty.
348 We do this at the end of a statement. */
351 istack_sublevel_to_current ()
353 /* At the top level we can throw away sublevel's expansions **/
354 /* because there is nobody above us to ask for a cleanup **/
356 /** Merging with empty sublevel list is a no-op **/
357 if (sublevel_ixpansions
.last
)
358 isn_append (&sublevel_ixpansions
, iter_stack
);
361 obstack_free (&ixp_obstack
, ixp_firstobj
);
363 ISN_ZERO (sublevel_ixpansions
);
366 /* Push a new node on the iter_stack, when we enter a ({...}). */
369 push_iterator_stack ()
371 struct iter_stack_node
*new_top
372 = (struct iter_stack_node
*)
373 obstack_alloc (&ixp_obstack
, sizeof (struct iter_stack_node
));
377 new_top
->next
= iter_stack
;
378 iter_stack
= new_top
;
381 /* Pop iter_stack, moving the ixpansions in the node being popped
382 into sublevel_ixpansions. */
385 pop_iterator_stack ()
390 isn_append (iter_stack
, &sublevel_ixpansions
);
391 /** Pop current level node: */
392 iter_stack
= iter_stack
->next
;
396 /* Record an iterator expansion ("ixpansion") for IDECL.
397 The remaining paramters are the notes in the loop entry
401 add_ixpansion (idecl
, pro_start
, pro_end
, epi_start
, epi_end
)
403 rtx pro_start
, pro_end
, epi_start
, epi_end
;
405 struct ixpansion
* newix
;
407 /* Do nothing if we are not inside "({...})",
408 as in that case this expansion can't need subsequent RTL modification. */
412 newix
= (struct ixpansion
*) obstack_alloc (&ixp_obstack
,
413 sizeof (struct ixpansion
));
414 newix
->ixdecl
= idecl
;
415 newix
->ixprologue_start
= pro_start
;
416 newix
->ixprologue_end
= pro_end
;
417 newix
->ixepilogue_start
= epi_start
;
418 newix
->ixepilogue_end
= epi_end
;
420 newix
->next
= iter_stack
->first
;
421 iter_stack
->first
= newix
;
422 if (iter_stack
->last
== 0)
423 iter_stack
->last
= newix
;
426 /* Delete the RTL for all ixpansions for iterator IDECL
427 in our sublevels. We do this when we make a larger
428 containing expansion for IDECL. */
431 delete_ixpansion (idecl
)
434 struct ixpansion
* previx
= 0, *ix
;
436 for (ix
= sublevel_ixpansions
.first
; ix
; ix
= ix
->next
)
437 if (ix
->ixdecl
== idecl
)
439 /** zero means that this is a mark for FOR -- **/
440 /** we do not delete anything, just issue an error. **/
442 if (ix
->ixprologue_start
== 0)
443 error_with_decl (idecl
,
444 "`for (%s)' appears within implicit iteration");
448 /* We delete all insns, including notes because leaving loop */
449 /* notes and barriers produced by iterator expansion would */
450 /* be misleading to other phases */
452 for (insn
= NEXT_INSN (ix
->ixprologue_start
);
453 insn
!= ix
->ixprologue_end
;
454 insn
= NEXT_INSN (insn
))
456 for (insn
= NEXT_INSN (ix
->ixepilogue_start
);
457 insn
!= ix
->ixepilogue_end
;
458 insn
= NEXT_INSN (insn
))
462 /* Delete this ixpansion from sublevel_ixpansions. */
464 previx
->next
= ix
->next
;
466 sublevel_ixpansions
.first
= ix
->next
;
467 if (sublevel_ixpansions
.last
== ix
)
468 sublevel_ixpansions
.last
= previx
;
474 #ifdef DEBUG_ITERATORS
476 /* The functions below are for use from source level debugger.
477 They print short forms of iterator lists and the iterator stack. */
479 /* Print the name of the iterator D. */
487 if (TREE_CODE (d
) == VAR_DECL
)
489 tree tname
= DECL_NAME (d
);
490 char *dname
= IDENTIFIER_POINTER (tname
);
491 fprintf (stderr
, dname
);
494 fprintf (stderr
, "<<Not a Decl!!!>>");
497 fprintf (stderr
, "<<NULL!!>>");
500 /* Print Iterator List -- names only */
507 for (current
= head
; current
; current
= next
)
509 tree node
= TREE_VALUE (current
);
511 next
= TREE_CHAIN (current
);
512 if (next
) fprintf (stderr
, ",");
514 fprintf (stderr
, "\n");
517 /* Print IXpansion List */
521 struct ixpansion
*head
;
523 struct ixpansion
*current
, *next
;
524 fprintf (stderr
, "> ");
526 fprintf (stderr
, "(empty)");
528 for (current
=head
; current
; current
= next
)
530 tree node
= current
->ixdecl
;
532 next
= current
->next
;
534 fprintf (stderr
, ",");
536 fprintf (stderr
, "\n");
540 /* Print Iterator Stack*/
545 struct iter_stack_node
*stack_node
;
547 fprintf (stderr
, "--SubLevel: ");
548 pixl (sublevel_ixpansions
.first
);
549 fprintf (stderr
, "--Stack:--\n");
550 for (stack_node
= iter_stack
;
552 stack_node
= stack_node
->next
)
553 pixl (stack_node
->first
);
556 #endif /* DEBUG_ITERATORS */