- //===- Reassociate.h - Reassociate binary expressions -----------*- C++ -*-===// 
- // 
- // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 
- // See https://llvm.org/LICENSE.txt for license information. 
- // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 
- // 
- //===----------------------------------------------------------------------===// 
- // 
- // This pass reassociates commutative expressions in an order that is designed 
- // to promote better constant propagation, GCSE, LICM, PRE, etc. 
- // 
- // For example: 4 + (x + 5) -> x + (4 + 5) 
- // 
- // In the implementation of this algorithm, constants are assigned rank = 0, 
- // function arguments are rank = 1, and other values are assigned ranks 
- // corresponding to the reverse post order traversal of current function 
- // (starting at 2), which effectively gives values in deep loops higher rank 
- // than values not in loops. 
- // 
- //===----------------------------------------------------------------------===// 
-   
- #ifndef LLVM_TRANSFORMS_SCALAR_REASSOCIATE_H 
- #define LLVM_TRANSFORMS_SCALAR_REASSOCIATE_H 
-   
- #include "llvm/ADT/DenseMap.h" 
- #include "llvm/ADT/PostOrderIterator.h" 
- #include "llvm/ADT/SetVector.h" 
- #include "llvm/IR/PassManager.h" 
- #include "llvm/IR/ValueHandle.h" 
- #include <deque> 
-   
- namespace llvm { 
-   
- class APInt; 
- class BasicBlock; 
- class BinaryOperator; 
- class Function; 
- class Instruction; 
- class IRBuilderBase; 
- class Value; 
-   
- /// A private "module" namespace for types and utilities used by Reassociate. 
- /// These are implementation details and should not be used by clients. 
- namespace reassociate { 
-   
- struct ValueEntry { 
-   unsigned Rank; 
-   Value *Op; 
-   
-   ValueEntry(unsigned R, Value *O) : Rank(R), Op(O) {} 
- }; 
-   
- inline bool operator<(const ValueEntry &LHS, const ValueEntry &RHS) { 
-   return LHS.Rank > RHS.Rank; // Sort so that highest rank goes to start. 
- } 
-   
- /// Utility class representing a base and exponent pair which form one 
- /// factor of some product. 
- struct Factor { 
-   Value *Base; 
-   unsigned Power; 
-   
-   Factor(Value *Base, unsigned Power) : Base(Base), Power(Power) {} 
- }; 
-   
- class XorOpnd; 
-   
- } // end namespace reassociate 
-   
- /// Reassociate commutative expressions. 
- class ReassociatePass : public PassInfoMixin<ReassociatePass> { 
- public: 
-   using OrderedSet = 
-       SetVector<AssertingVH<Instruction>, std::deque<AssertingVH<Instruction>>>; 
-   
- protected: 
-   DenseMap<BasicBlock *, unsigned> RankMap; 
-   DenseMap<AssertingVH<Value>, unsigned> ValueRankMap; 
-   OrderedSet RedoInsts; 
-   
-   // Arbitrary, but prevents quadratic behavior. 
-   static const unsigned GlobalReassociateLimit = 10; 
-   static const unsigned NumBinaryOps = 
-       Instruction::BinaryOpsEnd - Instruction::BinaryOpsBegin; 
-   
-   struct PairMapValue { 
-     WeakVH Value1; 
-     WeakVH Value2; 
-     unsigned Score; 
-     bool isValid() const { return Value1 && Value2; } 
-   }; 
-   DenseMap<std::pair<Value *, Value *>, PairMapValue> PairMap[NumBinaryOps]; 
-   
-   bool MadeChange; 
-   
- public: 
-   PreservedAnalyses run(Function &F, FunctionAnalysisManager &); 
-   
- private: 
-   void BuildRankMap(Function &F, ReversePostOrderTraversal<Function *> &RPOT); 
-   unsigned getRank(Value *V); 
-   void canonicalizeOperands(Instruction *I); 
-   void ReassociateExpression(BinaryOperator *I); 
-   void RewriteExprTree(BinaryOperator *I, 
-                        SmallVectorImpl<reassociate::ValueEntry> &Ops); 
-   Value *OptimizeExpression(BinaryOperator *I, 
-                             SmallVectorImpl<reassociate::ValueEntry> &Ops); 
-   Value *OptimizeAdd(Instruction *I, 
-                      SmallVectorImpl<reassociate::ValueEntry> &Ops); 
-   Value *OptimizeXor(Instruction *I, 
-                      SmallVectorImpl<reassociate::ValueEntry> &Ops); 
-   bool CombineXorOpnd(Instruction *I, reassociate::XorOpnd *Opnd1, 
-                       APInt &ConstOpnd, Value *&Res); 
-   bool CombineXorOpnd(Instruction *I, reassociate::XorOpnd *Opnd1, 
-                       reassociate::XorOpnd *Opnd2, APInt &ConstOpnd, 
-                       Value *&Res); 
-   Value *buildMinimalMultiplyDAG(IRBuilderBase &Builder, 
-                                  SmallVectorImpl<reassociate::Factor> &Factors); 
-   Value *OptimizeMul(BinaryOperator *I, 
-                      SmallVectorImpl<reassociate::ValueEntry> &Ops); 
-   Value *RemoveFactorFromExpression(Value *V, Value *Factor); 
-   void EraseInst(Instruction *I); 
-   void RecursivelyEraseDeadInsts(Instruction *I, OrderedSet &Insts); 
-   void OptimizeInst(Instruction *I); 
-   Instruction *canonicalizeNegFPConstantsForOp(Instruction *I, Instruction *Op, 
-                                                Value *OtherOp); 
-   Instruction *canonicalizeNegFPConstants(Instruction *I); 
-   void BuildPairMap(ReversePostOrderTraversal<Function *> &RPOT); 
- }; 
-   
- } // end namespace llvm 
-   
- #endif // LLVM_TRANSFORMS_SCALAR_REASSOCIATE_H 
-