trans-decl.c (create_function_arglist): Add hidden coarray
[official-gcc.git] / gcc / expr.h
blob1823febac2659aa1976b7386413cf59beb7c9dbb
1 /* Definitions for code generation pass of GNU compiler.
2 Copyright (C) 1987-2014 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
9 version.
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 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/>. */
20 #ifndef GCC_EXPR_H
21 #define GCC_EXPR_H
23 /* For inhibit_defer_pop */
24 #include "function.h"
25 /* For XEXP, GEN_INT, rtx_code */
26 #include "rtl.h"
27 /* For optimize_size */
28 #include "flags.h"
29 /* For tree_fits_[su]hwi_p, tree_to_[su]hwi, fold_convert, size_binop,
30 ssize_int, TREE_CODE, TYPE_SIZE, int_size_in_bytes, */
31 #include "tree-core.h"
32 /* For GET_MODE_BITSIZE, word_mode */
33 #include "machmode.h"
35 /* This is the 4th arg to `expand_expr'.
36 EXPAND_STACK_PARM means we are possibly expanding a call param onto
37 the stack.
38 EXPAND_SUM means it is ok to return a PLUS rtx or MULT rtx.
39 EXPAND_INITIALIZER is similar but also record any labels on forced_labels.
40 EXPAND_CONST_ADDRESS means it is ok to return a MEM whose address
41 is a constant that is not a legitimate address.
42 EXPAND_WRITE means we are only going to write to the resulting rtx.
43 EXPAND_MEMORY means we are interested in a memory result, even if
44 the memory is constant and we could have propagated a constant value,
45 or the memory is unaligned on a STRICT_ALIGNMENT target. */
46 enum expand_modifier {EXPAND_NORMAL = 0, EXPAND_STACK_PARM, EXPAND_SUM,
47 EXPAND_CONST_ADDRESS, EXPAND_INITIALIZER, EXPAND_WRITE,
48 EXPAND_MEMORY};
50 /* Prevent the compiler from deferring stack pops. See
51 inhibit_defer_pop for more information. */
52 #define NO_DEFER_POP (inhibit_defer_pop += 1)
54 /* Allow the compiler to defer stack pops. See inhibit_defer_pop for
55 more information. */
56 #define OK_DEFER_POP (inhibit_defer_pop -= 1)
58 enum direction {none, upward, downward};
60 /* Structure to record the size of a sequence of arguments
61 as the sum of a tree-expression and a constant. This structure is
62 also used to store offsets from the stack, which might be negative,
63 so the variable part must be ssizetype, not sizetype. */
65 struct args_size
67 HOST_WIDE_INT constant;
68 tree var;
71 /* Package up various arg related fields of struct args for
72 locate_and_pad_parm. */
73 struct locate_and_pad_arg_data
75 /* Size of this argument on the stack, rounded up for any padding it
76 gets. If REG_PARM_STACK_SPACE is defined, then register parms are
77 counted here, otherwise they aren't. */
78 struct args_size size;
79 /* Offset of this argument from beginning of stack-args. */
80 struct args_size offset;
81 /* Offset to the start of the stack slot. Different from OFFSET
82 if this arg pads downward. */
83 struct args_size slot_offset;
84 /* The amount that the stack pointer needs to be adjusted to
85 force alignment for the next argument. */
86 struct args_size alignment_pad;
87 /* Which way we should pad this arg. */
88 enum direction where_pad;
89 /* slot_offset is at least this aligned. */
90 unsigned int boundary;
93 /* Add the value of the tree INC to the `struct args_size' TO. */
95 #define ADD_PARM_SIZE(TO, INC) \
96 do { \
97 tree inc = (INC); \
98 if (tree_fits_shwi_p (inc)) \
99 (TO).constant += tree_to_shwi (inc); \
100 else if ((TO).var == 0) \
101 (TO).var = fold_convert (ssizetype, inc); \
102 else \
103 (TO).var = size_binop (PLUS_EXPR, (TO).var, \
104 fold_convert (ssizetype, inc)); \
105 } while (0)
107 #define SUB_PARM_SIZE(TO, DEC) \
108 do { \
109 tree dec = (DEC); \
110 if (tree_fits_shwi_p (dec)) \
111 (TO).constant -= tree_to_shwi (dec); \
112 else if ((TO).var == 0) \
113 (TO).var = size_binop (MINUS_EXPR, ssize_int (0), \
114 fold_convert (ssizetype, dec)); \
115 else \
116 (TO).var = size_binop (MINUS_EXPR, (TO).var, \
117 fold_convert (ssizetype, dec)); \
118 } while (0)
120 /* Convert the implicit sum in a `struct args_size' into a tree
121 of type ssizetype. */
122 #define ARGS_SIZE_TREE(SIZE) \
123 ((SIZE).var == 0 ? ssize_int ((SIZE).constant) \
124 : size_binop (PLUS_EXPR, fold_convert (ssizetype, (SIZE).var), \
125 ssize_int ((SIZE).constant)))
127 /* Convert the implicit sum in a `struct args_size' into an rtx. */
128 #define ARGS_SIZE_RTX(SIZE) \
129 ((SIZE).var == 0 ? GEN_INT ((SIZE).constant) \
130 : expand_normal (ARGS_SIZE_TREE (SIZE)))
133 /* This structure is used to pass around information about exploded
134 unary, binary and trinary expressions between expand_expr_real_1 and
135 friends. */
136 typedef struct separate_ops
138 enum tree_code code;
139 location_t location;
140 tree type;
141 tree op0, op1, op2;
142 } *sepops;
144 /* Functions from optabs.c, commonly used, and without need for the optabs
145 tables: */
147 /* Passed to expand_simple_binop and expand_binop to say which options
148 to try to use if the requested operation can't be open-coded on the
149 requisite mode. Either OPTAB_LIB or OPTAB_LIB_WIDEN says try using
150 a library call. Either OPTAB_WIDEN or OPTAB_LIB_WIDEN says try
151 using a wider mode. OPTAB_MUST_WIDEN says try widening and don't
152 try anything else. */
154 enum optab_methods
156 OPTAB_DIRECT,
157 OPTAB_LIB,
158 OPTAB_WIDEN,
159 OPTAB_LIB_WIDEN,
160 OPTAB_MUST_WIDEN
163 /* Generate code for a simple binary or unary operation. "Simple" in
164 this case means "can be unambiguously described by a (mode, code)
165 pair and mapped to a single optab." */
166 extern rtx expand_simple_binop (enum machine_mode, enum rtx_code, rtx,
167 rtx, rtx, int, enum optab_methods);
168 extern rtx expand_simple_unop (enum machine_mode, enum rtx_code, rtx, rtx,
169 int);
171 /* Report whether the machine description contains an insn which can
172 perform the operation described by CODE and MODE. */
173 extern int have_insn_for (enum rtx_code, enum machine_mode);
175 /* Emit code to make a call to a constant function or a library call. */
176 extern void emit_libcall_block (rtx, rtx, rtx, rtx);
178 /* Create but don't emit one rtl instruction to perform certain operations.
179 Modes must match; operands must meet the operation's predicates.
180 Likewise for subtraction and for just copying. */
181 extern rtx gen_add2_insn (rtx, rtx);
182 extern rtx gen_add3_insn (rtx, rtx, rtx);
183 extern rtx gen_addptr3_insn (rtx, rtx, rtx);
184 extern rtx gen_sub2_insn (rtx, rtx);
185 extern rtx gen_sub3_insn (rtx, rtx, rtx);
186 extern rtx gen_move_insn (rtx, rtx);
187 extern int have_add2_insn (rtx, rtx);
188 extern int have_addptr3_insn (rtx, rtx, rtx);
189 extern int have_sub2_insn (rtx, rtx);
191 /* Emit a pair of rtl insns to compare two rtx's and to jump
192 to a label if the comparison is true. */
193 extern void emit_cmp_and_jump_insns (rtx, rtx, enum rtx_code, rtx,
194 enum machine_mode, int, rtx, int prob=-1);
196 /* Generate code to indirectly jump to a location given in the rtx LOC. */
197 extern void emit_indirect_jump (rtx);
199 /* Generate a conditional trap instruction. */
200 extern rtx gen_cond_trap (enum rtx_code, rtx, rtx, rtx);
202 #include "insn-config.h"
204 #ifdef HAVE_conditional_move
205 /* Emit a conditional move operation. */
206 rtx emit_conditional_move (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
207 rtx, rtx, enum machine_mode, int);
209 /* Return nonzero if the conditional move is supported. */
210 int can_conditionally_move_p (enum machine_mode mode);
212 #endif
213 rtx emit_conditional_add (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
214 rtx, rtx, enum machine_mode, int);
216 rtx expand_sync_operation (rtx, rtx, enum rtx_code);
217 rtx expand_sync_fetch_operation (rtx, rtx, enum rtx_code, bool, rtx);
218 rtx expand_sync_lock_test_and_set (rtx, rtx, rtx);
220 rtx expand_atomic_exchange (rtx, rtx, rtx, enum memmodel);
221 rtx expand_atomic_load (rtx, rtx, enum memmodel);
222 rtx expand_atomic_store (rtx, rtx, enum memmodel, bool);
223 rtx expand_atomic_fetch_op (rtx, rtx, rtx, enum rtx_code, enum memmodel,
224 bool);
225 rtx expand_atomic_test_and_set (rtx, rtx, enum memmodel);
226 rtx expand_atomic_clear (rtx, enum memmodel);
227 void expand_atomic_thread_fence (enum memmodel);
228 void expand_atomic_signal_fence (enum memmodel);
231 /* Functions from expmed.c: */
233 /* Arguments MODE, RTX: return an rtx for the negation of that value.
234 May emit insns. */
235 extern rtx negate_rtx (enum machine_mode, rtx);
237 /* Expand a logical AND operation. */
238 extern rtx expand_and (enum machine_mode, rtx, rtx, rtx);
240 /* Emit a store-flag operation. */
241 extern rtx emit_store_flag (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
242 int, int);
244 /* Like emit_store_flag, but always succeeds. */
245 extern rtx emit_store_flag_force (rtx, enum rtx_code, rtx, rtx,
246 enum machine_mode, int, int);
248 /* Choose a minimal N + 1 bit approximation to 1/D that can be used to
249 replace division by D, and put the least significant N bits of the result
250 in *MULTIPLIER_PTR and return the most significant bit. */
251 extern unsigned HOST_WIDE_INT choose_multiplier (unsigned HOST_WIDE_INT, int,
252 int, unsigned HOST_WIDE_INT *,
253 int *, int *);
255 /* Functions from builtins.c: */
256 extern rtx expand_builtin (tree, rtx, rtx, enum machine_mode, int);
257 extern tree std_build_builtin_va_list (void);
258 extern tree std_fn_abi_va_list (tree);
259 extern tree std_canonical_va_list_type (tree);
261 extern void std_expand_builtin_va_start (tree, rtx);
262 extern rtx default_expand_builtin (tree, rtx, rtx, enum machine_mode, int);
263 extern void expand_builtin_setjmp_setup (rtx, rtx);
264 extern void expand_builtin_setjmp_receiver (rtx);
265 extern rtx expand_builtin_saveregs (void);
266 extern void expand_builtin_trap (void);
267 extern rtx builtin_strncpy_read_str (void *, HOST_WIDE_INT, enum machine_mode);
269 /* Functions from expr.c: */
271 /* This is run during target initialization to set up which modes can be
272 used directly in memory and to initialize the block move optab. */
273 extern void init_expr_target (void);
275 /* This is run at the start of compiling a function. */
276 extern void init_expr (void);
278 /* Emit some rtl insns to move data between rtx's, converting machine modes.
279 Both modes must be floating or both fixed. */
280 extern void convert_move (rtx, rtx, int);
282 /* Convert an rtx to specified machine mode and return the result. */
283 extern rtx convert_to_mode (enum machine_mode, rtx, int);
285 /* Convert an rtx to MODE from OLDMODE and return the result. */
286 extern rtx convert_modes (enum machine_mode, enum machine_mode, rtx, int);
288 /* Emit code to move a block Y to a block X. */
290 enum block_op_methods
292 BLOCK_OP_NORMAL,
293 BLOCK_OP_NO_LIBCALL,
294 BLOCK_OP_CALL_PARM,
295 /* Like BLOCK_OP_NORMAL, but the libcall can be tail call optimized. */
296 BLOCK_OP_TAILCALL
299 extern GTY(()) tree block_clear_fn;
300 extern void init_block_move_fn (const char *);
301 extern void init_block_clear_fn (const char *);
303 extern rtx emit_block_move (rtx, rtx, rtx, enum block_op_methods);
304 extern rtx emit_block_move_via_libcall (rtx, rtx, rtx, bool);
305 extern rtx emit_block_move_hints (rtx, rtx, rtx, enum block_op_methods,
306 unsigned int, HOST_WIDE_INT,
307 unsigned HOST_WIDE_INT,
308 unsigned HOST_WIDE_INT,
309 unsigned HOST_WIDE_INT);
310 extern bool emit_storent_insn (rtx to, rtx from);
312 /* Copy all or part of a value X into registers starting at REGNO.
313 The number of registers to be filled is NREGS. */
314 extern void move_block_to_reg (int, rtx, int, enum machine_mode);
316 /* Copy all or part of a BLKmode value X out of registers starting at REGNO.
317 The number of registers to be filled is NREGS. */
318 extern void move_block_from_reg (int, rtx, int);
320 /* Generate a non-consecutive group of registers represented by a PARALLEL. */
321 extern rtx gen_group_rtx (rtx);
323 /* Load a BLKmode value into non-consecutive registers represented by a
324 PARALLEL. */
325 extern void emit_group_load (rtx, rtx, tree, int);
327 /* Similarly, but load into new temporaries. */
328 extern rtx emit_group_load_into_temps (rtx, rtx, tree, int);
330 /* Move a non-consecutive group of registers represented by a PARALLEL into
331 a non-consecutive group of registers represented by a PARALLEL. */
332 extern void emit_group_move (rtx, rtx);
334 /* Move a group of registers represented by a PARALLEL into pseudos. */
335 extern rtx emit_group_move_into_temps (rtx);
337 /* Store a BLKmode value from non-consecutive registers represented by a
338 PARALLEL. */
339 extern void emit_group_store (rtx, rtx, tree, int);
341 extern rtx maybe_emit_group_store (rtx, tree);
343 /* Copy BLKmode object from a set of registers. */
344 extern void copy_blkmode_from_reg (rtx, rtx, tree);
346 /* Mark REG as holding a parameter for the next CALL_INSN.
347 Mode is TYPE_MODE of the non-promoted parameter, or VOIDmode. */
348 extern void use_reg_mode (rtx *, rtx, enum machine_mode);
349 extern void clobber_reg_mode (rtx *, rtx, enum machine_mode);
351 extern rtx copy_blkmode_to_reg (enum machine_mode, tree);
353 /* Mark REG as holding a parameter for the next CALL_INSN. */
354 static inline void
355 use_reg (rtx *fusage, rtx reg)
357 use_reg_mode (fusage, reg, VOIDmode);
360 /* Mark REG as clobbered by the call with FUSAGE as CALL_INSN_FUNCTION_USAGE. */
361 static inline void
362 clobber_reg (rtx *fusage, rtx reg)
364 clobber_reg_mode (fusage, reg, VOIDmode);
367 /* Mark NREGS consecutive regs, starting at REGNO, as holding parameters
368 for the next CALL_INSN. */
369 extern void use_regs (rtx *, int, int);
371 /* Mark a PARALLEL as holding a parameter for the next CALL_INSN. */
372 extern void use_group_regs (rtx *, rtx);
374 /* Write zeros through the storage of OBJECT.
375 If OBJECT has BLKmode, SIZE is its length in bytes. */
376 extern rtx clear_storage (rtx, rtx, enum block_op_methods);
377 extern rtx clear_storage_hints (rtx, rtx, enum block_op_methods,
378 unsigned int, HOST_WIDE_INT,
379 unsigned HOST_WIDE_INT,
380 unsigned HOST_WIDE_INT,
381 unsigned HOST_WIDE_INT);
382 /* The same, but always output an library call. */
383 rtx set_storage_via_libcall (rtx, rtx, rtx, bool);
385 /* Expand a setmem pattern; return true if successful. */
386 extern bool set_storage_via_setmem (rtx, rtx, rtx, unsigned int,
387 unsigned int, HOST_WIDE_INT,
388 unsigned HOST_WIDE_INT,
389 unsigned HOST_WIDE_INT,
390 unsigned HOST_WIDE_INT);
392 extern unsigned HOST_WIDE_INT move_by_pieces_ninsns (unsigned HOST_WIDE_INT,
393 unsigned int,
394 unsigned int);
396 /* Return nonzero if it is desirable to store LEN bytes generated by
397 CONSTFUN with several move instructions by store_by_pieces
398 function. CONSTFUNDATA is a pointer which will be passed as argument
399 in every CONSTFUN call.
400 ALIGN is maximum alignment we can assume.
401 MEMSETP is true if this is a real memset/bzero, not a copy
402 of a const string. */
403 extern int can_store_by_pieces (unsigned HOST_WIDE_INT,
404 rtx (*) (void *, HOST_WIDE_INT,
405 enum machine_mode),
406 void *, unsigned int, bool);
408 /* Generate several move instructions to store LEN bytes generated by
409 CONSTFUN to block TO. (A MEM rtx with BLKmode). CONSTFUNDATA is a
410 pointer which will be passed as argument in every CONSTFUN call.
411 ALIGN is maximum alignment we can assume.
412 MEMSETP is true if this is a real memset/bzero, not a copy.
413 Returns TO + LEN. */
414 extern rtx store_by_pieces (rtx, unsigned HOST_WIDE_INT,
415 rtx (*) (void *, HOST_WIDE_INT, enum machine_mode),
416 void *, unsigned int, bool, int);
418 /* Emit insns to set X from Y. */
419 extern rtx emit_move_insn (rtx, rtx);
421 /* Emit insns to set X from Y, with no frills. */
422 extern rtx emit_move_insn_1 (rtx, rtx);
424 extern rtx emit_move_complex_push (enum machine_mode, rtx, rtx);
425 extern rtx emit_move_complex_parts (rtx, rtx);
426 extern rtx emit_move_resolve_push (enum machine_mode, rtx);
428 /* Push a block of length SIZE (perhaps variable)
429 and return an rtx to address the beginning of the block. */
430 extern rtx push_block (rtx, int, int);
432 /* Generate code to push something onto the stack, given its mode and type. */
433 extern void emit_push_insn (rtx, enum machine_mode, tree, rtx, unsigned int,
434 int, rtx, int, rtx, rtx, int, rtx);
436 /* Expand an assignment that stores the value of FROM into TO. */
437 extern void expand_assignment (tree, tree, bool);
439 /* Generate code for computing expression EXP,
440 and storing the value into TARGET.
441 If SUGGEST_REG is nonzero, copy the value through a register
442 and return that register, if that is possible. */
443 extern rtx store_expr (tree, rtx, int, bool);
445 /* Given an rtx that may include add and multiply operations,
446 generate them as insns and return a pseudo-reg containing the value.
447 Useful after calling expand_expr with 1 as sum_ok. */
448 extern rtx force_operand (rtx, rtx);
450 /* Work horses for expand_expr. */
451 extern rtx expand_expr_real (tree, rtx, enum machine_mode,
452 enum expand_modifier, rtx *, bool);
453 extern rtx expand_expr_real_1 (tree, rtx, enum machine_mode,
454 enum expand_modifier, rtx *, bool);
455 extern rtx expand_expr_real_2 (sepops, rtx, enum machine_mode,
456 enum expand_modifier);
458 /* Generate code for computing expression EXP.
459 An rtx for the computed value is returned. The value is never null.
460 In the case of a void EXP, const0_rtx is returned. */
461 static inline rtx
462 expand_expr (tree exp, rtx target, enum machine_mode mode,
463 enum expand_modifier modifier)
465 return expand_expr_real (exp, target, mode, modifier, NULL, false);
468 static inline rtx
469 expand_normal (tree exp)
471 return expand_expr_real (exp, NULL_RTX, VOIDmode, EXPAND_NORMAL, NULL, false);
474 /* At the start of a function, record that we have no previously-pushed
475 arguments waiting to be popped. */
476 extern void init_pending_stack_adjust (void);
478 /* Discard any pending stack adjustment. */
479 extern void discard_pending_stack_adjust (void);
481 /* When exiting from function, if safe, clear out any pending stack adjust
482 so the adjustment won't get done. */
483 extern void clear_pending_stack_adjust (void);
485 /* Pop any previously-pushed arguments that have not been popped yet. */
486 extern void do_pending_stack_adjust (void);
488 /* Struct for saving/restoring of pending_stack_adjust/stack_pointer_delta
489 values. */
491 struct saved_pending_stack_adjust
493 /* Saved value of pending_stack_adjust. */
494 int x_pending_stack_adjust;
496 /* Saved value of stack_pointer_delta. */
497 int x_stack_pointer_delta;
500 /* Remember pending_stack_adjust/stack_pointer_delta.
501 To be used around code that may call do_pending_stack_adjust (),
502 but the generated code could be discarded e.g. using delete_insns_since. */
504 extern void save_pending_stack_adjust (saved_pending_stack_adjust *);
506 /* Restore the saved pending_stack_adjust/stack_pointer_delta. */
508 extern void restore_pending_stack_adjust (saved_pending_stack_adjust *);
510 /* Return the tree node and offset if a given argument corresponds to
511 a string constant. */
512 extern tree string_constant (tree, tree *);
514 /* Generate code to evaluate EXP and jump to LABEL if the value is zero. */
515 extern void jumpifnot (tree, rtx, int);
516 extern void jumpifnot_1 (enum tree_code, tree, tree, rtx, int);
518 /* Generate code to evaluate EXP and jump to LABEL if the value is nonzero. */
519 extern void jumpif (tree, rtx, int);
520 extern void jumpif_1 (enum tree_code, tree, tree, rtx, int);
522 /* Generate code to evaluate EXP and jump to IF_FALSE_LABEL if
523 the result is zero, or IF_TRUE_LABEL if the result is one. */
524 extern void do_jump (tree, rtx, rtx, int);
525 extern void do_jump_1 (enum tree_code, tree, tree, rtx, rtx, int);
527 extern void do_compare_rtx_and_jump (rtx, rtx, enum rtx_code, int,
528 enum machine_mode, rtx, rtx, rtx, int);
530 /* Two different ways of generating switch statements. */
531 extern int try_casesi (tree, tree, tree, tree, rtx, rtx, rtx, int);
532 extern int try_tablejump (tree, tree, tree, tree, rtx, rtx, int);
534 /* Functions from alias.c */
535 #include "alias.h"
538 /* rtl.h and tree.h were included. */
539 /* Return an rtx for the size in bytes of the value of an expr. */
540 extern rtx expr_size (tree);
542 /* Return a wide integer for the size in bytes of the value of EXP, or -1
543 if the size can vary or is larger than an integer. */
544 extern HOST_WIDE_INT int_expr_size (tree);
546 /* Return an rtx that refers to the value returned by a function
547 in its original home. This becomes invalid if any more code is emitted. */
548 extern rtx hard_function_value (const_tree, const_tree, const_tree, int);
550 extern rtx prepare_call_address (tree, rtx, rtx, rtx *, int, int);
552 extern bool shift_return_value (enum machine_mode, bool, rtx);
554 extern rtx expand_call (tree, rtx, int);
556 extern void fixup_tail_calls (void);
558 #ifdef TREE_CODE
559 extern rtx expand_variable_shift (enum tree_code, enum machine_mode,
560 rtx, tree, rtx, int);
561 extern rtx expand_shift (enum tree_code, enum machine_mode, rtx, int, rtx,
562 int);
563 extern rtx expand_divmod (int, enum tree_code, enum machine_mode, rtx, rtx,
564 rtx, int);
565 #endif
567 extern void locate_and_pad_parm (enum machine_mode, tree, int, int, int,
568 tree, struct args_size *,
569 struct locate_and_pad_arg_data *);
571 /* Return the CODE_LABEL rtx for a LABEL_DECL, creating it if necessary. */
572 extern rtx label_rtx (tree);
574 /* As label_rtx, but additionally the label is placed on the forced label
575 list of its containing function (i.e. it is treated as reachable even
576 if how is not obvious). */
577 extern rtx force_label_rtx (tree);
579 /* Return an rtx like arg but sans any constant terms.
580 Returns the original rtx if it has no constant terms.
581 The constant terms are added and stored via a second arg. */
582 extern rtx eliminate_constant_term (rtx, rtx *);
584 /* Convert arg to a valid memory address for specified machine mode that points
585 to a specific named address space, by emitting insns to perform arithmetic
586 if necessary. */
587 extern rtx memory_address_addr_space (enum machine_mode, rtx, addr_space_t);
589 /* Like memory_address_addr_space, except assume the memory address points to
590 the generic named address space. */
591 #define memory_address(MODE,RTX) \
592 memory_address_addr_space ((MODE), (RTX), ADDR_SPACE_GENERIC)
594 /* Return a memory reference like MEMREF, but with its mode changed
595 to MODE and its address changed to ADDR.
596 (VOIDmode means don't change the mode.
597 NULL for ADDR means don't change the address.) */
598 extern rtx change_address (rtx, enum machine_mode, rtx);
600 /* Return a memory reference like MEMREF, but with its mode changed
601 to MODE and its address offset by OFFSET bytes. */
602 #define adjust_address(MEMREF, MODE, OFFSET) \
603 adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1, 0, 0)
605 /* Likewise, but the reference is not required to be valid. */
606 #define adjust_address_nv(MEMREF, MODE, OFFSET) \
607 adjust_address_1 (MEMREF, MODE, OFFSET, 0, 1, 0, 0)
609 /* Return a memory reference like MEMREF, but with its mode changed
610 to MODE and its address offset by OFFSET bytes. Assume that it's
611 for a bitfield and conservatively drop the underlying object if we
612 cannot be sure to stay within its bounds. */
613 #define adjust_bitfield_address(MEMREF, MODE, OFFSET) \
614 adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1, 1, 0)
616 /* As for adjust_bitfield_address, but specify that the width of
617 BLKmode accesses is SIZE bytes. */
618 #define adjust_bitfield_address_size(MEMREF, MODE, OFFSET, SIZE) \
619 adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1, 1, SIZE)
621 /* Likewise, but the reference is not required to be valid. */
622 #define adjust_bitfield_address_nv(MEMREF, MODE, OFFSET) \
623 adjust_address_1 (MEMREF, MODE, OFFSET, 0, 1, 1, 0)
625 /* Return a memory reference like MEMREF, but with its mode changed
626 to MODE and its address changed to ADDR, which is assumed to be
627 increased by OFFSET bytes from MEMREF. */
628 #define adjust_automodify_address(MEMREF, MODE, ADDR, OFFSET) \
629 adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 1)
631 /* Likewise, but the reference is not required to be valid. */
632 #define adjust_automodify_address_nv(MEMREF, MODE, ADDR, OFFSET) \
633 adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 0)
635 extern rtx adjust_address_1 (rtx, enum machine_mode, HOST_WIDE_INT, int, int,
636 int, HOST_WIDE_INT);
637 extern rtx adjust_automodify_address_1 (rtx, enum machine_mode, rtx,
638 HOST_WIDE_INT, int);
640 /* Return a memory reference like MEMREF, but whose address is changed by
641 adding OFFSET, an RTX, to it. POW2 is the highest power of two factor
642 known to be in OFFSET (possibly 1). */
643 extern rtx offset_address (rtx, rtx, unsigned HOST_WIDE_INT);
645 /* Definitions from emit-rtl.c */
646 #include "emit-rtl.h"
648 /* Return a memory reference like MEMREF, but with its mode widened to
649 MODE and adjusted by OFFSET. */
650 extern rtx widen_memory_access (rtx, enum machine_mode, HOST_WIDE_INT);
652 /* Return a memory reference like MEMREF, but which is known to have a
653 valid address. */
654 extern rtx validize_mem (rtx);
656 extern rtx use_anchored_address (rtx);
658 /* Given REF, a MEM, and T, either the type of X or the expression
659 corresponding to REF, set the memory attributes. OBJECTP is nonzero
660 if we are making a new object of this type. */
661 extern void set_mem_attributes (rtx, tree, int);
663 /* Similar, except that BITPOS has not yet been applied to REF, so if
664 we alter MEM_OFFSET according to T then we should subtract BITPOS
665 expecting that it'll be added back in later. */
666 extern void set_mem_attributes_minus_bitpos (rtx, tree, int, HOST_WIDE_INT);
668 /* Return OFFSET if XEXP (MEM, 0) - OFFSET is known to be ALIGN
669 bits aligned for 0 <= OFFSET < ALIGN / BITS_PER_UNIT, or
670 -1 if not known. */
671 extern int get_mem_align_offset (rtx, unsigned int);
673 /* Assemble the static constant template for function entry trampolines. */
674 extern rtx assemble_trampoline_template (void);
676 /* Copy given rtx to a new temp reg and return that. */
677 extern rtx copy_to_reg (rtx);
679 /* Like copy_to_reg but always make the reg Pmode. */
680 extern rtx copy_addr_to_reg (rtx);
682 /* Like copy_to_reg but always make the reg the specified mode MODE. */
683 extern rtx copy_to_mode_reg (enum machine_mode, rtx);
685 /* Copy given rtx to given temp reg and return that. */
686 extern rtx copy_to_suggested_reg (rtx, rtx, enum machine_mode);
688 /* Copy a value to a register if it isn't already a register.
689 Args are mode (in case value is a constant) and the value. */
690 extern rtx force_reg (enum machine_mode, rtx);
692 /* Return given rtx, copied into a new temp reg if it was in memory. */
693 extern rtx force_not_mem (rtx);
695 /* Return mode and signedness to use when an argument or result in the
696 given mode is promoted. */
697 extern enum machine_mode promote_function_mode (const_tree, enum machine_mode, int *,
698 const_tree, int);
700 /* Return mode and signedness to use when an object in the given mode
701 is promoted. */
702 extern enum machine_mode promote_mode (const_tree, enum machine_mode, int *);
704 /* Return mode and signedness to use when object is promoted. */
705 enum machine_mode promote_decl_mode (const_tree, int *);
707 /* Remove some bytes from the stack. An rtx says how many. */
708 extern void adjust_stack (rtx);
710 /* Add some bytes to the stack. An rtx says how many. */
711 extern void anti_adjust_stack (rtx);
713 /* Add some bytes to the stack while probing it. An rtx says how many. */
714 extern void anti_adjust_stack_and_probe (rtx, bool);
716 /* This enum is used for the following two functions. */
717 enum save_level {SAVE_BLOCK, SAVE_FUNCTION, SAVE_NONLOCAL};
719 /* Save the stack pointer at the specified level. */
720 extern void emit_stack_save (enum save_level, rtx *);
722 /* Restore the stack pointer from a save area of the specified level. */
723 extern void emit_stack_restore (enum save_level, rtx);
725 /* Invoke emit_stack_save for the nonlocal_goto_save_area. */
726 extern void update_nonlocal_goto_save_area (void);
728 /* Allocate some space on the stack dynamically and return its address. */
729 extern rtx allocate_dynamic_stack_space (rtx, unsigned, unsigned, bool);
731 /* Emit one stack probe at ADDRESS, an address within the stack. */
732 extern void emit_stack_probe (rtx);
734 /* Probe a range of stack addresses from FIRST to FIRST+SIZE, inclusive.
735 FIRST is a constant and size is a Pmode RTX. These are offsets from
736 the current stack pointer. STACK_GROWS_DOWNWARD says whether to add
737 or subtract them from the stack pointer. */
738 extern void probe_stack_range (HOST_WIDE_INT, rtx);
740 /* Return an rtx that refers to the value returned by a library call
741 in its original home. This becomes invalid if any more code is emitted. */
742 extern rtx hard_libcall_value (enum machine_mode, rtx);
744 extern void store_bit_field (rtx, unsigned HOST_WIDE_INT,
745 unsigned HOST_WIDE_INT,
746 unsigned HOST_WIDE_INT,
747 unsigned HOST_WIDE_INT,
748 enum machine_mode, rtx);
749 extern rtx extract_bit_field (rtx, unsigned HOST_WIDE_INT,
750 unsigned HOST_WIDE_INT, int, rtx,
751 enum machine_mode, enum machine_mode);
752 extern rtx extract_low_bits (enum machine_mode, enum machine_mode, rtx);
753 extern rtx expand_mult (enum machine_mode, rtx, rtx, rtx, int);
754 extern rtx expand_mult_highpart_adjust (enum machine_mode, rtx, rtx, rtx, rtx, int);
756 extern rtx assemble_static_space (unsigned HOST_WIDE_INT);
757 extern int safe_from_p (const_rtx, tree, int);
758 extern bool split_comparison (enum rtx_code, enum machine_mode,
759 enum rtx_code *, enum rtx_code *);
761 /* Call this once to initialize the contents of the optabs
762 appropriately for the current target machine. */
763 extern void init_optabs (void);
764 extern void init_all_optabs (struct target_optabs *);
766 /* Call this to initialize an optab function entry. */
767 extern rtx init_one_libfunc (const char *);
768 extern rtx set_user_assembler_libfunc (const char *, const char *);
770 /* Build a decl for a libfunc named NAME. */
771 extern tree build_libfunc_function (const char *);
773 /* Get the personality libfunc for a function decl. */
774 rtx get_personality_function (tree);
777 /* In stmt.c */
779 /* Expand a GIMPLE_SWITCH statement. */
780 extern void expand_case (gimple);
782 /* Like expand_case but special-case for SJLJ exception dispatching. */
783 extern void expand_sjlj_dispatch_table (rtx, vec<tree> );
785 /* Determine whether the LEN bytes can be moved by using several move
786 instructions. Return nonzero if a call to move_by_pieces should
787 succeed. */
788 extern int can_move_by_pieces (unsigned HOST_WIDE_INT, unsigned int);
790 extern unsigned HOST_WIDE_INT highest_pow2_factor (const_tree);
791 bool array_at_struct_end_p (tree);
793 /* Return a tree of sizetype representing the size, in bytes, of the element
794 of EXP, an ARRAY_REF or an ARRAY_RANGE_REF. */
795 extern tree array_ref_element_size (tree);
797 extern bool categorize_ctor_elements (const_tree, HOST_WIDE_INT *,
798 HOST_WIDE_INT *, bool *);
800 /* Return a tree representing the offset, in bytes, of the field referenced
801 by EXP. This does not include any offset in DECL_FIELD_BIT_OFFSET. */
802 extern tree component_ref_field_offset (tree);
804 #endif /* GCC_EXPR_H */