gcc/tree-chrec.h

   1 /* Chains of recurrences.
   2    Copyright (C) 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
   3    Contributed by Sebastian Pop <pop@cri.ensmp.fr>
   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 3, 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 COPYING3.  If not see
  19 <http://www.gnu.org/licenses/>.  */
  20
  21 #ifndef GCC_TREE_CHREC_H
  22 #define GCC_TREE_CHREC_H
  23
  24 /* The following trees are unique elements.  Thus the comparison of another
  25    element to these elements should be done on the pointer to these trees,
  26    and not on their value.  */
  27
  28 extern tree chrec_not_analyzed_yet;
  29 extern GTY(()) tree chrec_dont_know;
  30 extern GTY(()) tree chrec_known;
  31
  32 /* After having added an automatically generated element, please
  33    include it in the following function.  */
  34
  35 static inline bool
  36 automatically_generated_chrec_p (const_tree chrec)
  37 {
  38   return (chrec == chrec_dont_know
  39           || chrec == chrec_known);
  40 }
  41
  42 /* The tree nodes aka. CHRECs.  */
  43
  44 static inline bool
  45 tree_is_chrec (const_tree expr)
  46 {
  47   if (TREE_CODE (expr) == POLYNOMIAL_CHREC
  48       || automatically_generated_chrec_p (expr))
  49     return true;
  50   else
  51     return false;
  52 }
  53
  54 \f
  55
  56 /* Chrec folding functions.  */
  57 extern tree chrec_fold_plus (tree, tree, tree);
  58 extern tree chrec_fold_minus (tree, tree, tree);
  59 extern tree chrec_fold_multiply (tree, tree, tree);
  60 extern tree chrec_convert (tree, tree, tree);
  61 extern tree chrec_convert_rhs (tree, tree, tree);
  62 extern tree chrec_convert_aggressive (tree, tree);
  63
  64 /* Operations.  */
  65 extern tree chrec_apply (unsigned, tree, tree);
  66 extern tree chrec_replace_initial_condition (tree, tree);
  67 extern tree initial_condition (tree);
  68 extern tree initial_condition_in_loop_num (tree, unsigned);
  69 extern tree evolution_part_in_loop_num (tree, unsigned);
  70 extern tree hide_evolution_in_other_loops_than_loop (tree, unsigned);
  71 extern tree reset_evolution_in_loop (unsigned, tree, tree);
  72 extern tree chrec_merge (tree, tree);
  73
  74 /* Observers.  */
  75 extern bool eq_evolutions_p (const_tree, const_tree);
  76 extern bool is_multivariate_chrec (const_tree);
  77 extern bool chrec_is_positive (tree, bool *);
  78 extern bool chrec_contains_symbols (const_tree);
  79 extern bool chrec_contains_symbols_defined_in_loop (const_tree, unsigned);
  80 extern bool chrec_contains_undetermined (const_tree);
  81 extern bool tree_contains_chrecs (const_tree, int *);
  82 extern bool evolution_function_is_affine_multivariate_p (const_tree, int);
  83 extern bool evolution_function_is_univariate_p (const_tree);
  84 extern unsigned nb_vars_in_chrec (tree);
  85 extern bool evolution_function_is_invariant_p (tree, int);
  86
  87 /* Determines whether CHREC is equal to zero.  */
  88
  89 static inline bool
  90 chrec_zerop (const_tree chrec)
  91 {
  92   if (chrec == NULL_TREE)
  93     return false;
  94
  95   if (TREE_CODE (chrec) == INTEGER_CST)
  96     return integer_zerop (chrec);
  97
  98   return false;
  99 }
 100
 101 /* Determines whether CHREC is a loop invariant with respect to LOOP_NUM.
 102    Set the result in RES and return true when the property can be computed.  */
 103
 104 static inline bool
 105 no_evolution_in_loop_p (tree chrec, unsigned loop_num, bool *res)
 106 {
 107   tree scev;
 108
 109   if (chrec == chrec_not_analyzed_yet
 110       || chrec == chrec_dont_know
 111       || chrec_contains_symbols_defined_in_loop (chrec, loop_num))
 112     return false;
 113
 114   scev = hide_evolution_in_other_loops_than_loop (chrec, loop_num);
 115   *res = !tree_is_chrec (scev);
 116   return true;
 117 }
 118
 119 /* Build a polynomial chain of recurrence.  */
 120
 121 static inline tree
 122 build_polynomial_chrec (unsigned loop_num,
 123                         tree left,
 124                         tree right)
 125 {
 126   bool val;
 127
 128   if (left == chrec_dont_know
 129       || right == chrec_dont_know)
 130     return chrec_dont_know;
 131
 132   if (no_evolution_in_loop_p (left, loop_num, &val) && !val)
 133     return chrec_dont_know;
 134
 135   /* Pointer types should occur only on the left hand side, i.e. in
 136      the base of the chrec, and not in the step.  */
 137   gcc_assert (!POINTER_TYPE_P (TREE_TYPE (right)));
 138
 139   /* Types of left and right sides of a chrec should be compatible.  */
 140   if (POINTER_TYPE_P (TREE_TYPE (left)))
 141     gcc_assert (sizetype == TREE_TYPE (right));
 142   else
 143     gcc_assert (TREE_TYPE (left) == TREE_TYPE (right));
 144
 145   if (chrec_zerop (right))
 146     return left;
 147
 148   return build3 (POLYNOMIAL_CHREC, TREE_TYPE (left),
 149                  build_int_cst (NULL_TREE, loop_num), left, right);
 150 }
 151
 152 /* Determines whether the expression CHREC is a constant.  */
 153
 154 static inline bool
 155 evolution_function_is_constant_p (const_tree chrec)
 156 {
 157   if (chrec == NULL_TREE)
 158     return false;
 159
 160   switch (TREE_CODE (chrec))
 161     {
 162     case INTEGER_CST:
 163     case REAL_CST:
 164       return true;
 165
 166     default:
 167       return false;
 168     }
 169 }
 170
 171 /* Determine whether CHREC is an affine evolution function in LOOPNUM.  */
 172
 173 static inline bool
 174 evolution_function_is_affine_in_loop (const_tree chrec, int loopnum)
 175 {
 176   if (chrec == NULL_TREE)
 177     return false;
 178
 179   switch (TREE_CODE (chrec))
 180     {
 181     case POLYNOMIAL_CHREC:
 182       if (evolution_function_is_invariant_p (CHREC_LEFT (chrec), loopnum)
 183           && evolution_function_is_invariant_p (CHREC_RIGHT (chrec), loopnum))
 184         return true;
 185       else
 186         return false;
 187
 188     default:
 189       return false;
 190     }
 191 }
 192
 193 /* Determine whether CHREC is an affine evolution function or not.  */
 194
 195 static inline bool
 196 evolution_function_is_affine_p (const_tree chrec)
 197 {
 198   if (chrec == NULL_TREE)
 199     return false;
 200
 201   switch (TREE_CODE (chrec))
 202     {
 203     case POLYNOMIAL_CHREC:
 204       if (evolution_function_is_invariant_p (CHREC_LEFT (chrec),
 205                                              CHREC_VARIABLE (chrec))
 206           && evolution_function_is_invariant_p (CHREC_RIGHT (chrec),
 207                                                 CHREC_VARIABLE (chrec)))
 208         return true;
 209       else
 210         return false;
 211
 212     default:
 213       return false;
 214     }
 215 }
 216
 217 /* Determines whether EXPR does not contains chrec expressions.  */
 218
 219 static inline bool
 220 tree_does_not_contain_chrecs (const_tree expr)
 221 {
 222   return !tree_contains_chrecs (expr, NULL);
 223 }
 224
 225 /* Returns the type of the chrec.  */
 226
 227 static inline tree
 228 chrec_type (const_tree chrec)
 229 {
 230   if (automatically_generated_chrec_p (chrec))
 231     return NULL_TREE;
 232
 233   return TREE_TYPE (chrec);
 234 }
 235
 236 static inline tree
 237 chrec_fold_op (enum tree_code code, tree type, tree op0, tree op1)
 238 {
 239   switch (code)
 240     {
 241     case PLUS_EXPR:
 242       return chrec_fold_plus (type, op0, op1);
 243
 244     case MINUS_EXPR:
 245       return chrec_fold_minus (type, op0, op1);
 246
 247     case MULT_EXPR:
 248       return chrec_fold_multiply (type, op0, op1);
 249
 250     default:
 251       gcc_unreachable ();
 252     }
 253
 254 }
 255
 256 #endif  /* GCC_TREE_CHREC_H  */