2009-11-04 Harsha Jagasia <harsha.jagasia@amd.com>
[official-gcc.git] / gcc / expr.h
blobe84779639b5945d39cfd5a03ec38091ab9847be6
1 /* Definitions for code generation pass of GNU compiler.
2 Copyright (C) 1987, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
3 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
4 Free Software Foundation, Inc.
6 This file is part of GCC.
8 GCC is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 3, or (at your option) any later
11 version.
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 for more details.
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING3. If not see
20 <http://www.gnu.org/licenses/>. */
22 #ifndef GCC_EXPR_H
23 #define GCC_EXPR_H
25 /* For inhibit_defer_pop */
26 #include "function.h"
27 /* For XEXP, GEN_INT, rtx_code */
28 #include "rtl.h"
29 /* For optimize_size */
30 #include "flags.h"
31 /* For host_integerp, tree_low_cst, fold_convert, size_binop, ssize_int,
32 TREE_CODE, TYPE_SIZE, int_size_in_bytes, */
33 #include "tree.h"
34 /* For GET_MODE_BITSIZE, word_mode */
35 #include "machmode.h"
37 /* The default branch cost is 1. */
38 #ifndef BRANCH_COST
39 #define BRANCH_COST(speed_p, predictable_p) 1
40 #endif
42 /* This is the 4th arg to `expand_expr'.
43 EXPAND_STACK_PARM means we are possibly expanding a call param onto
44 the stack.
45 EXPAND_SUM means it is ok to return a PLUS rtx or MULT rtx.
46 EXPAND_INITIALIZER is similar but also record any labels on forced_labels.
47 EXPAND_CONST_ADDRESS means it is ok to return a MEM whose address
48 is a constant that is not a legitimate address.
49 EXPAND_WRITE means we are only going to write to the resulting rtx.
50 EXPAND_MEMORY means we are interested in a memory result, even if
51 the memory is constant and we could have propagated a constant value. */
52 enum expand_modifier {EXPAND_NORMAL = 0, EXPAND_STACK_PARM, EXPAND_SUM,
53 EXPAND_CONST_ADDRESS, EXPAND_INITIALIZER, EXPAND_WRITE,
54 EXPAND_MEMORY};
56 /* Prevent the compiler from deferring stack pops. See
57 inhibit_defer_pop for more information. */
58 #define NO_DEFER_POP (inhibit_defer_pop += 1)
60 /* Allow the compiler to defer stack pops. See inhibit_defer_pop for
61 more information. */
62 #define OK_DEFER_POP (inhibit_defer_pop -= 1)
64 /* If a memory-to-memory move would take MOVE_RATIO or more simple
65 move-instruction sequences, we will do a movmem or libcall instead. */
67 #ifndef MOVE_RATIO
68 #if defined (HAVE_movmemqi) || defined (HAVE_movmemhi) || defined (HAVE_movmemsi) || defined (HAVE_movmemdi) || defined (HAVE_movmemti)
69 #define MOVE_RATIO(speed) 2
70 #else
71 /* If we are optimizing for space (-Os), cut down the default move ratio. */
72 #define MOVE_RATIO(speed) ((speed) ? 15 : 3)
73 #endif
74 #endif
76 /* If a clear memory operation would take CLEAR_RATIO or more simple
77 move-instruction sequences, we will do a setmem or libcall instead. */
79 #ifndef CLEAR_RATIO
80 #if defined (HAVE_setmemqi) || defined (HAVE_setmemhi) || defined (HAVE_setmemsi) || defined (HAVE_setmemdi) || defined (HAVE_setmemti)
81 #define CLEAR_RATIO(speed) 2
82 #else
83 /* If we are optimizing for space, cut down the default clear ratio. */
84 #define CLEAR_RATIO(speed) ((speed) ? 15 :3)
85 #endif
86 #endif
88 /* If a memory set (to value other than zero) operation would take
89 SET_RATIO or more simple move-instruction sequences, we will do a movmem
90 or libcall instead. */
91 #ifndef SET_RATIO
92 #define SET_RATIO(speed) MOVE_RATIO(speed)
93 #endif
95 enum direction {none, upward, downward};
97 /* Structure to record the size of a sequence of arguments
98 as the sum of a tree-expression and a constant. This structure is
99 also used to store offsets from the stack, which might be negative,
100 so the variable part must be ssizetype, not sizetype. */
102 struct args_size
104 HOST_WIDE_INT constant;
105 tree var;
108 /* Package up various arg related fields of struct args for
109 locate_and_pad_parm. */
110 struct locate_and_pad_arg_data
112 /* Size of this argument on the stack, rounded up for any padding it
113 gets. If REG_PARM_STACK_SPACE is defined, then register parms are
114 counted here, otherwise they aren't. */
115 struct args_size size;
116 /* Offset of this argument from beginning of stack-args. */
117 struct args_size offset;
118 /* Offset to the start of the stack slot. Different from OFFSET
119 if this arg pads downward. */
120 struct args_size slot_offset;
121 /* The amount that the stack pointer needs to be adjusted to
122 force alignment for the next argument. */
123 struct args_size alignment_pad;
124 /* Which way we should pad this arg. */
125 enum direction where_pad;
126 /* slot_offset is at least this aligned. */
127 unsigned int boundary;
130 /* Add the value of the tree INC to the `struct args_size' TO. */
132 #define ADD_PARM_SIZE(TO, INC) \
133 do { \
134 tree inc = (INC); \
135 if (host_integerp (inc, 0)) \
136 (TO).constant += tree_low_cst (inc, 0); \
137 else if ((TO).var == 0) \
138 (TO).var = fold_convert (ssizetype, inc); \
139 else \
140 (TO).var = size_binop (PLUS_EXPR, (TO).var, \
141 fold_convert (ssizetype, inc)); \
142 } while (0)
144 #define SUB_PARM_SIZE(TO, DEC) \
145 do { \
146 tree dec = (DEC); \
147 if (host_integerp (dec, 0)) \
148 (TO).constant -= tree_low_cst (dec, 0); \
149 else if ((TO).var == 0) \
150 (TO).var = size_binop (MINUS_EXPR, ssize_int (0), \
151 fold_convert (ssizetype, dec)); \
152 else \
153 (TO).var = size_binop (MINUS_EXPR, (TO).var, \
154 fold_convert (ssizetype, dec)); \
155 } while (0)
157 /* Convert the implicit sum in a `struct args_size' into a tree
158 of type ssizetype. */
159 #define ARGS_SIZE_TREE(SIZE) \
160 ((SIZE).var == 0 ? ssize_int ((SIZE).constant) \
161 : size_binop (PLUS_EXPR, fold_convert (ssizetype, (SIZE).var), \
162 ssize_int ((SIZE).constant)))
164 /* Convert the implicit sum in a `struct args_size' into an rtx. */
165 #define ARGS_SIZE_RTX(SIZE) \
166 ((SIZE).var == 0 ? GEN_INT ((SIZE).constant) \
167 : expand_normal (ARGS_SIZE_TREE (SIZE)))
169 /* Supply a default definition for FUNCTION_ARG_PADDING:
170 usually pad upward, but pad short args downward on
171 big-endian machines. */
173 #define DEFAULT_FUNCTION_ARG_PADDING(MODE, TYPE) \
174 (! BYTES_BIG_ENDIAN \
175 ? upward \
176 : (((MODE) == BLKmode \
177 ? ((TYPE) && TREE_CODE (TYPE_SIZE (TYPE)) == INTEGER_CST \
178 && int_size_in_bytes (TYPE) < (PARM_BOUNDARY / BITS_PER_UNIT)) \
179 : GET_MODE_BITSIZE (MODE) < PARM_BOUNDARY) \
180 ? downward : upward))
182 #ifndef FUNCTION_ARG_PADDING
183 #define FUNCTION_ARG_PADDING(MODE, TYPE) \
184 DEFAULT_FUNCTION_ARG_PADDING ((MODE), (TYPE))
185 #endif
187 /* Supply a default definition for FUNCTION_ARG_BOUNDARY. Normally, we let
188 FUNCTION_ARG_PADDING, which also pads the length, handle any needed
189 alignment. */
191 #ifndef FUNCTION_ARG_BOUNDARY
192 #define FUNCTION_ARG_BOUNDARY(MODE, TYPE) PARM_BOUNDARY
193 #endif
195 /* Supply a default definition of STACK_SAVEAREA_MODE for emit_stack_save.
196 Normally move_insn, so Pmode stack pointer. */
198 #ifndef STACK_SAVEAREA_MODE
199 #define STACK_SAVEAREA_MODE(LEVEL) Pmode
200 #endif
202 /* Supply a default definition of STACK_SIZE_MODE for
203 allocate_dynamic_stack_space. Normally PLUS/MINUS, so word_mode. */
205 #ifndef STACK_SIZE_MODE
206 #define STACK_SIZE_MODE word_mode
207 #endif
209 /* Provide default values for the macros controlling stack checking. */
211 /* The default is neither full builtin stack checking... */
212 #ifndef STACK_CHECK_BUILTIN
213 #define STACK_CHECK_BUILTIN 0
214 #endif
216 /* ...nor static builtin stack checking. */
217 #ifndef STACK_CHECK_STATIC_BUILTIN
218 #define STACK_CHECK_STATIC_BUILTIN 0
219 #endif
221 /* The default interval is one page (4096 bytes). */
222 #ifndef STACK_CHECK_PROBE_INTERVAL_EXP
223 #define STACK_CHECK_PROBE_INTERVAL_EXP 12
224 #endif
226 /* The default is to do a store into the stack. */
227 #ifndef STACK_CHECK_PROBE_LOAD
228 #define STACK_CHECK_PROBE_LOAD 0
229 #endif
231 /* The default is not to move the stack pointer. */
232 #ifndef STACK_CHECK_MOVING_SP
233 #define STACK_CHECK_MOVING_SP 0
234 #endif
236 /* This is a kludge to try to capture the discrepancy between the old
237 mechanism (generic stack checking) and the new mechanism (static
238 builtin stack checking). STACK_CHECK_PROTECT needs to be bumped
239 for the latter because part of the protection area is effectively
240 included in STACK_CHECK_MAX_FRAME_SIZE for the former. */
241 #ifdef STACK_CHECK_PROTECT
242 #define STACK_OLD_CHECK_PROTECT STACK_CHECK_PROTECT
243 #else
244 #define STACK_OLD_CHECK_PROTECT \
245 (USING_SJLJ_EXCEPTIONS ? 75 * UNITS_PER_WORD : 8 * 1024)
246 #endif
248 /* Minimum amount of stack required to recover from an anticipated stack
249 overflow detection. The default value conveys an estimate of the amount
250 of stack required to propagate an exception. */
251 #ifndef STACK_CHECK_PROTECT
252 #define STACK_CHECK_PROTECT \
253 (USING_SJLJ_EXCEPTIONS ? 75 * UNITS_PER_WORD : 12 * 1024)
254 #endif
256 /* Make the maximum frame size be the largest we can and still only need
257 one probe per function. */
258 #ifndef STACK_CHECK_MAX_FRAME_SIZE
259 #define STACK_CHECK_MAX_FRAME_SIZE \
260 ((1 << STACK_CHECK_PROBE_INTERVAL_EXP) - UNITS_PER_WORD)
261 #endif
263 /* This is arbitrary, but should be large enough everywhere. */
264 #ifndef STACK_CHECK_FIXED_FRAME_SIZE
265 #define STACK_CHECK_FIXED_FRAME_SIZE (4 * UNITS_PER_WORD)
266 #endif
268 /* Provide a reasonable default for the maximum size of an object to
269 allocate in the fixed frame. We may need to be able to make this
270 controllable by the user at some point. */
271 #ifndef STACK_CHECK_MAX_VAR_SIZE
272 #define STACK_CHECK_MAX_VAR_SIZE (STACK_CHECK_MAX_FRAME_SIZE / 100)
273 #endif
275 /* This structure is used to pass around information about exploded
276 unary, binary and trinary expressions between expand_expr_real_1 and
277 friends. */
278 typedef struct separate_ops
280 enum tree_code code;
281 tree type;
282 tree op0, op1, op2;
283 location_t location;
284 } *sepops;
286 /* Functions from optabs.c, commonly used, and without need for the optabs
287 tables: */
289 /* Passed to expand_simple_binop and expand_binop to say which options
290 to try to use if the requested operation can't be open-coded on the
291 requisite mode. Either OPTAB_LIB or OPTAB_LIB_WIDEN says try using
292 a library call. Either OPTAB_WIDEN or OPTAB_LIB_WIDEN says try
293 using a wider mode. OPTAB_MUST_WIDEN says try widening and don't
294 try anything else. */
296 enum optab_methods
298 OPTAB_DIRECT,
299 OPTAB_LIB,
300 OPTAB_WIDEN,
301 OPTAB_LIB_WIDEN,
302 OPTAB_MUST_WIDEN
305 /* Generate code for a simple binary or unary operation. "Simple" in
306 this case means "can be unambiguously described by a (mode, code)
307 pair and mapped to a single optab." */
308 extern rtx expand_simple_binop (enum machine_mode, enum rtx_code, rtx,
309 rtx, rtx, int, enum optab_methods);
310 extern rtx expand_simple_unop (enum machine_mode, enum rtx_code, rtx, rtx,
311 int);
313 /* Report whether the machine description contains an insn which can
314 perform the operation described by CODE and MODE. */
315 extern int have_insn_for (enum rtx_code, enum machine_mode);
317 extern rtx prepare_operand (int, rtx, int, enum machine_mode, enum machine_mode,
318 int);
320 /* Emit code to make a call to a constant function or a library call. */
321 extern void emit_libcall_block (rtx, rtx, rtx, rtx);
323 /* Create but don't emit one rtl instruction to perform certain operations.
324 Modes must match; operands must meet the operation's predicates.
325 Likewise for subtraction and for just copying. */
326 extern rtx gen_add2_insn (rtx, rtx);
327 extern rtx gen_add3_insn (rtx, rtx, rtx);
328 extern rtx gen_sub2_insn (rtx, rtx);
329 extern rtx gen_sub3_insn (rtx, rtx, rtx);
330 extern rtx gen_move_insn (rtx, rtx);
331 extern int have_add2_insn (rtx, rtx);
332 extern int have_sub2_insn (rtx, rtx);
334 /* Emit a pair of rtl insns to compare two rtx's and to jump
335 to a label if the comparison is true. */
336 extern void emit_cmp_and_jump_insns (rtx, rtx, enum rtx_code, rtx,
337 enum machine_mode, int, rtx);
339 /* Generate code to indirectly jump to a location given in the rtx LOC. */
340 extern void emit_indirect_jump (rtx);
342 /* Generate a conditional trap instruction. */
343 extern rtx gen_cond_trap (enum rtx_code, rtx, rtx, rtx);
345 #include "insn-config.h"
347 #ifdef HAVE_conditional_move
348 /* Emit a conditional move operation. */
349 rtx emit_conditional_move (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
350 rtx, rtx, enum machine_mode, int);
352 /* Return nonzero if the conditional move is supported. */
353 int can_conditionally_move_p (enum machine_mode mode);
355 #endif
356 rtx emit_conditional_add (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
357 rtx, rtx, enum machine_mode, int);
359 rtx expand_val_compare_and_swap (rtx, rtx, rtx, rtx);
360 rtx expand_bool_compare_and_swap (rtx, rtx, rtx, rtx);
361 rtx expand_sync_operation (rtx, rtx, enum rtx_code);
362 rtx expand_sync_fetch_operation (rtx, rtx, enum rtx_code, bool, rtx);
363 rtx expand_sync_lock_test_and_set (rtx, rtx, rtx);
365 /* Functions from expmed.c: */
367 /* Arguments MODE, RTX: return an rtx for the negation of that value.
368 May emit insns. */
369 extern rtx negate_rtx (enum machine_mode, rtx);
371 /* Expand a logical AND operation. */
372 extern rtx expand_and (enum machine_mode, rtx, rtx, rtx);
374 /* Emit a store-flag operation. */
375 extern rtx emit_store_flag (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
376 int, int);
378 /* Like emit_store_flag, but always succeeds. */
379 extern rtx emit_store_flag_force (rtx, enum rtx_code, rtx, rtx,
380 enum machine_mode, int, int);
382 /* Functions from builtins.c: */
383 extern rtx expand_builtin (tree, rtx, rtx, enum machine_mode, int);
384 extern tree std_build_builtin_va_list (void);
385 extern tree std_fn_abi_va_list (tree);
386 extern tree std_canonical_va_list_type (tree);
388 extern void std_expand_builtin_va_start (tree, rtx);
389 extern rtx default_expand_builtin (tree, rtx, rtx, enum machine_mode, int);
390 extern void expand_builtin_setjmp_setup (rtx, rtx);
391 extern void expand_builtin_setjmp_receiver (rtx);
392 extern rtx expand_builtin_saveregs (void);
393 extern void expand_builtin_trap (void);
394 extern rtx builtin_strncpy_read_str (void *, HOST_WIDE_INT, enum machine_mode);
396 /* Functions from expr.c: */
398 /* This is run during target initialization to set up which modes can be
399 used directly in memory and to initialize the block move optab. */
400 extern void init_expr_target (void);
402 /* This is run at the start of compiling a function. */
403 extern void init_expr (void);
405 /* Emit some rtl insns to move data between rtx's, converting machine modes.
406 Both modes must be floating or both fixed. */
407 extern void convert_move (rtx, rtx, int);
409 /* Convert an rtx to specified machine mode and return the result. */
410 extern rtx convert_to_mode (enum machine_mode, rtx, int);
412 /* Convert an rtx to MODE from OLDMODE and return the result. */
413 extern rtx convert_modes (enum machine_mode, enum machine_mode, rtx, int);
415 /* Emit code to move a block Y to a block X. */
417 enum block_op_methods
419 BLOCK_OP_NORMAL,
420 BLOCK_OP_NO_LIBCALL,
421 BLOCK_OP_CALL_PARM,
422 /* Like BLOCK_OP_NORMAL, but the libcall can be tail call optimized. */
423 BLOCK_OP_TAILCALL
426 extern GTY(()) tree block_clear_fn;
427 extern void init_block_move_fn (const char *);
428 extern void init_block_clear_fn (const char *);
430 extern rtx emit_block_move (rtx, rtx, rtx, enum block_op_methods);
431 extern rtx emit_block_move_via_libcall (rtx, rtx, rtx, bool);
432 extern rtx emit_block_move_hints (rtx, rtx, rtx, enum block_op_methods,
433 unsigned int, HOST_WIDE_INT);
434 extern bool emit_storent_insn (rtx to, rtx from);
436 /* Copy all or part of a value X into registers starting at REGNO.
437 The number of registers to be filled is NREGS. */
438 extern void move_block_to_reg (int, rtx, int, enum machine_mode);
440 /* Copy all or part of a BLKmode value X out of registers starting at REGNO.
441 The number of registers to be filled is NREGS. */
442 extern void move_block_from_reg (int, rtx, int);
444 /* Generate a non-consecutive group of registers represented by a PARALLEL. */
445 extern rtx gen_group_rtx (rtx);
447 /* Load a BLKmode value into non-consecutive registers represented by a
448 PARALLEL. */
449 extern void emit_group_load (rtx, rtx, tree, int);
451 /* Similarly, but load into new temporaries. */
452 extern rtx emit_group_load_into_temps (rtx, rtx, tree, int);
454 /* Move a non-consecutive group of registers represented by a PARALLEL into
455 a non-consecutive group of registers represented by a PARALLEL. */
456 extern void emit_group_move (rtx, rtx);
458 /* Move a group of registers represented by a PARALLEL into pseudos. */
459 extern rtx emit_group_move_into_temps (rtx);
461 /* Store a BLKmode value from non-consecutive registers represented by a
462 PARALLEL. */
463 extern void emit_group_store (rtx, rtx, tree, int);
465 /* Copy BLKmode object from a set of registers. */
466 extern rtx copy_blkmode_from_reg (rtx, rtx, tree);
468 /* Mark REG as holding a parameter for the next CALL_INSN. */
469 extern void use_reg (rtx *, rtx);
471 /* Mark NREGS consecutive regs, starting at REGNO, as holding parameters
472 for the next CALL_INSN. */
473 extern void use_regs (rtx *, int, int);
475 /* Mark a PARALLEL as holding a parameter for the next CALL_INSN. */
476 extern void use_group_regs (rtx *, rtx);
478 /* Write zeros through the storage of OBJECT.
479 If OBJECT has BLKmode, SIZE is its length in bytes. */
480 extern rtx clear_storage (rtx, rtx, enum block_op_methods);
481 extern rtx clear_storage_hints (rtx, rtx, enum block_op_methods,
482 unsigned int, HOST_WIDE_INT);
483 /* The same, but always output an library call. */
484 rtx set_storage_via_libcall (rtx, rtx, rtx, bool);
486 /* Expand a setmem pattern; return true if successful. */
487 extern bool set_storage_via_setmem (rtx, rtx, rtx, unsigned int,
488 unsigned int, HOST_WIDE_INT);
490 /* Determine whether the LEN bytes can be moved by using several move
491 instructions. Return nonzero if a call to move_by_pieces should
492 succeed. */
493 extern int can_move_by_pieces (unsigned HOST_WIDE_INT, unsigned int);
495 /* Return nonzero if it is desirable to store LEN bytes generated by
496 CONSTFUN with several move instructions by store_by_pieces
497 function. CONSTFUNDATA is a pointer which will be passed as argument
498 in every CONSTFUN call.
499 ALIGN is maximum alignment we can assume.
500 MEMSETP is true if this is a real memset/bzero, not a copy
501 of a const string. */
502 extern int can_store_by_pieces (unsigned HOST_WIDE_INT,
503 rtx (*) (void *, HOST_WIDE_INT,
504 enum machine_mode),
505 void *, unsigned int, bool);
507 /* Generate several move instructions to store LEN bytes generated by
508 CONSTFUN to block TO. (A MEM rtx with BLKmode). CONSTFUNDATA is a
509 pointer which will be passed as argument in every CONSTFUN call.
510 ALIGN is maximum alignment we can assume.
511 MEMSETP is true if this is a real memset/bzero, not a copy.
512 Returns TO + LEN. */
513 extern rtx store_by_pieces (rtx, unsigned HOST_WIDE_INT,
514 rtx (*) (void *, HOST_WIDE_INT, enum machine_mode),
515 void *, unsigned int, bool, int);
517 /* Emit insns to set X from Y. */
518 extern rtx emit_move_insn (rtx, rtx);
520 /* Emit insns to set X from Y, with no frills. */
521 extern rtx emit_move_insn_1 (rtx, rtx);
523 extern rtx emit_move_complex_push (enum machine_mode, rtx, rtx);
524 extern rtx emit_move_complex_parts (rtx, rtx);
526 /* Push a block of length SIZE (perhaps variable)
527 and return an rtx to address the beginning of the block. */
528 extern rtx push_block (rtx, int, int);
530 /* Generate code to push something onto the stack, given its mode and type. */
531 extern void emit_push_insn (rtx, enum machine_mode, tree, rtx, unsigned int,
532 int, rtx, int, rtx, rtx, int, rtx);
534 /* Expand an assignment that stores the value of FROM into TO. */
535 extern void expand_assignment (tree, tree, bool);
537 /* Generate code for computing expression EXP,
538 and storing the value into TARGET.
539 If SUGGEST_REG is nonzero, copy the value through a register
540 and return that register, if that is possible. */
541 extern rtx store_expr (tree, rtx, int, bool);
543 /* Given an rtx that may include add and multiply operations,
544 generate them as insns and return a pseudo-reg containing the value.
545 Useful after calling expand_expr with 1 as sum_ok. */
546 extern rtx force_operand (rtx, rtx);
548 /* Work horses for expand_expr. */
549 extern rtx expand_expr_real (tree, rtx, enum machine_mode,
550 enum expand_modifier, rtx *);
551 extern rtx expand_expr_real_1 (tree, rtx, enum machine_mode,
552 enum expand_modifier, rtx *);
553 extern rtx expand_expr_real_2 (sepops, rtx, enum machine_mode,
554 enum expand_modifier);
556 /* Generate code for computing expression EXP.
557 An rtx for the computed value is returned. The value is never null.
558 In the case of a void EXP, const0_rtx is returned. */
559 static inline rtx
560 expand_expr (tree exp, rtx target, enum machine_mode mode,
561 enum expand_modifier modifier)
563 return expand_expr_real (exp, target, mode, modifier, NULL);
566 static inline rtx
567 expand_normal (tree exp)
569 return expand_expr_real (exp, NULL_RTX, VOIDmode, EXPAND_NORMAL, NULL);
572 /* At the start of a function, record that we have no previously-pushed
573 arguments waiting to be popped. */
574 extern void init_pending_stack_adjust (void);
576 /* Discard any pending stack adjustment. */
577 extern void discard_pending_stack_adjust (void);
579 /* When exiting from function, if safe, clear out any pending stack adjust
580 so the adjustment won't get done. */
581 extern void clear_pending_stack_adjust (void);
583 /* Pop any previously-pushed arguments that have not been popped yet. */
584 extern void do_pending_stack_adjust (void);
586 /* Return the tree node and offset if a given argument corresponds to
587 a string constant. */
588 extern tree string_constant (tree, tree *);
590 /* Generate code to evaluate EXP and jump to LABEL if the value is zero. */
591 extern void jumpifnot (tree, rtx);
592 extern void jumpifnot_1 (enum tree_code, tree, tree, rtx);
594 /* Generate code to evaluate EXP and jump to LABEL if the value is nonzero. */
595 extern void jumpif (tree, rtx);
596 extern void jumpif_1 (enum tree_code, tree, tree, rtx);
598 /* Generate code to evaluate EXP and jump to IF_FALSE_LABEL if
599 the result is zero, or IF_TRUE_LABEL if the result is one. */
600 extern void do_jump (tree, rtx, rtx);
601 extern void do_jump_1 (enum tree_code, tree, tree, rtx, rtx);
603 extern void do_compare_rtx_and_jump (rtx, rtx, enum rtx_code, int,
604 enum machine_mode, rtx, rtx, rtx);
606 /* Two different ways of generating switch statements. */
607 extern int try_casesi (tree, tree, tree, tree, rtx, rtx, rtx);
608 extern int try_tablejump (tree, tree, tree, tree, rtx, rtx);
610 /* Functions from alias.c */
611 #include "alias.h"
614 /* rtl.h and tree.h were included. */
615 /* Return an rtx for the size in bytes of the value of an expr. */
616 extern rtx expr_size (tree);
618 /* Return a wide integer for the size in bytes of the value of EXP, or -1
619 if the size can vary or is larger than an integer. */
620 extern HOST_WIDE_INT int_expr_size (tree);
622 /* Return an rtx that refers to the value returned by a function
623 in its original home. This becomes invalid if any more code is emitted. */
624 extern rtx hard_function_value (const_tree, const_tree, const_tree, int);
626 extern rtx prepare_call_address (tree, rtx, rtx, rtx *, int, int);
628 extern bool shift_return_value (enum machine_mode, bool, rtx);
630 extern rtx expand_call (tree, rtx, int);
632 extern void fixup_tail_calls (void);
634 #ifdef TREE_CODE
635 extern rtx expand_shift (enum tree_code, enum machine_mode, rtx, tree, rtx,
636 int);
637 extern rtx expand_divmod (int, enum tree_code, enum machine_mode, rtx, rtx,
638 rtx, int);
639 #endif
641 extern void locate_and_pad_parm (enum machine_mode, tree, int, int, tree,
642 struct args_size *,
643 struct locate_and_pad_arg_data *);
645 /* Return the CODE_LABEL rtx for a LABEL_DECL, creating it if necessary. */
646 extern rtx label_rtx (tree);
648 /* As label_rtx, but additionally the label is placed on the forced label
649 list of its containing function (i.e. it is treated as reachable even
650 if how is not obvious). */
651 extern rtx force_label_rtx (tree);
653 /* Return an rtx like arg but sans any constant terms.
654 Returns the original rtx if it has no constant terms.
655 The constant terms are added and stored via a second arg. */
656 extern rtx eliminate_constant_term (rtx, rtx *);
658 /* Convert arg to a valid memory address for specified machine mode that points
659 to a specific named address space, by emitting insns to perform arithmetic
660 if necessary. */
661 extern rtx memory_address_addr_space (enum machine_mode, rtx, addr_space_t);
663 /* Like memory_address_addr_space, except assume the memory address points to
664 the generic named address space. */
665 #define memory_address(MODE,RTX) \
666 memory_address_addr_space ((MODE), (RTX), ADDR_SPACE_GENERIC)
668 /* Return a memory reference like MEMREF, but with its mode changed
669 to MODE and its address changed to ADDR.
670 (VOIDmode means don't change the mode.
671 NULL for ADDR means don't change the address.) */
672 extern rtx change_address (rtx, enum machine_mode, rtx);
674 /* Return a memory reference like MEMREF, but with its mode changed
675 to MODE and its address offset by OFFSET bytes. */
676 #define adjust_address(MEMREF, MODE, OFFSET) \
677 adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1)
679 /* Likewise, but the reference is not required to be valid. */
680 #define adjust_address_nv(MEMREF, MODE, OFFSET) \
681 adjust_address_1 (MEMREF, MODE, OFFSET, 0, 1)
683 /* Return a memory reference like MEMREF, but with its mode changed
684 to MODE and its address changed to ADDR, which is assumed to be
685 increased by OFFSET bytes from MEMREF. */
686 #define adjust_automodify_address(MEMREF, MODE, ADDR, OFFSET) \
687 adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 1)
689 /* Likewise, but the reference is not required to be valid. */
690 #define adjust_automodify_address_nv(MEMREF, MODE, ADDR, OFFSET) \
691 adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 0)
693 extern rtx adjust_address_1 (rtx, enum machine_mode, HOST_WIDE_INT, int, int);
694 extern rtx adjust_automodify_address_1 (rtx, enum machine_mode, rtx,
695 HOST_WIDE_INT, int);
697 /* Return a memory reference like MEMREF, but whose address is changed by
698 adding OFFSET, an RTX, to it. POW2 is the highest power of two factor
699 known to be in OFFSET (possibly 1). */
700 extern rtx offset_address (rtx, rtx, unsigned HOST_WIDE_INT);
702 /* Definitions from emit-rtl.c */
703 #include "emit-rtl.h"
705 /* Return a memory reference like MEMREF, but with its mode widened to
706 MODE and adjusted by OFFSET. */
707 extern rtx widen_memory_access (rtx, enum machine_mode, HOST_WIDE_INT);
709 /* Return a memory reference like MEMREF, but which is known to have a
710 valid address. */
711 extern rtx validize_mem (rtx);
713 extern rtx use_anchored_address (rtx);
715 /* Given REF, a MEM, and T, either the type of X or the expression
716 corresponding to REF, set the memory attributes. OBJECTP is nonzero
717 if we are making a new object of this type. */
718 extern void set_mem_attributes (rtx, tree, int);
720 /* Similar, except that BITPOS has not yet been applied to REF, so if
721 we alter MEM_OFFSET according to T then we should subtract BITPOS
722 expecting that it'll be added back in later. */
723 extern void set_mem_attributes_minus_bitpos (rtx, tree, int, HOST_WIDE_INT);
725 /* Return OFFSET if XEXP (MEM, 0) - OFFSET is known to be ALIGN
726 bits aligned for 0 <= OFFSET < ALIGN / BITS_PER_UNIT, or
727 -1 if not known. */
728 extern int get_mem_align_offset (rtx, unsigned int);
730 /* Assemble the static constant template for function entry trampolines. */
731 extern rtx assemble_trampoline_template (void);
733 /* Copy given rtx to a new temp reg and return that. */
734 extern rtx copy_to_reg (rtx);
736 /* Like copy_to_reg but always make the reg Pmode. */
737 extern rtx copy_addr_to_reg (rtx);
739 /* Like copy_to_reg but always make the reg the specified mode MODE. */
740 extern rtx copy_to_mode_reg (enum machine_mode, rtx);
742 /* Copy given rtx to given temp reg and return that. */
743 extern rtx copy_to_suggested_reg (rtx, rtx, enum machine_mode);
745 /* Copy a value to a register if it isn't already a register.
746 Args are mode (in case value is a constant) and the value. */
747 extern rtx force_reg (enum machine_mode, rtx);
749 /* Return given rtx, copied into a new temp reg if it was in memory. */
750 extern rtx force_not_mem (rtx);
752 /* Return mode and signedness to use when an argument or result in the
753 given mode is promoted. */
754 extern enum machine_mode promote_function_mode (const_tree, enum machine_mode, int *,
755 const_tree, int);
757 /* Return mode and signedness to use when an object in the given mode
758 is promoted. */
759 extern enum machine_mode promote_mode (const_tree, enum machine_mode, int *);
761 /* Return mode and signedness to use when object is promoted. */
762 enum machine_mode promote_decl_mode (const_tree, int *);
764 /* Remove some bytes from the stack. An rtx says how many. */
765 extern void adjust_stack (rtx);
767 /* Add some bytes to the stack. An rtx says how many. */
768 extern void anti_adjust_stack (rtx);
770 /* This enum is used for the following two functions. */
771 enum save_level {SAVE_BLOCK, SAVE_FUNCTION, SAVE_NONLOCAL};
773 /* Save the stack pointer at the specified level. */
774 extern void emit_stack_save (enum save_level, rtx *, rtx);
776 /* Restore the stack pointer from a save area of the specified level. */
777 extern void emit_stack_restore (enum save_level, rtx, rtx);
779 /* Invoke emit_stack_save for the nonlocal_goto_save_area. */
780 extern void update_nonlocal_goto_save_area (void);
782 /* Allocate some space on the stack dynamically and return its address. An rtx
783 says how many bytes. */
784 extern rtx allocate_dynamic_stack_space (rtx, rtx, int);
786 /* Probe a range of stack addresses from FIRST to FIRST+SIZE, inclusive.
787 FIRST is a constant and size is a Pmode RTX. These are offsets from
788 the current stack pointer. STACK_GROWS_DOWNWARD says whether to add
789 or subtract them from the stack pointer. */
790 extern void probe_stack_range (HOST_WIDE_INT, rtx);
792 /* Return an rtx that refers to the value returned by a library call
793 in its original home. This becomes invalid if any more code is emitted. */
794 extern rtx hard_libcall_value (enum machine_mode, rtx);
796 /* Return the mode desired by operand N of a particular bitfield
797 insert/extract insn, or MAX_MACHINE_MODE if no such insn is
798 available. */
800 enum extraction_pattern { EP_insv, EP_extv, EP_extzv };
801 extern enum machine_mode
802 mode_for_extraction (enum extraction_pattern, int);
804 extern void store_bit_field (rtx, unsigned HOST_WIDE_INT,
805 unsigned HOST_WIDE_INT, enum machine_mode, rtx);
806 extern rtx extract_bit_field (rtx, unsigned HOST_WIDE_INT,
807 unsigned HOST_WIDE_INT, int, rtx,
808 enum machine_mode, enum machine_mode);
809 extern rtx extract_low_bits (enum machine_mode, enum machine_mode, rtx);
810 extern rtx expand_mult (enum machine_mode, rtx, rtx, rtx, int);
811 extern rtx expand_mult_highpart_adjust (enum machine_mode, rtx, rtx, rtx, rtx, int);
813 extern rtx assemble_static_space (unsigned HOST_WIDE_INT);
814 extern int safe_from_p (const_rtx, tree, int);
815 extern bool split_comparison (enum rtx_code, enum machine_mode,
816 enum rtx_code *, enum rtx_code *);
818 /* Call this once to initialize the contents of the optabs
819 appropriately for the current target machine. */
820 extern void init_optabs (void);
821 extern void init_all_optabs (void);
823 /* Call this to initialize an optab function entry. */
824 extern rtx init_one_libfunc (const char *);
825 extern rtx set_user_assembler_libfunc (const char *, const char *);
827 /* Build a decl for a libfunc named NAME. */
828 extern tree build_libfunc_function (const char *);
830 /* Get the personality libfunc for a function decl. */
831 rtx get_personality_function (tree);
833 extern int vector_mode_valid_p (enum machine_mode);
835 #endif /* GCC_EXPR_H */