LLVM 23.0.0git
Public Types | Public Member Functions | Static Public Member Functions | List of all members
llvm::DebugLoc Class Reference

A debug info location. More...

#include "llvm/IR/DebugLoc.h"

Public Types

enum  { ReplaceLastInlinedAt = true }

Public Member Functions

 DebugLoc (const DILocation *L=nullptr)
 Construct from an DILocation.
DebugLoc orElse (DebugLoc Other) const
 If this DebugLoc is non-empty, returns this DebugLoc; otherwise, selects Other.
DebugLoc getCopied () const
 operator bool () const
 Check for null.
bool isSameSourceLocation (const DebugLoc &Other) const
 Return true if the source locations match, ignoring isImplicitCode and source atom info.
LLVM_ABI unsigned getLine () const
LLVM_ABI unsigned getCol () const
LLVM_ABI MDNode * getScope () const
LLVM_ABI DILocation * getInlinedAt () const
LLVM_ABI MDNode * getInlinedAtScope () const
 Get the fully inlined-at scope for a DebugLoc.
LLVM_ABI DebugLoc getFnDebugLoc () const
 Find the debug info location for the start of the function.
LLVM_ABI MDNode * getAsMDNode () const
 Return this as a bar MDNode.
LLVM_ABI bool isImplicitCode () const
 Check if the DebugLoc corresponds to an implicit code.
LLVM_ABI void setImplicitCode (bool ImplicitCode)
bool operator== (const DebugLoc &DL) const
bool operator!= (const DebugLoc &DL) const
LLVM_ABI void dump () const
LLVM_ABI void print (raw_ostream &OS) const
 prints source location /path/to/file.exe:line:col @[inlined at]
DILocation * get () const
 Get the underlying DILocation.
 operator DILocation * () const
DILocation * operator-> () const
DILocation & operator* () const

Static Public Member Functions

static DebugLoc getTemporary ()
static DebugLoc getUnknown ()
static DebugLoc getCompilerGenerated ()
static DebugLoc getDropped ()
static LLVM_ABI DebugLoc getMergedLocation (DebugLoc LocA, DebugLoc LocB)
 When two instructions are combined into a single instruction we also need to combine the original locations into a single location.
static LLVM_ABI DebugLoc getMergedLocations (ArrayRef< DebugLoc > Locs)
 Try to combine the vector of locations passed as input in a single one.
static LLVM_ABI DebugLoc appendInlinedAt (const DebugLoc &DL, DILocation *InlinedAt, LLVMContext &Ctx, DenseMap< const MDNode *, MDNode * > &Cache)
 Rebuild the entire inlined-at chain for this instruction so that the top of the chain now is inlined-at the new call site.
static LLVM_ABI DebugLoc replaceInlinedAtSubprogram (const DebugLoc &DL, DISubprogram &NewSP, LLVMContext &Ctx, DenseMap< const MDNode *, MDNode * > &Cache)
 Rebuild the entire inline-at chain by replacing the subprogram at the end of the chain with NewSP.

Detailed Description

A debug info location.

This class is a wrapper around an DILocation pointer.

To avoid extra includes, DebugLoc doubles the DILocation API with a one based on relatively opaque MDNode pointers.

Definition at line 124 of file DebugLoc.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
Enumerator
ReplaceLastInlinedAt 

Definition at line 232 of file DebugLoc.h.

Constructor & Destructor Documentation

◆ DebugLoc()

llvm::DebugLoc::DebugLoc ( const DILocation * L = nullptr)
inline

Construct from an DILocation.

Definition at line 129 of file DebugLoc.h.

Referenced by appendInlinedAt(), getCompilerGenerated(), getCopied(), getDropped(), getFnDebugLoc(), getMergedLocation(), getMergedLocations(), getTemporary(), getUnknown(), isSameSourceLocation(), operator!=(), operator==(), orElse(), print(), and replaceInlinedAtSubprogram().

Member Function Documentation

◆ appendInlinedAt()

DebugLoc DebugLoc::appendInlinedAt ( const DebugLoc & DL,
DILocation * InlinedAt,
LLVMContext & Ctx,
DenseMap< const MDNode *, MDNode * > & Cache )
static

Rebuild the entire inlined-at chain for this instruction so that the top of the chain now is inlined-at the new call site.

Parameters
InlinedAtThe new outermost inlined-at in the chain.

Definition at line 126 of file DebugLoc.cpp.

References llvm::cast(), DebugLoc(), DL, llvm::MDNode::getDistinct(), llvm::Last, llvm::SmallVectorTemplateBase< T, bool >::push_back(), and llvm::reverse().

Referenced by inlineDebugLoc().

◆ dump()

LLVM_DUMP_METHOD void DebugLoc::dump ( ) const

Definition at line 187 of file DebugLoc.cpp.

