gcc/expr.h

   1 /* Definitions for code generation pass of GNU compiler.
   2    Copyright (C) 1987-2014 Free Software Foundation, Inc.
   3
   4 This file is part of GCC.
   5
   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.
  10
  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.
  15
  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/>.  */
  19
  20 #ifndef GCC_EXPR_H
  21 #define GCC_EXPR_H
  22
  23 /* For inhibit_defer_pop */
  24 #include "hashtab.h"
  25 #include "hash-set.h"
  26 #include "vec.h"
  27 #include "machmode.h"
  28 #include "tm.h"
  29 #include "hard-reg-set.h"
  30 #include "input.h"
  31 #include "function.h"
  32 /* For XEXP, GEN_INT, rtx_code */
  33 #include "rtl.h"
  34 /* For optimize_size */
  35 #include "flags.h"
  36 /* For tree_fits_[su]hwi_p, tree_to_[su]hwi, fold_convert, size_binop,
  37    ssize_int, TREE_CODE, TYPE_SIZE, int_size_in_bytes,    */
  38 #include "tree-core.h"
  39 /* For GET_MODE_BITSIZE, word_mode */
  40
  41 /* This is the 4th arg to `expand_expr'.
  42    EXPAND_STACK_PARM means we are possibly expanding a call param onto
  43    the stack.
  44    EXPAND_SUM means it is ok to return a PLUS rtx or MULT rtx.
  45    EXPAND_INITIALIZER is similar but also record any labels on forced_labels.
  46    EXPAND_CONST_ADDRESS means it is ok to return a MEM whose address
  47     is a constant that is not a legitimate address.
  48    EXPAND_WRITE means we are only going to write to the resulting rtx.
  49    EXPAND_MEMORY means we are interested in a memory result, even if
  50     the memory is constant and we could have propagated a constant value,
  51     or the memory is unaligned on a STRICT_ALIGNMENT target.  */
  52 enum expand_modifier {EXPAND_NORMAL = 0, EXPAND_STACK_PARM, EXPAND_SUM,
  53                       EXPAND_CONST_ADDRESS, EXPAND_INITIALIZER, EXPAND_WRITE,
  54                       EXPAND_MEMORY};
  55
  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)
  59
  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)
  63 \f
  64 /* This structure is used to pass around information about exploded
  65    unary, binary and trinary expressions between expand_expr_real_1 and
  66    friends.  */
  67 typedef struct separate_ops
  68 {
  69   enum tree_code code;
  70   location_t location;
  71   tree type;
  72   tree op0, op1, op2;
  73 } *sepops;
  74 \f
  75 /* Functions from optabs.c, commonly used, and without need for the optabs
  76    tables:  */
  77
  78 /* Passed to expand_simple_binop and expand_binop to say which options
  79    to try to use if the requested operation can't be open-coded on the
  80    requisite mode.  Either OPTAB_LIB or OPTAB_LIB_WIDEN says try using
  81    a library call.  Either OPTAB_WIDEN or OPTAB_LIB_WIDEN says try
  82    using a wider mode.  OPTAB_MUST_WIDEN says try widening and don't
  83    try anything else.  */
  84
  85 enum optab_methods
  86 {
  87   OPTAB_DIRECT,
  88   OPTAB_LIB,
  89   OPTAB_WIDEN,
  90   OPTAB_LIB_WIDEN,
  91   OPTAB_MUST_WIDEN
  92 };
  93
  94 /* Generate code for a simple binary or unary operation.  "Simple" in
  95    this case means "can be unambiguously described by a (mode, code)
  96    pair and mapped to a single optab."  */
  97 extern rtx expand_simple_binop (enum machine_mode, enum rtx_code, rtx,
  98                                 rtx, rtx, int, enum optab_methods);
  99 extern rtx expand_simple_unop (enum machine_mode, enum rtx_code, rtx, rtx,
 100                                int);
 101
 102 /* Report whether the machine description contains an insn which can
 103    perform the operation described by CODE and MODE.  */
 104 extern int have_insn_for (enum rtx_code, enum machine_mode);
 105
 106 /* Emit code to make a call to a constant function or a library call.  */
 107 extern void emit_libcall_block (rtx, rtx, rtx, rtx);
 108
 109 /* Create but don't emit one rtl instruction to perform certain operations.
 110    Modes must match; operands must meet the operation's predicates.
 111    Likewise for subtraction and for just copying.  */
 112 extern rtx gen_add2_insn (rtx, rtx);
 113 extern rtx gen_add3_insn (rtx, rtx, rtx);
 114 extern rtx gen_addptr3_insn (rtx, rtx, rtx);
 115 extern rtx gen_sub2_insn (rtx, rtx);
 116 extern rtx gen_sub3_insn (rtx, rtx, rtx);
 117 extern rtx gen_move_insn (rtx, rtx);
 118 extern int have_add2_insn (rtx, rtx);
 119 extern int have_addptr3_insn (rtx, rtx, rtx);
 120 extern int have_sub2_insn (rtx, rtx);
 121
 122 /* Emit a pair of rtl insns to compare two rtx's and to jump
 123    to a label if the comparison is true.  */
 124 extern void emit_cmp_and_jump_insns (rtx, rtx, enum rtx_code, rtx,
 125                                      enum machine_mode, int, rtx, int prob=-1);
 126
 127 /* Generate code to indirectly jump to a location given in the rtx LOC.  */
 128 extern void emit_indirect_jump (rtx);
 129
 130 /* Generate a conditional trap instruction.  */
 131 extern rtx gen_cond_trap (enum rtx_code, rtx, rtx, rtx);
 132
 133 #include "insn-config.h"
 134
 135 #ifdef HAVE_conditional_move
 136 /* Emit a conditional move operation.  */
 137 rtx emit_conditional_move (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
 138                            rtx, rtx, enum machine_mode, int);
 139
 140 /* Return nonzero if the conditional move is supported.  */
 141 int can_conditionally_move_p (enum machine_mode mode);
 142
 143 #endif
 144 rtx emit_conditional_add (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
 145                           rtx, rtx, enum machine_mode, int);
 146
 147 rtx expand_sync_operation (rtx, rtx, enum rtx_code);
 148 rtx expand_sync_fetch_operation (rtx, rtx, enum rtx_code, bool, rtx);
 149 rtx expand_sync_lock_test_and_set (rtx, rtx, rtx);
 150
 151 rtx expand_atomic_exchange (rtx, rtx, rtx, enum memmodel);
 152 rtx expand_atomic_load (rtx, rtx, enum memmodel);
 153 rtx expand_atomic_store (rtx, rtx, enum memmodel, bool);
 154 rtx expand_atomic_fetch_op (rtx, rtx, rtx, enum rtx_code, enum memmodel,
 155                               bool);
 156 rtx expand_atomic_test_and_set (rtx, rtx, enum memmodel);
 157 rtx expand_atomic_clear (rtx, enum memmodel);
 158 void expand_atomic_thread_fence (enum memmodel);
 159 void expand_atomic_signal_fence (enum memmodel);
 160
 161 \f
 162 /* Functions from expmed.c:  */
 163
 164 /* Arguments MODE, RTX: return an rtx for the negation of that value.
 165    May emit insns.  */
 166 extern rtx negate_rtx (enum machine_mode, rtx);
 167
 168 /* Expand a logical AND operation.  */
 169 extern rtx expand_and (enum machine_mode, rtx, rtx, rtx);
 170
 171 /* Emit a store-flag operation.  */
 172 extern rtx emit_store_flag (rtx, enum rtx_code, rtx, rtx, enum machine_mode,
 173                             int, int);
 174
 175 /* Like emit_store_flag, but always succeeds.  */
 176 extern rtx emit_store_flag_force (rtx, enum rtx_code, rtx, rtx,
 177                                   enum machine_mode, int, int);
 178
 179 /* Choose a minimal N + 1 bit approximation to 1/D that can be used to
 180    replace division by D, and put the least significant N bits of the result
 181    in *MULTIPLIER_PTR and return the most significant bit.  */
 182 extern unsigned HOST_WIDE_INT choose_multiplier (unsigned HOST_WIDE_INT, int,
 183                                                  int, unsigned HOST_WIDE_INT *,
 184                                                  int *, int *);
 185 \f
 186 /* Functions from expr.c:  */
 187
 188 /* This is run during target initialization to set up which modes can be
 189    used directly in memory and to initialize the block move optab.  */
 190 extern void init_expr_target (void);
 191
 192 /* This is run at the start of compiling a function.  */
 193 extern void init_expr (void);
 194
 195 /* Emit some rtl insns to move data between rtx's, converting machine modes.
 196    Both modes must be floating or both fixed.  */
 197 extern void convert_move (rtx, rtx, int);
 198
 199 /* Convert an rtx to specified machine mode and return the result.  */
 200 extern rtx convert_to_mode (enum machine_mode, rtx, int);
 201
 202 /* Convert an rtx to MODE from OLDMODE and return the result.  */
 203 extern rtx convert_modes (enum machine_mode, enum machine_mode, rtx, int);
 204
 205 /* Emit code to move a block Y to a block X.  */
 206
 207 enum block_op_methods
 208 {
 209   BLOCK_OP_NORMAL,
 210   BLOCK_OP_NO_LIBCALL,
 211   BLOCK_OP_CALL_PARM,
 212   /* Like BLOCK_OP_NORMAL, but the libcall can be tail call optimized.  */
 213   BLOCK_OP_TAILCALL
 214 };
 215
 216 extern GTY(()) tree block_clear_fn;
 217 extern void init_block_move_fn (const char *);
 218 extern void init_block_clear_fn (const char *);
 219
 220 extern rtx emit_block_move (rtx, rtx, rtx, enum block_op_methods);
 221 extern rtx emit_block_move_via_libcall (rtx, rtx, rtx, bool);
 222 extern rtx emit_block_move_hints (rtx, rtx, rtx, enum block_op_methods,
 223                                   unsigned int, HOST_WIDE_INT,
 224                                   unsigned HOST_WIDE_INT,
 225                                   unsigned HOST_WIDE_INT,
 226                                   unsigned HOST_WIDE_INT);
 227 extern bool emit_storent_insn (rtx to, rtx from);
 228
 229 /* Copy all or part of a value X into registers starting at REGNO.
 230    The number of registers to be filled is NREGS.  */
 231 extern void move_block_to_reg (int, rtx, int, enum machine_mode);
 232
 233 /* Copy all or part of a BLKmode value X out of registers starting at REGNO.
 234    The number of registers to be filled is NREGS.  */
 235 extern void move_block_from_reg (int, rtx, int);
 236
 237 /* Generate a non-consecutive group of registers represented by a PARALLEL.  */
 238 extern rtx gen_group_rtx (rtx);
 239
 240 /* Load a BLKmode value into non-consecutive registers represented by a
 241    PARALLEL.  */
 242 extern void emit_group_load (rtx, rtx, tree, int);
 243
 244 /* Similarly, but load into new temporaries.  */
 245 extern rtx emit_group_load_into_temps (rtx, rtx, tree, int);
 246
 247 /* Move a non-consecutive group of registers represented by a PARALLEL into
 248    a non-consecutive group of registers represented by a PARALLEL.  */
 249 extern void emit_group_move (rtx, rtx);
 250
 251 /* Move a group of registers represented by a PARALLEL into pseudos.  */
 252 extern rtx emit_group_move_into_temps (rtx);
 253
 254 /* Store a BLKmode value from non-consecutive registers represented by a
 255    PARALLEL.  */
 256 extern void emit_group_store (rtx, rtx, tree, int);
 257
 258 extern rtx maybe_emit_group_store (rtx, tree);
 259
 260 /* Copy BLKmode object from a set of registers.  */
 261 extern void copy_blkmode_from_reg (rtx, rtx, tree);
 262
 263 /* Mark REG as holding a parameter for the next CALL_INSN.
 264    Mode is TYPE_MODE of the non-promoted parameter, or VOIDmode.  */
 265 extern void use_reg_mode (rtx *, rtx, enum machine_mode);
 266 extern void clobber_reg_mode (rtx *, rtx, enum machine_mode);
 267
 268 extern rtx copy_blkmode_to_reg (enum machine_mode, tree);
 269
 270 /* Mark REG as holding a parameter for the next CALL_INSN.  */
 271 static inline void
 272 use_reg (rtx *fusage, rtx reg)
 273 {
 274   use_reg_mode (fusage, reg, VOIDmode);
 275 }
 276
 277 /* Mark REG as clobbered by the call with FUSAGE as CALL_INSN_FUNCTION_USAGE.  */
 278 static inline void
 279 clobber_reg (rtx *fusage, rtx reg)
 280 {
 281   clobber_reg_mode (fusage, reg, VOIDmode);
 282 }
 283
 284 /* Mark NREGS consecutive regs, starting at REGNO, as holding parameters
 285    for the next CALL_INSN.  */
 286 extern void use_regs (rtx *, int, int);
 287
 288 /* Mark a PARALLEL as holding a parameter for the next CALL_INSN.  */
 289 extern void use_group_regs (rtx *, rtx);
 290
 291 /* Write zeros through the storage of OBJECT.
 292    If OBJECT has BLKmode, SIZE is its length in bytes.  */
 293 extern rtx clear_storage (rtx, rtx, enum block_op_methods);
 294 extern rtx clear_storage_hints (rtx, rtx, enum block_op_methods,
 295                                 unsigned int, HOST_WIDE_INT,
 296                                 unsigned HOST_WIDE_INT,
 297                                 unsigned HOST_WIDE_INT,
 298                                 unsigned HOST_WIDE_INT);
 299 /* The same, but always output an library call.  */
 300 rtx set_storage_via_libcall (rtx, rtx, rtx, bool);
 301
 302 /* Expand a setmem pattern; return true if successful.  */
 303 extern bool set_storage_via_setmem (rtx, rtx, rtx, unsigned int,
 304                                     unsigned int, HOST_WIDE_INT,
 305                                     unsigned HOST_WIDE_INT,
 306                                     unsigned HOST_WIDE_INT,
 307                                     unsigned HOST_WIDE_INT);
 308
 309 extern unsigned HOST_WIDE_INT move_by_pieces_ninsns (unsigned HOST_WIDE_INT,
 310                                                      unsigned int,
 311                                                      unsigned int);
 312
 313 /* Return nonzero if it is desirable to store LEN bytes generated by
 314    CONSTFUN with several move instructions by store_by_pieces
 315    function.  CONSTFUNDATA is a pointer which will be passed as argument
 316    in every CONSTFUN call.
 317    ALIGN is maximum alignment we can assume.
 318    MEMSETP is true if this is a real memset/bzero, not a copy
 319    of a const string.  */
 320 extern int can_store_by_pieces (unsigned HOST_WIDE_INT,
 321                                 rtx (*) (void *, HOST_WIDE_INT,
 322                                          enum machine_mode),
 323                                 void *, unsigned int, bool);
 324
 325 /* Generate several move instructions to store LEN bytes generated by
 326    CONSTFUN to block TO.  (A MEM rtx with BLKmode).  CONSTFUNDATA is a
 327    pointer which will be passed as argument in every CONSTFUN call.
 328    ALIGN is maximum alignment we can assume.
 329    MEMSETP is true if this is a real memset/bzero, not a copy.
 330    Returns TO + LEN.  */
 331 extern rtx store_by_pieces (rtx, unsigned HOST_WIDE_INT,
 332                             rtx (*) (void *, HOST_WIDE_INT, enum machine_mode),
 333                             void *, unsigned int, bool, int);
 334
 335 /* Emit insns to set X from Y.  */
 336 extern rtx_insn *emit_move_insn (rtx, rtx);
 337
 338 /* Emit insns to set X from Y, with no frills.  */
 339 extern rtx_insn *emit_move_insn_1 (rtx, rtx);
 340
 341 extern rtx_insn *emit_move_complex_push (enum machine_mode, rtx, rtx);
 342 extern rtx_insn *emit_move_complex_parts (rtx, rtx);
 343 extern rtx emit_move_resolve_push (enum machine_mode, rtx);
 344
 345 /* Push a block of length SIZE (perhaps variable)
 346    and return an rtx to address the beginning of the block.  */
 347 extern rtx push_block (rtx, int, int);
 348
 349 /* Generate code to push something onto the stack, given its mode and type.  */
 350 extern void emit_push_insn (rtx, enum machine_mode, tree, rtx, unsigned int,
 351                             int, rtx, int, rtx, rtx, int, rtx);
 352
 353 /* Expand an assignment that stores the value of FROM into TO.  */
 354 extern void expand_assignment (tree, tree, bool);
 355
 356 /* Generate code for computing expression EXP,
 357    and storing the value into TARGET.
 358    If SUGGEST_REG is nonzero, copy the value through a register
 359    and return that register, if that is possible.  */
 360 extern rtx store_expr (tree, rtx, int, bool);
 361
 362 /* Given an rtx that may include add and multiply operations,
 363    generate them as insns and return a pseudo-reg containing the value.
 364    Useful after calling expand_expr with 1 as sum_ok.  */
 365 extern rtx force_operand (rtx, rtx);
 366
 367 /* Work horses for expand_expr.  */
 368 extern rtx expand_expr_real (tree, rtx, enum machine_mode,
 369                              enum expand_modifier, rtx *, bool);
 370 extern rtx expand_expr_real_1 (tree, rtx, enum machine_mode,
 371                                enum expand_modifier, rtx *, bool);
 372 extern rtx expand_expr_real_2 (sepops, rtx, enum machine_mode,
 373                                enum expand_modifier);
 374
 375 /* Generate code for computing expression EXP.
 376    An rtx for the computed value is returned.  The value is never null.
 377    In the case of a void EXP, const0_rtx is returned.  */
 378 static inline rtx
 379 expand_expr (tree exp, rtx target, enum machine_mode mode,
 380              enum expand_modifier modifier)
 381 {
 382   return expand_expr_real (exp, target, mode, modifier, NULL, false);
 383 }
 384
 385 static inline rtx
 386 expand_normal (tree exp)
 387 {
 388   return expand_expr_real (exp, NULL_RTX, VOIDmode, EXPAND_NORMAL, NULL, false);
 389 }
 390
 391 /* At the start of a function, record that we have no previously-pushed
 392    arguments waiting to be popped.  */
 393 extern void init_pending_stack_adjust (void);
 394
 395 /* Discard any pending stack adjustment.  */
 396 extern void discard_pending_stack_adjust (void);
 397
 398 /* When exiting from function, if safe, clear out any pending stack adjust
 399    so the adjustment won't get done.  */
 400 extern void clear_pending_stack_adjust (void);
 401
 402 /* Pop any previously-pushed arguments that have not been popped yet.  */
 403 extern void do_pending_stack_adjust (void);
 404
 405 /* Struct for saving/restoring of pending_stack_adjust/stack_pointer_delta
 406    values.  */
 407
 408 struct saved_pending_stack_adjust
 409 {
 410   /* Saved value of pending_stack_adjust.  */
 411   int x_pending_stack_adjust;
 412
 413   /* Saved value of stack_pointer_delta.  */
 414   int x_stack_pointer_delta;
 415 };
 416
 417 /* Remember pending_stack_adjust/stack_pointer_delta.
 418    To be used around code that may call do_pending_stack_adjust (),
 419    but the generated code could be discarded e.g. using delete_insns_since.  */
 420
 421 extern void save_pending_stack_adjust (saved_pending_stack_adjust *);
 422
 423 /* Restore the saved pending_stack_adjust/stack_pointer_delta.  */
 424
 425 extern void restore_pending_stack_adjust (saved_pending_stack_adjust *);
 426
 427 /* Return the tree node and offset if a given argument corresponds to
 428    a string constant.  */
 429 extern tree string_constant (tree, tree *);
 430
 431 /* Generate code to evaluate EXP and jump to LABEL if the value is zero.  */
 432 extern void jumpifnot (tree, rtx, int);
 433 extern void jumpifnot_1 (enum tree_code, tree, tree, rtx, int);
 434
 435 /* Generate code to evaluate EXP and jump to LABEL if the value is nonzero.  */
 436 extern void jumpif (tree, rtx, int);
 437 extern void jumpif_1 (enum tree_code, tree, tree, rtx, int);
 438
 439 /* Generate code to evaluate EXP and jump to IF_FALSE_LABEL if
 440    the result is zero, or IF_TRUE_LABEL if the result is one.  */
 441 extern void do_jump (tree, rtx, rtx, int);
 442 extern void do_jump_1 (enum tree_code, tree, tree, rtx, rtx, int);
 443
 444 extern void do_compare_rtx_and_jump (rtx, rtx, enum rtx_code, int,
 445                                      enum machine_mode, rtx, rtx, rtx, int);
 446
 447 /* Two different ways of generating switch statements.  */
 448 extern int try_casesi (tree, tree, tree, tree, rtx, rtx, rtx, int);
 449 extern int try_tablejump (tree, tree, tree, tree, rtx, rtx, int);
 450
 451 /* Functions from alias.c */
 452 #include "alias.h"
 453
 454 \f
 455 /* rtl.h and tree.h were included.  */
 456 /* Return an rtx for the size in bytes of the value of an expr.  */
 457 extern rtx expr_size (tree);
 458
 459 /* Return a wide integer for the size in bytes of the value of EXP, or -1
 460    if the size can vary or is larger than an integer.  */
 461 extern HOST_WIDE_INT int_expr_size (tree);
 462
 463 /* Return an rtx that refers to the value returned by a function
 464    in its original home.  This becomes invalid if any more code is emitted.  */
 465 extern rtx hard_function_value (const_tree, const_tree, const_tree, int);
 466
 467 extern rtx prepare_call_address (tree, rtx, rtx, rtx *, int, int);
 468
 469 extern bool shift_return_value (enum machine_mode, bool, rtx);
 470
 471 extern rtx expand_call (tree, rtx, int);
 472
 473 extern void fixup_tail_calls (void);
 474
 475 #ifdef TREE_CODE
 476 extern rtx expand_variable_shift (enum tree_code, enum machine_mode,
 477                                   rtx, tree, rtx, int);
 478 extern rtx expand_shift (enum tree_code, enum machine_mode, rtx, int, rtx,
 479                              int);
 480 extern rtx expand_divmod (int, enum tree_code, enum machine_mode, rtx, rtx,
 481                           rtx, int);
 482 #endif
 483
 484 /* Return the CODE_LABEL rtx for a LABEL_DECL, creating it if necessary.  */
 485 extern rtx label_rtx (tree);
 486
 487 /* As label_rtx, but additionally the label is placed on the forced label
 488    list of its containing function (i.e. it is treated as reachable even
 489    if how is not obvious).  */
 490 extern rtx force_label_rtx (tree);
 491
 492 /* Return an rtx like arg but sans any constant terms.
 493    Returns the original rtx if it has no constant terms.
 494    The constant terms are added and stored via a second arg.  */
 495 extern rtx eliminate_constant_term (rtx, rtx *);
 496
 497 /* Convert arg to a valid memory address for specified machine mode that points
 498    to a specific named address space, by emitting insns to perform arithmetic
 499    if necessary.  */
 500 extern rtx memory_address_addr_space (enum machine_mode, rtx, addr_space_t);
 501
 502 /* Like memory_address_addr_space, except assume the memory address points to
 503    the generic named address space.  */
 504 #define memory_address(MODE,RTX) \
 505         memory_address_addr_space ((MODE), (RTX), ADDR_SPACE_GENERIC)
 506
 507 /* Return a memory reference like MEMREF, but with its mode changed
 508    to MODE and its address changed to ADDR.
 509    (VOIDmode means don't change the mode.
 510    NULL for ADDR means don't change the address.)  */
 511 extern rtx change_address (rtx, enum machine_mode, rtx);
 512
 513 /* Return a memory reference like MEMREF, but with its mode changed
 514    to MODE and its address offset by OFFSET bytes.  */
 515 #define adjust_address(MEMREF, MODE, OFFSET) \
 516   adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1, 0, 0)
 517
 518 /* Likewise, but the reference is not required to be valid.  */
 519 #define adjust_address_nv(MEMREF, MODE, OFFSET) \
 520   adjust_address_1 (MEMREF, MODE, OFFSET, 0, 1, 0, 0)
 521
 522 /* Return a memory reference like MEMREF, but with its mode changed
 523    to MODE and its address offset by OFFSET bytes.  Assume that it's
 524    for a bitfield and conservatively drop the underlying object if we
 525    cannot be sure to stay within its bounds.  */
 526 #define adjust_bitfield_address(MEMREF, MODE, OFFSET) \
 527   adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1, 1, 0)
 528
 529 /* As for adjust_bitfield_address, but specify that the width of
 530    BLKmode accesses is SIZE bytes.  */
 531 #define adjust_bitfield_address_size(MEMREF, MODE, OFFSET, SIZE) \
 532   adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1, 1, SIZE)
 533
 534 /* Likewise, but the reference is not required to be valid.  */
 535 #define adjust_bitfield_address_nv(MEMREF, MODE, OFFSET) \
 536   adjust_address_1 (MEMREF, MODE, OFFSET, 0, 1, 1, 0)
 537
 538 /* Return a memory reference like MEMREF, but with its mode changed
 539    to MODE and its address changed to ADDR, which is assumed to be
 540    increased by OFFSET bytes from MEMREF.  */
 541 #define adjust_automodify_address(MEMREF, MODE, ADDR, OFFSET) \
 542   adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 1)
 543
 544 /* Likewise, but the reference is not required to be valid.  */
 545 #define adjust_automodify_address_nv(MEMREF, MODE, ADDR, OFFSET) \
 546   adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 0)
 547
 548 extern rtx adjust_address_1 (rtx, enum machine_mode, HOST_WIDE_INT, int, int,
 549                              int, HOST_WIDE_INT);
 550 extern rtx adjust_automodify_address_1 (rtx, enum machine_mode, rtx,
 551                                         HOST_WIDE_INT, int);
 552
 553 /* Return a memory reference like MEMREF, but whose address is changed by
 554    adding OFFSET, an RTX, to it.  POW2 is the highest power of two factor
 555    known to be in OFFSET (possibly 1).  */
 556 extern rtx offset_address (rtx, rtx, unsigned HOST_WIDE_INT);
 557
 558 /* Definitions from emit-rtl.c */
 559 #include "emit-rtl.h"
 560
 561 /* Return a memory reference like MEMREF, but with its mode widened to
 562    MODE and adjusted by OFFSET.  */
 563 extern rtx widen_memory_access (rtx, enum machine_mode, HOST_WIDE_INT);
 564
 565 /* Return a memory reference like MEMREF, but which is known to have a
 566    valid address.  */
 567 extern rtx validize_mem (rtx);
 568
 569 extern rtx use_anchored_address (rtx);
 570
 571 /* Given REF, a MEM, and T, either the type of X or the expression
 572    corresponding to REF, set the memory attributes.  OBJECTP is nonzero
 573    if we are making a new object of this type.  */
 574 extern void set_mem_attributes (rtx, tree, int);
 575
 576 /* Similar, except that BITPOS has not yet been applied to REF, so if
 577    we alter MEM_OFFSET according to T then we should subtract BITPOS
 578    expecting that it'll be added back in later.  */
 579 extern void set_mem_attributes_minus_bitpos (rtx, tree, int, HOST_WIDE_INT);
 580
 581 /* Return OFFSET if XEXP (MEM, 0) - OFFSET is known to be ALIGN
 582    bits aligned for 0 <= OFFSET < ALIGN / BITS_PER_UNIT, or
 583    -1 if not known.  */
 584 extern int get_mem_align_offset (rtx, unsigned int);
 585
 586 /* Assemble the static constant template for function entry trampolines.  */
 587 extern rtx assemble_trampoline_template (void);
 588
 589 /* Copy given rtx to a new temp reg and return that.  */
 590 extern rtx copy_to_reg (rtx);
 591
 592 /* Like copy_to_reg but always make the reg Pmode.  */
 593 extern rtx copy_addr_to_reg (rtx);
 594
 595 /* Like copy_to_reg but always make the reg the specified mode MODE.  */
 596 extern rtx copy_to_mode_reg (enum machine_mode, rtx);
 597
 598 /* Copy given rtx to given temp reg and return that.  */
 599 extern rtx copy_to_suggested_reg (rtx, rtx, enum machine_mode);
 600
 601 /* Copy a value to a register if it isn't already a register.
 602    Args are mode (in case value is a constant) and the value.  */
 603 extern rtx force_reg (enum machine_mode, rtx);
 604
 605 /* Return given rtx, copied into a new temp reg if it was in memory.  */
 606 extern rtx force_not_mem (rtx);
 607
 608 /* Return mode and signedness to use when an argument or result in the
 609    given mode is promoted.  */
 610 extern enum machine_mode promote_function_mode (const_tree, enum machine_mode, int *,
 611                                                 const_tree, int);
 612
 613 /* Return mode and signedness to use when an object in the given mode
 614    is promoted.  */
 615 extern enum machine_mode promote_mode (const_tree, enum machine_mode, int *);
 616
 617 /* Return mode and signedness to use when object is promoted.  */
 618 enum machine_mode promote_decl_mode (const_tree, int *);
 619
 620 /* Remove some bytes from the stack.  An rtx says how many.  */
 621 extern void adjust_stack (rtx);
 622
 623 /* Add some bytes to the stack.  An rtx says how many.  */
 624 extern void anti_adjust_stack (rtx);
 625
 626 /* Add some bytes to the stack while probing it.  An rtx says how many. */
 627 extern void anti_adjust_stack_and_probe (rtx, bool);
 628
 629 /* This enum is used for the following two functions.  */
 630 enum save_level {SAVE_BLOCK, SAVE_FUNCTION, SAVE_NONLOCAL};
 631
 632 /* Save the stack pointer at the specified level.  */
 633 extern void emit_stack_save (enum save_level, rtx *);
 634
 635 /* Restore the stack pointer from a save area of the specified level.  */
 636 extern void emit_stack_restore (enum save_level, rtx);
 637
 638 /* Invoke emit_stack_save for the nonlocal_goto_save_area.  */
 639 extern void update_nonlocal_goto_save_area (void);
 640
 641 /* Allocate some space on the stack dynamically and return its address.  */
 642 extern rtx allocate_dynamic_stack_space (rtx, unsigned, unsigned, bool);
 643
 644 /* Emit one stack probe at ADDRESS, an address within the stack.  */
 645 extern void emit_stack_probe (rtx);
 646
 647 /* Probe a range of stack addresses from FIRST to FIRST+SIZE, inclusive.
 648    FIRST is a constant and size is a Pmode RTX.  These are offsets from
 649    the current stack pointer.  STACK_GROWS_DOWNWARD says whether to add
 650    or subtract them from the stack pointer.  */
 651 extern void probe_stack_range (HOST_WIDE_INT, rtx);
 652
 653 /* Return an rtx that refers to the value returned by a library call
 654    in its original home.  This becomes invalid if any more code is emitted.  */
 655 extern rtx hard_libcall_value (enum machine_mode, rtx);
 656
 657 extern void store_bit_field (rtx, unsigned HOST_WIDE_INT,
 658                              unsigned HOST_WIDE_INT,
 659                              unsigned HOST_WIDE_INT,
 660                              unsigned HOST_WIDE_INT,
 661                              enum machine_mode, rtx);
 662 extern rtx extract_bit_field (rtx, unsigned HOST_WIDE_INT,
 663                               unsigned HOST_WIDE_INT, int, rtx,
 664                               enum machine_mode, enum machine_mode);
 665 extern rtx extract_low_bits (enum machine_mode, enum machine_mode, rtx);
 666 extern rtx expand_mult (enum machine_mode, rtx, rtx, rtx, int);
 667 extern rtx expand_mult_highpart_adjust (enum machine_mode, rtx, rtx, rtx, rtx, int);
 668
 669 extern rtx assemble_static_space (unsigned HOST_WIDE_INT);
 670 extern int safe_from_p (const_rtx, tree, int);
 671 extern bool split_comparison (enum rtx_code, enum machine_mode,
 672                               enum rtx_code *, enum rtx_code *);
 673
 674 /* Call this once to initialize the contents of the optabs
 675    appropriately for the current target machine.  */
 676 extern void init_optabs (void);
 677 extern void init_all_optabs (struct target_optabs *);
 678
 679 /* Call this to initialize an optab function entry.  */
 680 extern rtx init_one_libfunc (const char *);
 681 extern rtx set_user_assembler_libfunc (const char *, const char *);
 682
 683 /* Build a decl for a libfunc named NAME. */
 684 extern tree build_libfunc_function (const char *);
 685
 686 /* Get the personality libfunc for a function decl.  */
 687 rtx get_personality_function (tree);
 688
 689
 690 /* In stmt.c */
 691
 692 /* Expand a GIMPLE_SWITCH statement.  */
 693 extern void expand_case (gimple);
 694
 695 /* Like expand_case but special-case for SJLJ exception dispatching.  */
 696 extern void expand_sjlj_dispatch_table (rtx, vec<tree> );
 697
 698 /* Determine whether the LEN bytes can be moved by using several move
 699    instructions.  Return nonzero if a call to move_by_pieces should
 700    succeed.  */
 701 extern int can_move_by_pieces (unsigned HOST_WIDE_INT, unsigned int);
 702
 703 extern unsigned HOST_WIDE_INT highest_pow2_factor (const_tree);
 704 bool array_at_struct_end_p (tree);
 705
 706 /* Return a tree of sizetype representing the size, in bytes, of the element
 707    of EXP, an ARRAY_REF or an ARRAY_RANGE_REF.  */
 708 extern tree array_ref_element_size (tree);
 709
 710 extern bool categorize_ctor_elements (const_tree, HOST_WIDE_INT *,
 711                                       HOST_WIDE_INT *, bool *);
 712
 713 /* Return a tree representing the offset, in bytes, of the field referenced
 714    by EXP.  This does not include any offset in DECL_FIELD_BIT_OFFSET.  */
 715 extern tree component_ref_field_offset (tree);
 716
 717 #endif /* GCC_EXPR_H */