1 //===---- llvm/Support/DebugLoc.h - Debug Location Information --*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file defines a number of light weight data structures used
11 // to describe and track debug location information.
13 //===----------------------------------------------------------------------===//
15 #ifndef LLVM_DEBUGLOC_H
16 #define LLVM_DEBUGLOC_H
18 #include "llvm/ADT/DenseMap.h"
25 /// DebugLoc - Debug location id. This is carried by Instruction, SDNode,
26 /// and MachineInstr to compactly encode file/line/scope information for an
29 /// LineCol - This 32-bit value encodes the line and column number for the
30 /// location, encoded as 24-bits for line and 8 bits for col. A value of 0
31 /// for either means unknown.
34 /// ScopeIdx - This is an opaque ID# for Scope/InlinedAt information,
35 /// decoded by LLVMContext. 0 is unknown.
38 NewDebugLoc() : LineCol(0), ScopeIdx(0) {} // Defaults to unknown.
40 /// get - Get a new DebugLoc that corresponds to the specified line/col
41 /// scope/inline location.
42 static NewDebugLoc get(unsigned Line, unsigned Col,
43 MDNode *Scope, MDNode *InlinedAt = 0);
45 /// getFromDILocation - Translate the DILocation quad into a NewDebugLoc.
46 static NewDebugLoc getFromDILocation(MDNode *N);
48 /// isUnknown - Return true if this is an unknown location.
49 bool isUnknown() const { return ScopeIdx == 0; }
51 unsigned getLine() const {
52 return (LineCol << 8) >> 8; // Mask out column.
55 unsigned getCol() const {
59 /// getScope - This returns the scope pointer for this DebugLoc, or null if
61 MDNode *getScope(const LLVMContext &Ctx) const;
63 /// getInlinedAt - This returns the InlinedAt pointer for this DebugLoc, or
64 /// null if invalid or not present.
65 MDNode *getInlinedAt(const LLVMContext &Ctx) const;
67 /// getScopeAndInlinedAt - Return both the Scope and the InlinedAt values.
68 void getScopeAndInlinedAt(MDNode *&Scope, MDNode *&IA,
69 const LLVMContext &Ctx) const;
72 /// getAsMDNode - This method converts the compressed DebugLoc node into a
73 /// DILocation compatible MDNode.
74 MDNode *getAsMDNode(const LLVMContext &Ctx) const;
76 bool operator==(const NewDebugLoc &DL) const {
77 return LineCol == DL.LineCol && ScopeIdx == DL.ScopeIdx;
79 bool operator!=(const NewDebugLoc &DL) const { return !(*this == DL); }
84 static NewDebugLoc getUnknownLoc() { NewDebugLoc L; return L; }
88 typedef NewDebugLoc DebugLoc;
90 } // end namespace llvm
92 #endif /* LLVM_DEBUGLOC_H */