References llvm::dbgs(), LLVM_DUMP_METHOD, and print().

◆ get()

DILocation * llvm::DebugLoc::get ( ) const
inline

Get the underlying DILocation.

Precondition
!*this or isa<DILocation>(getAsMDNode()).

Definition at line 218 of file DebugLoc.h.

Referenced by llvm::addLocationToRemarks(), llvm::ConvertDebugDeclareToDebugValue(), llvm::ConvertDebugDeclareToDebugValue(), fixupLineNumbers(), llvm::formatCallSiteLocation(), getCol(), getInlinedAt(), getLine(), getScope(), insertDbgValueOrDbgVariableRecord(), isImplicitCode(), isSameSourceLocation(), operator DILocation *(), operator*(), operator->(), llvm::DebugInfoFinder::processDbgRecord(), and setImplicitCode().

◆ getAsMDNode()

MDNode * DebugLoc::getAsMDNode ( ) const

Return this as a bar MDNode.

Definition at line 73 of file DebugLoc.cpp.

◆ getCol()

unsigned DebugLoc::getCol ( ) const

Definition at line 45 of file DebugLoc.cpp.

References assert(), and get().

Referenced by inlineDebugLoc(), isSameSourceLocation(), print(), and llvm::MachineBasicBlock::SplitCriticalEdge().

◆ getCompilerGenerated()

DebugLoc llvm::DebugLoc::getCompilerGenerated ( )
inlinestatic

Definition at line 152 of file DebugLoc.h.

References DebugLoc(), and llvm::dwarf_linker::DebugLoc.

Referenced by llvm::VPlanTransforms::addExplicitVectorLength(), buildPartialInvariantUnswitchConditionalBranch(), buildPartialUnswitchConditionalBranch(), expandVPDerivedIV(), HandleByValArgument(), llvm::VPlanTransforms::materializeAliasMask(), llvm::VPlanTransforms::materializeAliasMaskCheckBlock(), llvm::VPlanTransforms::materializeBackedgeTakenCount(), llvm::VPlanTransforms::materializeVectorTripCount(), and processInternalGlobal().

◆ getCopied()

DebugLoc llvm::DebugLoc::getCopied ( ) const
inline

Definition at line 211 of file DebugLoc.h.

References DebugLoc().

◆ getDropped()

DebugLoc llvm::DebugLoc::getDropped ( )
inlinestatic

Definition at line 153 of file DebugLoc.h.

References DebugLoc(), and llvm::dwarf_linker::DebugLoc.

Referenced by cloneInstructionsIntoPredecessorBlockAndUpdateSSAUses(), llvm::Instruction::dropLocation(), llvm::InstCombinerImpl::foldPHIArgZextsIntoPHI(), hoistBOAssociation(), hoistMulAddAssociation(), hoistSubAddAssociation(), moveFunctionData(), llvm::promoteLoopAccessesToScalars(), replaceArgumentUses(), llvm::JumpThreadingPass::simplifyPartiallyRedundantLoad(), and unswitchNontrivialInvariants().

◆ getFnDebugLoc()

DebugLoc DebugLoc::getFnDebugLoc ( ) const

Find the debug info location for the start of the function.

Walk up the scope chain of given debug loc and find line number info for the function.

FIXME: Remove this. Users should use DILocation/DILocalScope API to find the subprogram, and then DILocation::get().

Definition at line 64 of file DebugLoc.cpp.

References DebugLoc(), llvm::dwarf_linker::DebugLoc, llvm::MDNode::get(), llvm::getDISubprogram(), and getInlinedAtScope().

◆ getInlinedAt()

DILocation * DebugLoc::getInlinedAt ( ) const

Definition at line 55 of file DebugLoc.cpp.

References assert(), and get().

Referenced by buildOverlapMapAndRecordDeclares(), findVarsWithStackSlot(), fixupDebugInfoPostExtraction(), getAggregateVariable(), llvm::getDebugValueLoc(), llvm::SelectionDAGBuilder::handleDebugValue(), isSameSourceLocation(), llvm::DroppedVariableStats::populateVarIDSetAndInlinedMap(), and print().

◆ getInlinedAtScope()

MDNode * DebugLoc::getInlinedAtScope ( ) const

Get the fully inlined-at scope for a DebugLoc.

Gets the inlined-at scope for a DebugLoc.

Definition at line 60 of file DebugLoc.cpp.

References llvm::cast().

Referenced by getFnDebugLoc().

◆ getLine()

unsigned DebugLoc::getLine ( ) const

Definition at line 40 of file DebugLoc.cpp.

References assert(), and get().

Referenced by llvm::applyDebugifyMetadataToMachineFunction(), llvm::SampleProfileLoaderBaseImpl< FT >::getInstWeightImpl(), inlineDebugLoc(), isSameSourceLocation(), print(), and llvm::MachineBasicBlock::SplitCriticalEdge().

