llvm::sandboxir::Tracker Class Reference

The tracker collects all the change objects and implements the main API for saving / reverting / accepting. More...

#include "llvm/SandboxIR/Tracker.h"

Public Types
enum class	TrackerState { Disabled , Record }

Public Member Functions
	Tracker (Context &Ctx)
	~Tracker ()
Context &	getContext () const
void	track (std::unique_ptr< IRChangeBase > &&Change)
	Record Change and take ownership.
template<typename ChangeT , typename... ArgsT>
bool	emplaceIfTracking (ArgsT... Args)
	A convenience wrapper for track() that constructs and tracks the Change object if tracking is enabled.
bool	isTracking () const
	\Returns true if the tracker is recording changes.
TrackerState	getState () const
	\Returns the current state of the tracker.
void	save ()
	Turns on IR tracking.
void	accept ()
	Stops tracking and accept changes.
void	revert ()
	Stops tracking and reverts to saved state.
void	dump (raw_ostream &OS) const
LLVM_DUMP_METHOD void	dump () const

Public Attributes
bool	InMiddleOfCreatingChange = false
	Helps catch bugs where we are creating new change objects while in the middle of creating other change objects.

Friends
raw_ostream &	operator<< (raw_ostream &OS, const Tracker &Tracker)

Detailed Description

The tracker collects all the change objects and implements the main API for saving / reverting / accepting.

Definition at line 360 of file Tracker.h.

Member Enumeration Documentation

TrackerState

enum class llvm::sandboxir::Tracker::TrackerState

strong

Enumerator
Disabled
Record	‍Tracking is disabled

Definition at line 362 of file Tracker.h.

Constructor & Destructor Documentation

Tracker()

llvm::sandboxir::Tracker::Tracker ( Context &  Ctx )

inlineexplicit

Definition at line 381 of file Tracker.h.

~Tracker()

Tracker::~Tracker

(

)

Definition at line 78 of file Tracker.cpp.

References assert().

Member Function Documentation

accept()

void Tracker::accept

(

)

Stops tracking and accept changes.

Definition at line 247 of file Tracker.cpp.

References assert(), Disabled, and Record.

Referenced by llvm::sandboxir::Context::accept().

dump() [1/2]

void Tracker::dump

(

)

const

Definition at line 263 of file Tracker.cpp.

References llvm::dbgs(), and dump().

Referenced by dump().

dump() [2/2]

void Tracker::dump

(

raw_ostream &

OS

)

const

Definition at line 256 of file Tracker.cpp.

References llvm::enumerate(), Idx, and OS.

emplaceIfTracking()

template<typename ChangeT , typename... ArgsT>

bool llvm::sandboxir::Tracker::emplaceIfTracking ( ArgsT...  Args )

inline

A convenience wrapper for track() that constructs and tracks the Change object if tracking is enabled.

\Returns true if tracking is enabled.

Definition at line 403 of file Tracker.h.

References isTracking(), and track().

