gcc/expr.h

   1 /* Definitions for code generation pass of GNU compiler.
   2    Copyright (C) 1987, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
   3    1999, 2000 Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 2, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GCC; see the file COPYING.  If not, write to the Free
  19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  20 02111-1307, USA.  */
  21
  22 /* The default branch cost is 1.  */
  23 #ifndef BRANCH_COST
  24 #define BRANCH_COST 1
  25 #endif
  26
  27 /* Macros to access the slots of a QUEUED rtx.
  28    Here rather than in rtl.h because only the expansion pass
  29    should ever encounter a QUEUED.  */
  30
  31 /* The variable for which an increment is queued.  */
  32 #define QUEUED_VAR(P) XEXP (P, 0)
  33 /* If the increment has been emitted, this is the insn
  34    that does the increment.  It is zero before the increment is emitted.
  35    If more than one insn is emitted, this is the first insn.  */
  36 #define QUEUED_INSN(P) XEXP (P, 1)
  37 /* If a pre-increment copy has been generated, this is the copy
  38    (it is a temporary reg).  Zero if no copy made yet.  */
  39 #define QUEUED_COPY(P) XEXP (P, 2)
  40 /* This is the body to use for the insn to do the increment.
  41    It is used to emit the increment.  */
  42 #define QUEUED_BODY(P) XEXP (P, 3)
  43 /* Next QUEUED in the queue.  */
  44 #define QUEUED_NEXT(P) XEXP (P, 4)
  45
  46 /* This is the 4th arg to `expand_expr'.
  47    EXPAND_SUM means it is ok to return a PLUS rtx or MULT rtx.
  48    EXPAND_INITIALIZER is similar but also record any labels on forced_labels.
  49    EXPAND_CONST_ADDRESS means it is ok to return a MEM whose address
  50     is a constant that is not a legitimate address.
  51    EXPAND_WRITE means we are only going to write to the resulting rtx.  */
  52 enum expand_modifier {EXPAND_NORMAL, EXPAND_SUM, EXPAND_CONST_ADDRESS,
  53                         EXPAND_INITIALIZER, EXPAND_WRITE};
  54
  55 /* Prevent the compiler from deferring stack pops.  See
  56    inhibit_defer_pop for more information.  */
  57 #define NO_DEFER_POP (inhibit_defer_pop += 1)
  58
  59 /* Allow the compiler to defer stack pops.  See inhibit_defer_pop for
  60    more information.  */
  61 #define OK_DEFER_POP (inhibit_defer_pop -= 1)
  62 \f
  63 #ifdef TREE_CODE /* Don't lose if tree.h not included.  */
  64 /* Structure to record the size of a sequence of arguments
  65    as the sum of a tree-expression and a constant.  This structure is
  66    also used to store offsets from the stack, which might be negative,
  67    so the variable part must be ssizetype, not sizetype.  */
  68
  69 struct args_size
  70 {
  71   HOST_WIDE_INT constant;
  72   tree var;
  73 };
  74 #endif
  75
  76 /* Add the value of the tree INC to the `struct args_size' TO.  */
  77
  78 #define ADD_PARM_SIZE(TO, INC)                          \
  79 do {                                                    \
  80   tree inc = (INC);                                     \
  81   if (host_integerp (inc, 0))                           \
  82     (TO).constant += tree_low_cst (inc, 0);             \
  83   else if ((TO).var == 0)                               \
  84     (TO).var = convert (ssizetype, inc);                \
  85   else                                                  \
  86     (TO).var = size_binop (PLUS_EXPR, (TO).var,         \
  87                            convert (ssizetype, inc));   \
  88 } while (0)
  89
  90 #define SUB_PARM_SIZE(TO, DEC)                          \
  91 do {                                                    \
  92   tree dec = (DEC);                                     \
  93   if (host_integerp (dec, 0))                           \
  94     (TO).constant -= tree_low_cst (dec, 0);             \
  95   else if ((TO).var == 0)                               \
  96     (TO).var = size_binop (MINUS_EXPR, ssize_int (0),   \
  97                            convert (ssizetype, dec));   \
  98   else                                                  \
  99     (TO).var = size_binop (MINUS_EXPR, (TO).var,        \
 100                            convert (ssizetype, dec));   \
 101 } while (0)
 102
 103 /* Convert the implicit sum in a `struct args_size' into a tree
 104    of type ssizetype.  */
 105 #define ARGS_SIZE_TREE(SIZE)                                    \
 106 ((SIZE).var == 0 ? ssize_int ((SIZE).constant)                  \
 107  : size_binop (PLUS_EXPR, convert (ssizetype, (SIZE).var),      \
 108                ssize_int ((SIZE).constant)))
 109
 110 /* Convert the implicit sum in a `struct args_size' into an rtx.  */
 111 #define ARGS_SIZE_RTX(SIZE)                                     \
 112 ((SIZE).var == 0 ? GEN_INT ((SIZE).constant)                    \
 113  : expand_expr (ARGS_SIZE_TREE (SIZE), NULL_RTX, VOIDmode, 0))
 114
 115 /* Supply a default definition for FUNCTION_ARG_PADDING:
 116    usually pad upward, but pad short args downward on
 117    big-endian machines.  */
 118
 119 enum direction {none, upward, downward};  /* Value has this type.  */
 120
 121 #ifndef FUNCTION_ARG_PADDING
 122 #define FUNCTION_ARG_PADDING(MODE, TYPE)                                \
 123   (! BYTES_BIG_ENDIAN                                                   \
 124    ? upward                                                             \
 125    : (((MODE) == BLKmode                                                \
 126        ? ((TYPE) && TREE_CODE (TYPE_SIZE (TYPE)) == INTEGER_CST         \
 127           && int_size_in_bytes (TYPE) < (PARM_BOUNDARY / BITS_PER_UNIT)) \
 128        : GET_MODE_BITSIZE (MODE) < PARM_BOUNDARY)                       \
 129       ? downward : upward))
 130 #endif
 131
 132 /* Supply a default definition for FUNCTION_ARG_BOUNDARY.  Normally, we let
 133    FUNCTION_ARG_PADDING, which also pads the length, handle any needed
 134    alignment.  */
 135
 136 #ifndef FUNCTION_ARG_BOUNDARY
 137 #define FUNCTION_ARG_BOUNDARY(MODE, TYPE)       PARM_BOUNDARY
 138 #endif
 139
 140 /* Provide a default value for STRICT_ARGUMENT_NAMING.  */
 141 #ifndef STRICT_ARGUMENT_NAMING
 142 #define STRICT_ARGUMENT_NAMING 0
 143 #endif
 144
 145 /* Provide a default value for PRETEND_OUTGOING_VARARGS_NAMED.  */
 146 #ifdef SETUP_INCOMING_VARARGS
 147 #ifndef PRETEND_OUTGOING_VARARGS_NAMED
 148 #define PRETEND_OUTGOING_VARARGS_NAMED 1
 149 #endif
 150 #else
 151 /* It is an error to define PRETEND_OUTGOING_VARARGS_NAMED without
 152    defining SETUP_INCOMING_VARARGS.  */
 153 #define PRETEND_OUTGOING_VARARGS_NAMED 0
 154 #endif
 155
 156 /* Nonzero if we do not know how to pass TYPE solely in registers.
 157    We cannot do so in the following cases:
 158
 159    - if the type has variable size
 160    - if the type is marked as addressable (it is required to be constructed
 161      into the stack)
 162    - if the padding and mode of the type is such that a copy into a register
 163      would put it into the wrong part of the register.
 164
 165    Which padding can't be supported depends on the byte endianness.
 166
 167    A value in a register is implicitly padded at the most significant end.
 168    On a big-endian machine, that is the lower end in memory.
 169    So a value padded in memory at the upper end can't go in a register.
 170    For a little-endian machine, the reverse is true.  */
 171
 172 #ifndef MUST_PASS_IN_STACK
 173 #define MUST_PASS_IN_STACK(MODE,TYPE)                   \
 174   ((TYPE) != 0                                          \
 175    && (TREE_CODE (TYPE_SIZE (TYPE)) != INTEGER_CST      \
 176        || TREE_ADDRESSABLE (TYPE)                       \
 177        || ((MODE) == BLKmode                            \
 178            && ! ((TYPE) != 0 && TREE_CODE (TYPE_SIZE (TYPE)) == INTEGER_CST \
 179                  && 0 == (int_size_in_bytes (TYPE)      \
 180                           % (PARM_BOUNDARY / BITS_PER_UNIT))) \
 181            && (FUNCTION_ARG_PADDING (MODE, TYPE)        \
 182                == (BYTES_BIG_ENDIAN ? upward : downward)))))
 183 #endif
 184
 185 /* Nonzero if type TYPE should be returned in memory.
 186    Most machines can use the following default definition.  */
 187
 188 #ifndef RETURN_IN_MEMORY
 189 #define RETURN_IN_MEMORY(TYPE) (TYPE_MODE (TYPE) == BLKmode)
 190 #endif
 191
 192 /* Supply a default definition of STACK_SAVEAREA_MODE for emit_stack_save.
 193    Normally move_insn, so Pmode stack pointer.  */
 194
 195 #ifndef STACK_SAVEAREA_MODE
 196 #define STACK_SAVEAREA_MODE(LEVEL) Pmode
 197 #endif
 198
 199 /* Supply a default definition of STACK_SIZE_MODE for
 200    allocate_dynamic_stack_space.  Normally PLUS/MINUS, so word_mode.  */
 201
 202 #ifndef STACK_SIZE_MODE
 203 #define STACK_SIZE_MODE word_mode
 204 #endif
 205
 206 /* Provide default values for the macros controlling stack checking.  */
 207
 208 #ifndef STACK_CHECK_BUILTIN
 209 #define STACK_CHECK_BUILTIN 0
 210 #endif
 211
 212 /* The default interval is one page.  */
 213 #ifndef STACK_CHECK_PROBE_INTERVAL
 214 #define STACK_CHECK_PROBE_INTERVAL 4096
 215 #endif
 216
 217 /* The default is to do a store into the stack.  */
 218 #ifndef STACK_CHECK_PROBE_LOAD
 219 #define STACK_CHECK_PROBE_LOAD 0
 220 #endif
 221
 222 /* This value is arbitrary, but should be sufficient for most machines.  */
 223 #ifndef STACK_CHECK_PROTECT
 224 #define STACK_CHECK_PROTECT (75 * UNITS_PER_WORD)
 225 #endif
 226
 227 /* Make the maximum frame size be the largest we can and still only need
 228    one probe per function.  */
 229 #ifndef STACK_CHECK_MAX_FRAME_SIZE
 230 #define STACK_CHECK_MAX_FRAME_SIZE \
 231   (STACK_CHECK_PROBE_INTERVAL - UNITS_PER_WORD)
 232 #endif
 233
 234 /* This is arbitrary, but should be large enough everywhere.  */
 235 #ifndef STACK_CHECK_FIXED_FRAME_SIZE
 236 #define STACK_CHECK_FIXED_FRAME_SIZE (4 * UNITS_PER_WORD)
 237 #endif
 238
 239 /* Provide a reasonable default for the maximum size of an object to
 240    allocate in the fixed frame.  We may need to be able to make this
 241    controllable by the user at some point.  */
 242 #ifndef STACK_CHECK_MAX_VAR_SIZE
 243 #define STACK_CHECK_MAX_VAR_SIZE (STACK_CHECK_MAX_FRAME_SIZE / 100)
 244 #endif
 245 \f
 246 /* Functions from optabs.c, commonly used, and without need for the optabs
 247    tables:  */
 248
 249 /* Passed to expand_simple_binop and expand_binop to say which options
 250    to try to use if the requested operation can't be open-coded on the
 251    requisite mode.  Either OPTAB_LIB or OPTAB_LIB_WIDEN says try using
 252    a library call.  Either OPTAB_WIDEN or OPTAB_LIB_WIDEN says try
 253    using a wider mode.  OPTAB_MUST_WIDEN says try widening and don't
 254    try anything else.  */
 255
 256 enum optab_methods
 257 {
 258   OPTAB_DIRECT,
 259   OPTAB_LIB,
 260   OPTAB_WIDEN,
 261   OPTAB_LIB_WIDEN,
 262   OPTAB_MUST_WIDEN
 263 };
 264
 265 /* Generate code for a simple binary or unary operation.  "Simple" in
 266    this case means "can be unambiguously described by a (mode, code)
 267    pair and mapped to a single optab."  */
 268 extern rtx expand_simple_binop PARAMS ((enum machine_mode, enum rtx_code, rtx,
 269                                         rtx, rtx, int, enum optab_methods));
 270 extern rtx expand_simple_unop PARAMS ((enum machine_mode, enum rtx_code,
 271                                        rtx, rtx, int));
 272
 273 /* Report whether the machine description contains an insn which can
 274    perform the operation described by CODE and MODE.  */
 275 extern int have_insn_for PARAMS ((enum rtx_code, enum machine_mode));
 276
 277 /* Emit code to make a call to a constant function or a library call.  */
 278 extern void emit_libcall_block PARAMS ((rtx, rtx, rtx, rtx));
 279
 280 /* Create but don't emit one rtl instruction to perform certain operations.
 281    Modes must match; operands must meet the operation's predicates.
 282    Likewise for subtraction and for just copying.
 283    These do not call protect_from_queue; caller must do so.  */
 284 extern rtx gen_add2_insn PARAMS ((rtx, rtx));
 285 extern rtx gen_add3_insn PARAMS ((rtx, rtx, rtx));
 286 extern rtx gen_sub2_insn PARAMS ((rtx, rtx));
 287 extern rtx gen_sub3_insn PARAMS ((rtx, rtx, rtx));
 288 extern rtx gen_move_insn PARAMS ((rtx, rtx));
 289 extern int have_add2_insn PARAMS ((rtx, rtx));
 290 extern int have_sub2_insn PARAMS ((rtx, rtx));
 291
 292 /* Emit a pair of rtl insns to compare two rtx's and to jump
 293    to a label if the comparison is true.  */
 294 extern void emit_cmp_and_jump_insns PARAMS ((rtx, rtx, enum rtx_code, rtx,
 295                                              enum machine_mode, int, rtx));
 296
 297 /* Generate code to indirectly jump to a location given in the rtx LOC.  */
 298 extern void emit_indirect_jump PARAMS ((rtx));
 299
 300 #ifdef HAVE_conditional_move
 301 /* Emit a conditional move operation.  */
 302 rtx emit_conditional_move PARAMS ((rtx, enum rtx_code, rtx, rtx,
 303                                    enum machine_mode, rtx, rtx,
 304                                    enum machine_mode, int));
 305
 306 /* Return nonzero if the conditional move is supported.  */
 307 int can_conditionally_move_p PARAMS ((enum machine_mode mode));
 308
 309 #endif
 310 rtx emit_conditional_add PARAMS ((rtx, enum rtx_code, rtx, rtx,
 311                                   enum machine_mode, rtx, rtx,
 312                                   enum machine_mode, int));
 313
 314 \f
 315 /* Functions from expmed.c:  */
 316
 317 /* Arguments MODE, RTX: return an rtx for the negation of that value.
 318    May emit insns.  */
 319 extern rtx negate_rtx PARAMS ((enum machine_mode, rtx));
 320
 321 /* Expand a logical AND operation.  */
 322 extern rtx expand_and PARAMS ((enum machine_mode, rtx, rtx, rtx));
 323
 324 /* Emit a store-flag operation.  */
 325 extern rtx emit_store_flag PARAMS ((rtx, enum rtx_code, rtx, rtx,
 326                                     enum machine_mode, int, int));
 327
 328 /* Like emit_store_flag, but always succeeds.  */
 329 extern rtx emit_store_flag_force PARAMS ((rtx, enum rtx_code, rtx, rtx,
 330                                           enum machine_mode, int, int));
 331
 332 /* Functions from loop.c:  */
 333
 334 /* Given an insn and condition, return a canonical description of
 335    the test being made.  */
 336 extern rtx canonicalize_condition PARAMS ((rtx, rtx, int, rtx *, rtx));
 337
 338 /* Given a JUMP_INSN, return a canonical description of the test
 339    being made.  */
 340 extern rtx get_condition PARAMS ((rtx, rtx *));
 341
 342 /* Generate a conditional trap instruction.  */
 343 extern rtx gen_cond_trap PARAMS ((enum rtx_code, rtx, rtx, rtx));
 344 \f
 345 /* Functions from builtins.c:  */
 346 extern rtx expand_builtin PARAMS ((tree, rtx, rtx, enum machine_mode, int));
 347 extern void std_expand_builtin_va_start PARAMS ((tree, rtx));
 348 extern rtx std_expand_builtin_va_arg PARAMS ((tree, tree));
 349 extern rtx expand_builtin_va_arg PARAMS ((tree, tree));
 350 extern void default_init_builtins PARAMS ((void));
 351 extern rtx default_expand_builtin PARAMS ((tree, rtx, rtx,
 352                                            enum machine_mode, int));
 353 extern void expand_builtin_setjmp_setup PARAMS ((rtx, rtx));
 354 extern void expand_builtin_setjmp_receiver PARAMS ((rtx));
 355 extern void expand_builtin_longjmp PARAMS ((rtx, rtx));
 356 extern rtx expand_builtin_saveregs PARAMS ((void));
 357 extern void expand_builtin_trap PARAMS ((void));
 358 extern HOST_WIDE_INT get_varargs_alias_set PARAMS ((void));
 359 extern HOST_WIDE_INT get_frame_alias_set PARAMS ((void));
 360 extern void record_base_value           PARAMS ((unsigned int, rtx, int));
 361 extern void record_alias_subset         PARAMS ((HOST_WIDE_INT,
 362                                                  HOST_WIDE_INT));
 363 extern HOST_WIDE_INT new_alias_set              PARAMS ((void));
 364 extern int can_address_p                PARAMS ((tree));
 365 \f
 366 /* Functions from expr.c:  */
 367
 368 /* This is run once per compilation to set up which modes can be used
 369    directly in memory and to initialize the block move optab.  */
 370 extern void init_expr_once PARAMS ((void));
 371
 372 /* This is run at the start of compiling a function.  */
 373 extern void init_expr PARAMS ((void));
 374
 375 /* This is run at the end of compiling a function.  */
 376 extern void finish_expr_for_function PARAMS ((void));
 377
 378 /* Use protect_from_queue to convert a QUEUED expression
 379    into something that you can put immediately into an instruction.  */
 380 extern rtx protect_from_queue PARAMS ((rtx, int));
 381
 382 /* Perform all the pending incrementations.  */
 383 extern void emit_queue PARAMS ((void));
 384
 385 /* Tell if something has a queued subexpression.  */
 386 extern int queued_subexp_p PARAMS ((rtx));
 387
 388 /* Emit some rtl insns to move data between rtx's, converting machine modes.
 389    Both modes must be floating or both fixed.  */
 390 extern void convert_move PARAMS ((rtx, rtx, int));
 391
 392 /* Convert an rtx to specified machine mode and return the result.  */
 393 extern rtx convert_to_mode PARAMS ((enum machine_mode, rtx, int));
 394
 395 /* Convert an rtx to MODE from OLDMODE and return the result.  */
 396 extern rtx convert_modes PARAMS ((enum machine_mode, enum machine_mode,
 397                                   rtx, int));
 398
 399 /* Emit code to move a block Y to a block X.  */
 400
 401 enum block_op_methods
 402 {
 403   BLOCK_OP_NORMAL,
 404   BLOCK_OP_CALL_PARM,
 405   BLOCK_OP_NO_LIBCALL
 406 };
 407
 408 extern rtx emit_block_move PARAMS ((rtx, rtx, rtx, enum block_op_methods));
 409
 410 /* Copy all or part of a value X into registers starting at REGNO.
 411    The number of registers to be filled is NREGS.  */
 412 extern void move_block_to_reg PARAMS ((int, rtx, int, enum machine_mode));
 413
 414 /* Copy all or part of a BLKmode value X out of registers starting at REGNO.
 415    The number of registers to be filled is NREGS.  */
 416 extern void move_block_from_reg PARAMS ((int, rtx, int, int));
 417
 418 /* Generate a non-consecutive group of registers represented by a PARALLEL.  */
 419 extern rtx gen_group_rtx PARAMS ((rtx));
 420
 421 /* Load a BLKmode value into non-consecutive registers represented by a
 422    PARALLEL.  */
 423 extern void emit_group_load PARAMS ((rtx, rtx, int));
 424
 425 /* Move a non-consecutive group of registers represented by a PARALLEL into
 426    a non-consecutive group of registers represented by a PARALLEL.  */
 427 extern void emit_group_move PARAMS ((rtx, rtx));
 428
 429 /* Store a BLKmode value from non-consecutive registers represented by a
 430    PARALLEL.  */
 431 extern void emit_group_store PARAMS ((rtx, rtx, int));
 432
 433 #ifdef TREE_CODE
 434 /* Copy BLKmode object from a set of registers.  */
 435 extern rtx copy_blkmode_from_reg PARAMS ((rtx,rtx,tree));
 436 #endif
 437
 438 /* Mark REG as holding a parameter for the next CALL_INSN.  */
 439 extern void use_reg PARAMS ((rtx *, rtx));
 440
 441 /* Mark NREGS consecutive regs, starting at REGNO, as holding parameters
 442    for the next CALL_INSN.  */
 443 extern void use_regs PARAMS ((rtx *, int, int));
 444
 445 /* Mark a PARALLEL as holding a parameter for the next CALL_INSN.  */
 446 extern void use_group_regs PARAMS ((rtx *, rtx));
 447
 448 /* Write zeros through the storage of OBJECT.
 449    If OBJECT has BLKmode, SIZE is its length in bytes.  */
 450 extern rtx clear_storage PARAMS ((rtx, rtx));
 451
 452 /* Return nonzero if it is desirable to store LEN bytes generated by
 453    CONSTFUN with several move instructions by store_by_pieces
 454    function.  CONSTFUNDATA is a pointer which will be passed as argument
 455    in every CONSTFUN call.
 456    ALIGN is maximum alignment we can assume.  */
 457 extern int can_store_by_pieces PARAMS ((unsigned HOST_WIDE_INT,
 458                                         rtx (*) (PTR, HOST_WIDE_INT,
 459                                                  enum machine_mode),
 460                                         PTR, unsigned int));
 461
 462 /* Generate several move instructions to store LEN bytes generated by
 463    CONSTFUN to block TO.  (A MEM rtx with BLKmode).  CONSTFUNDATA is a
 464    pointer which will be passed as argument in every CONSTFUN call.
 465    ALIGN is maximum alignment we can assume.  */
 466 extern void store_by_pieces PARAMS ((rtx, unsigned HOST_WIDE_INT,
 467                                      rtx (*) (PTR, HOST_WIDE_INT,
 468                                               enum machine_mode),
 469                                      PTR, unsigned int));
 470
 471 /* Emit insns to set X from Y.  */
 472 extern rtx emit_move_insn PARAMS ((rtx, rtx));
 473
 474 /* Emit insns to set X from Y, with no frills.  */
 475 extern rtx emit_move_insn_1 PARAMS ((rtx, rtx));
 476
 477 /* Push a block of length SIZE (perhaps variable)
 478    and return an rtx to address the beginning of the block.  */
 479 extern rtx push_block PARAMS ((rtx, int, int));
 480
 481 #ifdef TREE_CODE
 482 /* Generate code to push something onto the stack, given its mode and type.  */
 483 extern void emit_push_insn PARAMS ((rtx, enum machine_mode, tree, rtx,
 484                                     unsigned int, int, rtx, int, rtx, rtx,
 485                                     int, rtx));
 486
 487 /* Expand an assignment that stores the value of FROM into TO.  */
 488 extern rtx expand_assignment PARAMS ((tree, tree, int, int));
 489
 490 /* Generate code for computing expression EXP,
 491    and storing the value into TARGET.
 492    If SUGGEST_REG is nonzero, copy the value through a register
 493    and return that register, if that is possible.  */
 494 extern rtx store_expr PARAMS ((tree, rtx, int));
 495 #endif
 496
 497 /* Given an rtx that may include add and multiply operations,
 498    generate them as insns and return a pseudo-reg containing the value.
 499    Useful after calling expand_expr with 1 as sum_ok.  */
 500 extern rtx force_operand PARAMS ((rtx, rtx));
 501
 502 /* Return an object on the placeholder list that matches EXP, a
 503    PLACEHOLDER_EXPR.  An object "matches" if it is of the type of the
 504    PLACEHOLDER_EXPR or a pointer type to it.  For further information, see
 505    tree.def.  If no such object is found, abort.  If PLIST is nonzero, it is
 506    a location which initially points to a starting location in the
 507    placeholder list (zero means start of the list) and where a pointer into
 508    the placeholder list at which the object is found is placed.  */
 509 extern tree find_placeholder PARAMS ((tree, tree *));
 510
 511 /* Generate code for computing expression EXP.
 512    An rtx for the computed value is returned.  The value is never null.
 513    In the case of a void EXP, const0_rtx is returned.  */
 514 extern rtx expand_expr PARAMS ((tree, rtx, enum machine_mode,
 515                                 enum expand_modifier));
 516
 517 /* At the start of a function, record that we have no previously-pushed
 518    arguments waiting to be popped.  */
 519 extern void init_pending_stack_adjust PARAMS ((void));
 520
 521 /* When exiting from function, if safe, clear out any pending stack adjust
 522    so the adjustment won't get done.  */
 523 extern void clear_pending_stack_adjust PARAMS ((void));
 524
 525 /* Pop any previously-pushed arguments that have not been popped yet.  */
 526 extern void do_pending_stack_adjust PARAMS ((void));
 527
 528 #ifdef TREE_CODE
 529 /* Return the tree node and offset if a given argument corresponds to
 530    a string constant.  */
 531 extern tree string_constant PARAMS ((tree, tree *));
 532
 533 /* Generate code to evaluate EXP and jump to LABEL if the value is zero.  */
 534 extern void jumpifnot PARAMS ((tree, rtx));
 535
 536 /* Generate code to evaluate EXP and jump to LABEL if the value is nonzero.  */
 537 extern void jumpif PARAMS ((tree, rtx));
 538
 539 /* Generate code to evaluate EXP and jump to IF_FALSE_LABEL if
 540    the result is zero, or IF_TRUE_LABEL if the result is one.  */
 541 extern void do_jump PARAMS ((tree, rtx, rtx));
 542 #endif
 543
 544 /* Generate rtl to compare two rtx's, will call emit_cmp_insn.  */
 545 extern rtx compare_from_rtx PARAMS ((rtx, rtx, enum rtx_code, int,
 546                                      enum machine_mode, rtx));
 547 extern void do_compare_rtx_and_jump PARAMS ((rtx, rtx, enum rtx_code, int,
 548                                              enum machine_mode, rtx,
 549                                              rtx, rtx));
 550
 551 /* Two different ways of generating switch statements.  */
 552 extern int try_casesi    PARAMS ((tree, tree, tree, tree, rtx, rtx));
 553 extern int try_tablejump PARAMS ((tree, tree, tree, tree, rtx, rtx));
 554
 555 /* Smallest number of adjacent cases before we use a jump table.
 556    XXX Should be a target hook.  */
 557 extern unsigned int case_values_threshold PARAMS ((void));
 558
 559 \f
 560 #ifdef TREE_CODE
 561 /* rtl.h and tree.h were included.  */
 562 /* Return an rtx for the size in bytes of the value of an expr.  */
 563 extern rtx expr_size PARAMS ((tree));
 564
 565 /* Return a wide integer for the size in bytes of the value of EXP, or -1
 566    if the size can vary or is larger than an integer.  */
 567 extern HOST_WIDE_INT int_expr_size PARAMS ((tree));
 568
 569 extern rtx lookup_static_chain PARAMS ((tree));
 570
 571 /* Convert a stack slot address ADDR valid in function FNDECL
 572    into an address valid in this function (using a static chain).  */
 573 extern rtx fix_lexical_addr PARAMS ((rtx, tree));
 574
 575 /* Return the address of the trampoline for entering nested fn FUNCTION.  */
 576 extern rtx trampoline_address PARAMS ((tree));
 577
 578 /* Return an rtx that refers to the value returned by a function
 579    in its original home.  This becomes invalid if any more code is emitted.  */
 580 extern rtx hard_function_value PARAMS ((tree, tree, int));
 581
 582 extern rtx prepare_call_address PARAMS ((rtx, tree, rtx *, int, int));
 583
 584 extern rtx expand_call PARAMS ((tree, rtx, int));
 585
 586 extern rtx expand_shift PARAMS ((enum tree_code, enum machine_mode, rtx, tree,
 587                                  rtx, int));
 588 extern rtx expand_divmod PARAMS ((int, enum tree_code, enum machine_mode, rtx,
 589                                   rtx, rtx, int));
 590 extern void locate_and_pad_parm PARAMS ((enum machine_mode, tree, int, tree,
 591                                          struct args_size *,
 592                                          struct args_size *,
 593                                          struct args_size *,
 594                                          struct args_size *));
 595 extern rtx expand_inline_function PARAMS ((tree, tree, rtx, int, tree, rtx));
 596
 597 /* Return the CODE_LABEL rtx for a LABEL_DECL, creating it if necessary.  */
 598 extern rtx label_rtx PARAMS ((tree));
 599 #endif
 600
 601 /* Indicate how an input argument register was promoted.  */
 602 extern rtx promoted_input_arg PARAMS ((unsigned int, enum machine_mode *,
 603                                        int *));
 604
 605 /* Return an rtx like arg but sans any constant terms.
 606    Returns the original rtx if it has no constant terms.
 607    The constant terms are added and stored via a second arg.  */
 608 extern rtx eliminate_constant_term PARAMS ((rtx, rtx *));
 609
 610 /* Convert arg to a valid memory address for specified machine mode,
 611    by emitting insns to perform arithmetic if nec.  */
 612 extern rtx memory_address PARAMS ((enum machine_mode, rtx));
 613
 614 /* Like `memory_address' but pretent `flag_force_addr' is 0.  */
 615 extern rtx memory_address_noforce PARAMS ((enum machine_mode, rtx));
 616
 617 /* Set the alias set of MEM to SET.  */
 618 extern void set_mem_alias_set PARAMS ((rtx, HOST_WIDE_INT));
 619
 620 /* Set the alignment of MEM to ALIGN bits.  */
 621 extern void set_mem_align PARAMS ((rtx, unsigned int));
 622
 623 /* Set the expr for MEM to EXPR.  */
 624 extern void set_mem_expr PARAMS ((rtx, tree));
 625
 626 /* Set the offset for MEM to OFFSET.  */
 627 extern void set_mem_offset PARAMS ((rtx, rtx));
 628
 629 /* Set the size for MEM to SIZE.  */
 630 extern void set_mem_size PARAMS ((rtx, rtx));
 631
 632 /* Return a memory reference like MEMREF, but with its mode changed
 633    to MODE and its address changed to ADDR.
 634    (VOIDmode means don't change the mode.
 635    NULL for ADDR means don't change the address.)  */
 636 extern rtx change_address PARAMS ((rtx, enum machine_mode, rtx));
 637
 638 /* Return a memory reference like MEMREF, but with its mode changed
 639    to MODE and its address offset by OFFSET bytes.  */
 640 #define adjust_address(MEMREF, MODE, OFFSET) \
 641   adjust_address_1 (MEMREF, MODE, OFFSET, 1, 1)
 642
 643 /* Likewise, but the reference is not required to be valid.  */
 644 #define adjust_address_nv(MEMREF, MODE, OFFSET) \
 645   adjust_address_1 (MEMREF, MODE, OFFSET, 0, 1)
 646
 647 /* Return a memory reference like MEMREF, but with its mode changed
 648    to MODE and its address changed to ADDR, which is assumed to be
 649    increased by OFFSET bytes from MEMREF.  */
 650 #define adjust_automodify_address(MEMREF, MODE, ADDR, OFFSET) \
 651   adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 1)
 652
 653 /* Likewise, but the reference is not required to be valid.  */
 654 #define adjust_automodify_address_nv(MEMREF, MODE, ADDR, OFFSET) \
 655   adjust_automodify_address_1 (MEMREF, MODE, ADDR, OFFSET, 0)
 656
 657 extern rtx adjust_address_1 PARAMS ((rtx, enum machine_mode, HOST_WIDE_INT,
 658                                      int, int));
 659 extern rtx adjust_automodify_address_1 PARAMS ((rtx, enum machine_mode,
 660                                                 rtx, HOST_WIDE_INT, int));
 661
 662 /* Return a memory reference like MEMREF, but whose address is changed by
 663    adding OFFSET, an RTX, to it.  POW2 is the highest power of two factor
 664    known to be in OFFSET (possibly 1).  */
 665 extern rtx offset_address PARAMS ((rtx, rtx, HOST_WIDE_INT));
 666
 667 /* Return a memory reference like MEMREF, but with its address changed to
 668    ADDR.  The caller is asserting that the actual piece of memory pointed
 669    to is the same, just the form of the address is being changed, such as
 670    by putting something into a register.  */
 671 extern rtx replace_equiv_address PARAMS ((rtx, rtx));
 672
 673 /* Likewise, but the reference is not required to be valid.  */
 674 extern rtx replace_equiv_address_nv PARAMS ((rtx, rtx));
 675
 676 /* Return a memory reference like MEMREF, but with its mode widened to
 677    MODE and adjusted by OFFSET.  */
 678 extern rtx widen_memory_access PARAMS ((rtx, enum machine_mode, HOST_WIDE_INT));
 679
 680 /* Return a memory reference like MEMREF, but which is known to have a
 681    valid address.  */
 682 extern rtx validize_mem PARAMS ((rtx));
 683
 684 #ifdef TREE_CODE
 685 /* Given REF, either a MEM or a REG, and T, either the type of X or
 686    the expression corresponding to REF, set RTX_UNCHANGING_P if
 687    appropriate.  */
 688 extern void maybe_set_unchanging PARAMS ((rtx, tree));
 689
 690 /* Given REF, a MEM, and T, either the type of X or the expression
 691    corresponding to REF, set the memory attributes.  OBJECTP is nonzero
 692    if we are making a new object of this type.  */
 693 extern void set_mem_attributes PARAMS ((rtx, tree, int));
 694
 695 /* Similar, except that BITPOS has not yet been applied to REF, so if
 696    we alter MEM_OFFSET according to T then we should subtract BITPOS
 697    expecting that it'll be added back in later.  */
 698 extern void set_mem_attributes_minus_bitpos PARAMS ((rtx, tree, int,
 699                                                      HOST_WIDE_INT));
 700 #endif
 701
 702 /* Assemble the static constant template for function entry trampolines.  */
 703 extern rtx assemble_trampoline_template PARAMS ((void));
 704
 705 /* Given rtx, return new rtx whose address won't be affected by
 706    any side effects.  It has been copied to a new temporary reg.  */
 707 extern rtx stabilize PARAMS ((rtx));
 708
 709 /* Given an rtx, copy all regs it refers to into new temps
 710    and return a modified copy that refers to the new temps.  */
 711 extern rtx copy_all_regs PARAMS ((rtx));
 712
 713 /* Copy given rtx to a new temp reg and return that.  */
 714 extern rtx copy_to_reg PARAMS ((rtx));
 715
 716 /* Like copy_to_reg but always make the reg Pmode.  */
 717 extern rtx copy_addr_to_reg PARAMS ((rtx));
 718
 719 /* Like copy_to_reg but always make the reg the specified mode MODE.  */
 720 extern rtx copy_to_mode_reg PARAMS ((enum machine_mode, rtx));
 721
 722 /* Copy given rtx to given temp reg and return that.  */
 723 extern rtx copy_to_suggested_reg PARAMS ((rtx, rtx, enum machine_mode));
 724
 725 /* Copy a value to a register if it isn't already a register.
 726    Args are mode (in case value is a constant) and the value.  */
 727 extern rtx force_reg PARAMS ((enum machine_mode, rtx));
 728
 729 /* Return given rtx, copied into a new temp reg if it was in memory.  */
 730 extern rtx force_not_mem PARAMS ((rtx));
 731
 732 #ifdef TREE_CODE
 733 /* Return mode and signedness to use when object is promoted.  */
 734 extern enum machine_mode promote_mode PARAMS ((tree, enum machine_mode,
 735                                                int *, int));
 736 #endif
 737
 738 /* Remove some bytes from the stack.  An rtx says how many.  */
 739 extern void adjust_stack PARAMS ((rtx));
 740
 741 /* Add some bytes to the stack.  An rtx says how many.  */
 742 extern void anti_adjust_stack PARAMS ((rtx));
 743
 744 /* This enum is used for the following two functions.  */
 745 enum save_level {SAVE_BLOCK, SAVE_FUNCTION, SAVE_NONLOCAL};
 746
 747 /* Save the stack pointer at the specified level.  */
 748 extern void emit_stack_save PARAMS ((enum save_level, rtx *, rtx));
 749
 750 /* Restore the stack pointer from a save area of the specified level.  */
 751 extern void emit_stack_restore PARAMS ((enum save_level, rtx, rtx));
 752
 753 /* Allocate some space on the stack dynamically and return its address.  An rtx
 754    says how many bytes.  */
 755 extern rtx allocate_dynamic_stack_space PARAMS ((rtx, rtx, int));
 756
 757 /* Probe a range of stack addresses from FIRST to FIRST+SIZE, inclusive.
 758    FIRST is a constant and size is a Pmode RTX.  These are offsets from the
 759    current stack pointer.  STACK_GROWS_DOWNWARD says whether to add or
 760    subtract from the stack.  If SIZE is constant, this is done
 761    with a fixed number of probes.  Otherwise, we must make a loop.  */
 762 extern void probe_stack_range PARAMS ((HOST_WIDE_INT, rtx));
 763
 764 /* Return an rtx that refers to the value returned by a library call
 765    in its original home.  This becomes invalid if any more code is emitted.  */
 766 extern rtx hard_libcall_value PARAMS ((enum machine_mode));
 767
 768 /* Given an rtx, return an rtx for a value rounded up to a multiple
 769    of STACK_BOUNDARY / BITS_PER_UNIT.  */
 770 extern rtx round_push PARAMS ((rtx));
 771
 772 /* Return the mode desired by operand N of a particular bitfield
 773    insert/extract insn, or MAX_MACHINE_MODE if no such insn is
 774    available.  */
 775
 776 enum extraction_pattern { EP_insv, EP_extv, EP_extzv };
 777 extern enum machine_mode
 778 mode_for_extraction PARAMS ((enum extraction_pattern, int));
 779
 780 extern rtx store_bit_field PARAMS ((rtx, unsigned HOST_WIDE_INT,
 781                                     unsigned HOST_WIDE_INT,
 782                                     enum machine_mode, rtx, HOST_WIDE_INT));
 783 extern rtx extract_bit_field PARAMS ((rtx, unsigned HOST_WIDE_INT,
 784                                       unsigned HOST_WIDE_INT, int, rtx,
 785                                       enum machine_mode, enum machine_mode,
 786                                       HOST_WIDE_INT));
 787 extern rtx expand_mult PARAMS ((enum machine_mode, rtx, rtx, rtx, int));
 788 extern bool const_mult_add_overflow_p PARAMS ((rtx, rtx, rtx, enum machine_mode, int));
 789 extern rtx expand_mult_add PARAMS ((rtx, rtx, rtx, rtx,enum machine_mode, int));
 790 extern rtx expand_mult_highpart_adjust PARAMS ((enum machine_mode, rtx, rtx, rtx, rtx, int));
 791
 792 extern rtx assemble_static_space PARAMS ((int));
 793
 794 /* Hook called by expand_expr for language-specific tree codes.
 795    It is up to the language front end to install a hook
 796    if it has any such codes that expand_expr needs to know about.  */
 797 extern rtx (*lang_expand_expr) PARAMS ((union tree_node *, rtx,
 798                                         enum machine_mode,
 799                                         enum expand_modifier modifier));
 800
 801 extern int safe_from_p PARAMS ((rtx, tree, int));
 802
 803 /* Call this once to initialize the contents of the optabs
 804    appropriately for the current target machine.  */
 805 extern void init_optabs                         PARAMS ((void));
 806 extern void init_all_optabs                     PARAMS ((void));
 807
 808 /* Call this to initialize an optab function entry.  */
 809 extern rtx init_one_libfunc                     PARAMS ((const char *));
 810
 811 extern void do_jump_by_parts_equality_rtx       PARAMS ((rtx, rtx, rtx));
 812 extern void do_jump_by_parts_greater_rtx        PARAMS ((enum machine_mode,
 813                                                          int, rtx, rtx, rtx,
 814                                                          rtx));
 815
 816 #ifdef TREE_CODE   /* Don't lose if tree.h not included.  */
 817 extern void mark_seen_cases                     PARAMS ((tree, unsigned char *,
 818                                                          HOST_WIDE_INT, int));
 819 #endif
 820
 821 extern int vector_mode_valid_p          PARAMS ((enum machine_mode));