◆ getMergedLocation()

DebugLoc DebugLoc::getMergedLocation ( DebugLoc LocA,
DebugLoc LocB )
static

When two instructions are combined into a single instruction we also need to combine the original locations into a single location.

When the locations are the same we can use either location. When they differ, we need a third location which is distinct from either. If they share a common scope, use this scope and compare the line/column pair of the locations with the common scope:

  • if both match, keep the line and column;
  • if only the line number matches, keep the line and set the column as 0;
  • otherwise set line and column as 0. If they do not share a common scope the location is ambiguous and can't be represented in a line entry. In this case, set line and column as 0 and use the scope of any location.

LocA LocB: The locations to be merged.

Definition at line 169 of file DebugLoc.cpp.

References DebugLoc(), and llvm::DILocation::getMergedLocation().

Referenced by llvm::Instruction::applyMergedLocation(), llvm::MachineBasicBlock::findBranchDebugLoc(), getMergedLocations(), mergeCompatibleInvokesImpl(), mergeDebugLocs(), llvm::InstCombinerImpl::mergeStoreIntoSuccessor(), performBlockTailMerging(), performSink(), and llvm::LegalizationArtifactCombiner::tryCombineAnyExt().

◆ getMergedLocations()

DebugLoc DebugLoc::getMergedLocations ( ArrayRef< DebugLoc > Locs)
static

Try to combine the vector of locations passed as input in a single one.

This function applies getMergedLocation() repeatedly left-to-right.

Locs: The locations to be merged.

Definition at line 156 of file DebugLoc.cpp.

References DebugLoc(), llvm::dwarf_linker::DebugLoc, DL, llvm::drop_begin(), llvm::ArrayRef< T >::empty(), getMergedLocation(), and llvm::ArrayRef< T >::size().

Referenced by mergeConsecutivePartStores(), and llvm::promoteLoopAccessesToScalars().

◆ getScope()

MDNode * DebugLoc::getScope ( ) const

Definition at line 50 of file DebugLoc.cpp.

References assert(), and get().

Referenced by llvm::getDebugValueLoc(), inlineDebugLoc(), isSameSourceLocation(), and print().

◆ getTemporary()

DebugLoc llvm::DebugLoc::getTemporary ( )
inlinestatic

Definition at line 150 of file DebugLoc.h.

References DebugLoc(), and llvm::dwarf_linker::DebugLoc.

Referenced by createUnreachableSwitchDefault(), llvm::InlineFunctionImpl(), markAliveBlocks(), mergeCompatibleInvokesImpl(), processSwitch(), llvm::SCCPSolver::removeNonFeasibleEdges(), and llvm::JumpThreadingPass::tryToUnfoldSelectInCurrBB().

◆ getUnknown()

DebugLoc llvm::DebugLoc::getUnknown ( )
inlinestatic

Definition at line 151 of file DebugLoc.h.

References DebugLoc(), and llvm::dwarf_linker::DebugLoc.

Referenced by llvm::VPlanTransforms::addExplicitVectorLength(), llvm::VPlanTransforms::addMinimumVectorEpilogueIterationCheck(), addVPLaneMaskPhiAndUpdateExitBranch(), llvm::VPlanTransforms::attachAliasMaskToHeaderMask(), llvm::checkDebugInfoMetadata(), llvm::VPlanTransforms::convertToStridedAccesses(), llvm::VPBuilder::createAdd(), llvm::VPBuilder::createAnd(), llvm::SSAUpdaterTraits< SSAUpdater >::CreateEmptyPHI(), llvm::VPBuilder::createFCmp(), llvm::VPBuilder::createFirstActiveLane(), llvm::VPBuilder::createICmp(), llvm::VPBuilder::createLastActiveLane(), llvm::VPBuilder::createLogicalAnd(), llvm::VPBuilder::createLogicalOr(), createLoopRegion(), llvm::VPBuilder::createNaryOp(), llvm::VPBuilder::createNot(), llvm::VPBuilder::createNoWrapPtrAdd(), llvm::VPBuilder::createOr(), llvm::VPBuilder::createPtrAdd(), createReplicateRegion(), llvm::VPBuilder::createScalarPhi(), llvm::VPBuilder::createSelect(), llvm::VPBuilder::createSub(), llvm::VPBuilder::createWidenPhi(), llvm::VPBuilder::createWidePtrAdd(), expandVPWidenIntOrFpInduction(), findDebugLoc(), fixupVFUsersForEVL(), getDebugLocFromInstOrOperands(), getDebugLocFromPHI(), llvm::VPlanTransforms::handleUncountableEarlyExits(), llvm::InlineFunctionImpl(), llvm::VPlanTransforms::materializeAliasMask(), llvm::VPVectorEndPointerRecipe::materializeOffset(), optimizeLatchExitInductionUser(), optimizeMaskToEVL(), llvm::VPHeaderPHIRecipe::VPHeaderPHIRecipe(), llvm::VPRecipeBase::VPRecipeBase(), llvm::VPRecipeWithIRFlags::VPRecipeWithIRFlags(), llvm::VPRecipeWithIRFlags::VPRecipeWithIRFlags(), llvm::VPReductionEVLRecipe::VPReductionEVLRecipe(), llvm::VPReductionRecipe::VPReductionRecipe(), llvm::VPReductionRecipe::VPReductionRecipe(), llvm::VPScalarIVStepsRecipe::VPScalarIVStepsRecipe(), llvm::VPSingleDefRecipe::VPSingleDefRecipe(), llvm::VPSingleDefRecipe::VPSingleDefRecipe(), llvm::VPSingleDefRecipe::VPSingleDefRecipe(), and llvm::VPWidenPHIRecipe::VPWidenPHIRecipe().

