annotate gcc/range-op.h @ 158:494b0b89df80 default tip

...
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 25 May 2020 18:13:55 +0900
parents 1830386684a0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
145
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
1 /* Header file for range operator class.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
2 Copyright (C) 2017-2020 Free Software Foundation, Inc.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
3 Contributed by Andrew MacLeod <amacleod@redhat.com>
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
4 and Aldy Hernandez <aldyh@redhat.com>.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
5
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
6 This file is part of GCC.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
7
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
8 GCC is free software; you can redistribute it and/or modify it under
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
9 the terms of the GNU General Public License as published by the Free
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
10 Software Foundation; either version 3, or (at your option) any later
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
11 version.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
12
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
16 for more details.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
17
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
18 You should have received a copy of the GNU General Public License
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
19 along with GCC; see the file COPYING3. If not see
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
20 <http://www.gnu.org/licenses/>. */
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
21
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
22 #ifndef GCC_RANGE_OP_H
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
23 #define GCC_RANGE_OP_H
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
24
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
25 // This class is implemented for each kind of operator supported by
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
26 // the range generator. It serves various purposes.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
27 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
28 // 1 - Generates range information for the specific operation between
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
29 // two ranges. This provides the ability to fold ranges for an
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
30 // expression.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
31 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
32 // 2 - Performs range algebra on the expression such that a range can be
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
33 // adjusted in terms of one of the operands:
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
34 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
35 // def = op1 + op2
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
36 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
37 // Given a range for def, we can adjust the range so that it is in
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
38 // terms of either operand.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
39 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
40 // op1_range (def_range, op2) will adjust the range in place so it
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
41 // is in terms of op1. Since op1 = def - op2, it will subtract
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
42 // op2 from each element of the range.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
43 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
44 // 3 - Creates a range for an operand based on whether the result is 0 or
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
45 // non-zero. This is mostly for logical true false, but can serve other
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
46 // purposes.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
47 // ie 0 = op1 - op2 implies op2 has the same range as op1.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
48
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
49 class range_operator
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
50 {
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
51 public:
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
52 // Perform an operation between 2 ranges and return it.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
53 virtual bool fold_range (value_range &r, tree type,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
54 const value_range &lh,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
55 const value_range &rh) const;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
56
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
57 // Return the range for op[12] in the general case. LHS is the range for
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
58 // the LHS of the expression, OP[12]is the range for the other
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
59 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
60 // The operand and the result is returned in R.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
61 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
62 // TYPE is the expected type of the range.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
63 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
64 // Return TRUE if the operation is performed and a valid range is available.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
65 //
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
66 // i.e. [LHS] = ??? + OP2
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
67 // is re-formed as R = [LHS] - OP2.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
68 virtual bool op1_range (value_range &r, tree type,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
69 const value_range &lhs,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
70 const value_range &op2) const;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
71 virtual bool op2_range (value_range &r, tree type,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
72 const value_range &lhs,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
73 const value_range &op1) const;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
74
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
75 protected:
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
76 // Perform an integral operation between 2 sub-ranges and return it.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
77 virtual void wi_fold (value_range &r, tree type,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
78 const wide_int &lh_lb,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
79 const wide_int &lh_ub,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
80 const wide_int &rh_lb,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
81 const wide_int &rh_ub) const;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
82 };
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
83
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
84 extern range_operator *range_op_handler (enum tree_code code, tree type);
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
85 extern void range_cast (value_range &, tree type);
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
86 extern void wi_set_zero_nonzero_bits (tree type,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
87 const wide_int &, const wide_int &,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
88 wide_int &maybe_nonzero,
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
89 wide_int &mustbe_nonzero);
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
90
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
91 #endif // GCC_RANGE_OP_H