//=== InstructionWorklist.h - Worklist for InstCombine & others -*- 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
 
//
 
//===----------------------------------------------------------------------===//
 
 
 
#ifndef LLVM_TRANSFORMS_UTILS_INSTRUCTIONWORKLIST_H
 
#define LLVM_TRANSFORMS_UTILS_INSTRUCTIONWORKLIST_H
 
 
 
#include "llvm/ADT/DenseMap.h"
 
#include "llvm/ADT/STLExtras.h"
 
#include "llvm/ADT/SetVector.h"
 
#include "llvm/ADT/SmallVector.h"
 
#include "llvm/IR/Instruction.h"
 
#include "llvm/Support/Compiler.h"
 
#include "llvm/Support/Debug.h"
 
#include "llvm/Support/raw_ostream.h"
 
 
 
namespace llvm {
 
 
 
/// InstructionWorklist - This is the worklist management logic for
 
/// InstCombine and other simplification passes.
 
class InstructionWorklist {
 
  SmallVector<Instruction *, 256> Worklist;
 
  DenseMap<Instruction *, unsigned> WorklistMap;
 
  /// These instructions will be added in reverse order after the current
 
  /// combine has finished. This means that these instructions will be visited
 
  /// in the order they have been added.
 
  SmallSetVector<Instruction *, 16> Deferred;
 
 
 
public:
 
  InstructionWorklist() = default;
 
 
 
  InstructionWorklist(InstructionWorklist &&) = default;
 
  InstructionWorklist &operator=(InstructionWorklist &&) = default;
 
 
 
  bool isEmpty() const { return Worklist.empty() && Deferred.empty(); }
 
 
 
  /// Add instruction to the worklist.
 
  /// Instructions will be visited in the order they are added.
 
  /// You likely want to use this method.
 
  void add(Instruction *I) {
 
    if (Deferred.insert(I))
 
      LLVM_DEBUG(dbgs() << "ADD DEFERRED: " << *I << '\n');
 
  }
 
 
 
  /// Add value to the worklist if it is an instruction.
 
  /// Instructions will be visited in the order they are added.
 
  void addValue(Value *V) {
 
    if (Instruction *I = dyn_cast<Instruction>(V))
 
      add(I);
 
  }
 
 
 
  /// Push the instruction onto the worklist stack.
 
  /// Instructions that have been added first will be visited last.
 
  void push(Instruction *I) {
 
    assert(I);
 
    assert(I->getParent() && "Instruction not inserted yet?");
 
 
 
    if (WorklistMap.insert(std::make_pair(I, Worklist.size())).second) {
 
      LLVM_DEBUG(dbgs() << "ADD: " << *I << '\n');
 
      Worklist.push_back(I);
 
    }
 
  }
 
 
 
  void pushValue(Value *V) {
 
    if (Instruction *I = dyn_cast<Instruction>(V))
 
      push(I);
 
  }
 
 
 
  Instruction *popDeferred() {
 
    if (Deferred.empty())
 
      return nullptr;
 
    return Deferred.pop_back_val();
 
  }
 
 
 
  void reserve(size_t Size) {
 
    Worklist.reserve(Size + 16);
 
    WorklistMap.reserve(Size);
 
  }
 
 
 
  /// Remove I from the worklist if it exists.
 
  void remove(Instruction *I) {
 
    DenseMap<Instruction *, unsigned>::iterator It = WorklistMap.find(I);
 
    if (It != WorklistMap.end()) {
 
      // Don't bother moving everything down, just null out the slot.
 
      Worklist[It->second] = nullptr;
 
      WorklistMap.erase(It);
 
    }
 
 
 
    Deferred.remove(I);
 
  }
 
 
 
  Instruction *removeOne() {
 
    if (Worklist.empty())
 
      return nullptr;
 
    Instruction *I = Worklist.pop_back_val();
 
    WorklistMap.erase(I);
 
    return I;
 
  }
 
 
 
  /// When an instruction is simplified, add all users of the instruction
 
  /// to the work lists because they might get more simplified now.
 
  void pushUsersToWorkList(Instruction &I) {
 
    for (User *U : I.users())
 
      push(cast<Instruction>(U));
 
  }
 
 
 
  /// Check that the worklist is empty and nuke the backing store for the map.
 
  void zap() {
 
    assert(WorklistMap.empty() && "Worklist empty, but map not?");
 
    assert(Deferred.empty() && "Deferred instructions left over");
 
 
 
    // Do an explicit clear, this shrinks the map if needed.
 
    WorklistMap.clear();
 
  }
 
};
 
 
 
} // end namespace llvm.
 
 
 
#endif