◆ isImplicitCode()

bool DebugLoc::isImplicitCode ( ) const

Check if the DebugLoc corresponds to an implicit code.

Definition at line 75 of file DebugLoc.cpp.

References get().

Referenced by inlineDebugLoc().

◆ isSameSourceLocation()

bool llvm::DebugLoc::isSameSourceLocation ( const DebugLoc & Other) const
inline

Return true if the source locations match, ignoring isImplicitCode and source atom info.

Definition at line 242 of file DebugLoc.h.

References DebugLoc(), get(), getCol(), getInlinedAt(), getLine(), getScope(), and llvm::Other.

Referenced by cloneInstructionsIntoPredecessorBlockAndUpdateSSAUses().

◆ operator bool()

llvm::DebugLoc::operator bool ( ) const
inlineexplicit

Check for null.

Check for null in a way that is safe with broken debug info. Unlike the conversion to DILocation, this doesn't require that Loc is of the right type. Important for cases like llvm::StripDebugInfo() and Instruction::hasMetadata().

Definition at line 230 of file DebugLoc.h.

◆ operator DILocation *()

llvm::DebugLoc::operator DILocation * ( ) const
inline

Definition at line 219 of file DebugLoc.h.

References get().

◆ operator!=()

bool llvm::DebugLoc::operator!= ( const DebugLoc & DL) const
inline

Definition at line 284 of file DebugLoc.h.

References DebugLoc(), and DL.

◆ operator*()

DILocation & llvm::DebugLoc::operator* ( ) const
inline

Definition at line 221 of file DebugLoc.h.

References get().

◆ operator->()

DILocation * llvm::DebugLoc::operator-> ( ) const
inline

Definition at line 220 of file DebugLoc.h.

References get().

◆ operator==()

bool llvm::DebugLoc::operator== ( const DebugLoc & DL) const
inline

Definition at line 283 of file DebugLoc.h.

References DebugLoc(), and DL.

◆ orElse()

DebugLoc llvm::DebugLoc::orElse ( DebugLoc Other) const
inline

If this DebugLoc is non-empty, returns this DebugLoc; otherwise, selects Other.

In coverage-tracking builds, this also accounts for whether this or Other have an annotative DebugLocKind applied, such that if both are empty but exactly one has an annotation, we prefer that annotated location.

Definition at line 185 of file DebugLoc.h.

References DebugLoc(), and llvm::Other.

◆ print()

void DebugLoc::print ( raw_ostream & OS) const

prints source location /path/to/file.exe:line:col @[inlined at]

Definition at line 190 of file DebugLoc.cpp.

References llvm::cast(), DebugLoc(), getCol(), getInlinedAt(), getLine(), and getScope().

Referenced by dump().

◆ replaceInlinedAtSubprogram()

DebugLoc DebugLoc::replaceInlinedAtSubprogram ( const DebugLoc & DL,
DISubprogram & NewSP,
LLVMContext & Ctx,
DenseMap< const MDNode *, MDNode * > & Cache )
static

Rebuild the entire inline-at chain by replacing the subprogram at the end of the chain with NewSP.

Definition at line 86 of file DebugLoc.cpp.

References llvm::cast(), llvm::DILocalScope::cloneScopeForSubprogram(), DebugLoc(), llvm::MDNode::get(), llvm::SmallVectorImpl< T >::pop_back_val(), llvm::SmallVectorTemplateBase< T, bool >::push_back(), and llvm::reverse().

Referenced by fixupDebugInfoPostExtraction().

◆ setImplicitCode()

void DebugLoc::setImplicitCode ( bool ImplicitCode)

Definition at line 81 of file DebugLoc.cpp.

References get().

The documentation for this class was generated from the following files:
Generated on for LLVM by doxygen 1.14.0