Referenced by llvm::sandboxir::SwitchInst::addCase(), llvm::sandboxir::CatchSwitchInst::addHandler(), llvm::sandboxir::PHINode::addIncoming(), llvm::sandboxir::Instruction::copyFastMathFlags(), llvm::sandboxir::Instruction::insertBefore(), llvm::sandboxir::Instruction::insertInto(), llvm::sandboxir::Instruction::moveBefore(), llvm::sandboxir::Context::registerValue(), llvm::sandboxir::SwitchInst::removeCase(), llvm::sandboxir::Instruction::removeFromParent(), llvm::sandboxir::PHINode::removeIncomingValue(), llvm::sandboxir::User::replaceUsesOfWith(), llvm::sandboxir::Value::replaceUsesWithIf(), llvm::sandboxir::Use::set(), llvm::sandboxir::AtomicRMWInst::setAlignment(), llvm::sandboxir::AtomicCmpXchgInst::setAlignment(), llvm::sandboxir::AllocaInst::setAlignment(), llvm::sandboxir::AllocaInst::setAllocatedType(), llvm::sandboxir::SwitchInst::setCondition(), llvm::sandboxir::CallBrInst::setDefaultDest(), llvm::sandboxir::SwitchInst::setDefaultDest(), llvm::sandboxir::AtomicCmpXchgInst::setFailureOrdering(), llvm::sandboxir::Instruction::setFast(), llvm::sandboxir::Instruction::setFastMathFlags(), llvm::sandboxir::Instruction::setHasAllowContract(), llvm::sandboxir::Instruction::setHasAllowReassoc(), llvm::sandboxir::Instruction::setHasAllowReciprocal(), llvm::sandboxir::Instruction::setHasApproxFunc(), llvm::sandboxir::Instruction::setHasNoInfs(), llvm::sandboxir::Instruction::setHasNoNaNs(), llvm::sandboxir::Instruction::setHasNoSignedWrap(), llvm::sandboxir::Instruction::setHasNoSignedZeros(), llvm::sandboxir::Instruction::setHasNoUnsignedWrap(), llvm::sandboxir::PHINode::setIncomingBlock(), llvm::sandboxir::PHINode::setIncomingValue(), llvm::sandboxir::CallBrInst::setIndirectDest(), llvm::sandboxir::Instruction::setIsExact(), llvm::sandboxir::User::setOperand(), llvm::sandboxir::AtomicRMWInst::setOrdering(), llvm::sandboxir::CatchSwitchInst::setParentPad(), llvm::sandboxir::SwitchInst::setSuccessor(), llvm::sandboxir::AtomicCmpXchgInst::setSuccessOrdering(), llvm::sandboxir::AtomicRMWInst::setSyncScopeID(), llvm::sandboxir::AtomicCmpXchgInst::setSyncScopeID(), llvm::sandboxir::CatchSwitchInst::setUnwindDest(), llvm::sandboxir::AllocaInst::setUsedWithInAlloca(), llvm::sandboxir::LoadInst::setVolatile(), llvm::sandboxir::StoreInst::setVolatile(), llvm::sandboxir::AtomicRMWInst::setVolatile(), llvm::sandboxir::AtomicCmpXchgInst::setVolatile(), llvm::sandboxir::AtomicCmpXchgInst::setWeak(), and llvm::sandboxir::Use::swap().

getContext()

Context & llvm::sandboxir::Tracker::getContext ( ) const

inline

Definition at line 383 of file Tracker.h.

Referenced by llvm::sandboxir::EraseFromParent::revert().

getState()

TrackerState llvm::sandboxir::Tracker::getState ( ) const

inline

\Returns the current state of the tracker.

Definition at line 412 of file Tracker.h.

isTracking()

bool llvm::sandboxir::Tracker::isTracking ( ) const

inline

\Returns true if the tracker is recording changes.

Definition at line 410 of file Tracker.h.

References Record.

Referenced by emplaceIfTracking(), llvm::sandboxir::Instruction::eraseFromParent(), llvm::sandboxir::Value::replaceAllUsesWith(), llvm::sandboxir::User::replaceUsesOfWith(), and track().

revert()

void Tracker::revert

(

)

Stops tracking and reverts to saved state.

Definition at line 239 of file Tracker.cpp.

References assert(), Disabled, Record, and llvm::reverse().

Referenced by llvm::sandboxir::Context::revert().

save()

void Tracker::save

(

)

Turns on IR tracking.

Definition at line 237 of file Tracker.cpp.

References Record.

Referenced by llvm::sandboxir::Context::save().

track()

void llvm::sandboxir::Tracker::track ( std::unique_ptr< IRChangeBase > &&  Change )

inline

Record Change and take ownership.

This is the main function used to track Sandbox IR changes.

Definition at line 386 of file Tracker.h.

References assert(), InMiddleOfCreatingChange, isTracking(), llvm::SmallVectorTemplateBase< T, bool >::push_back(), and Record.

Referenced by emplaceIfTracking(), llvm::sandboxir::Instruction::eraseFromParent(), and llvm::sandboxir::Value::replaceAllUsesWith().

Friends And Related Function Documentation

operator<<

raw_ostream & operator<< ( raw_ostream &  OS, const Tracker &  Tracker  )

friend

Definition at line 423 of file Tracker.h.

Member Data Documentation

InMiddleOfCreatingChange

bool llvm::sandboxir::Tracker::InMiddleOfCreatingChange = false

Helps catch bugs where we are creating new change objects while in the middle of creating other change objects.

Definition at line 378 of file Tracker.h.

Referenced by track().

---

The documentation for this class was generated from the following files:

• include/llvm/SandboxIR/Tracker.h
• lib/SandboxIR/Tracker.cpp