1//===- DWARFAttribute.h -----------------------------------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef LLVM_DEBUGINFO_DWARF_DWARFATTRIBUTE_H
10#define LLVM_DEBUGINFO_DWARF_DWARFATTRIBUTE_H
11
12#include "llvm/BinaryFormat/Dwarf.h"
13#include "llvm/DebugInfo/DWARF/DWARFFormValue.h"
14#include "llvm/Support/Compiler.h"
15#include <cstdint>
16
17namespace llvm {
18
19//===----------------------------------------------------------------------===//
20/// Encapsulates a DWARF attribute value and all of the data required to
21/// describe the attribute value.
22///
23/// This class is designed to be used by clients that want to iterate across all
24/// attributes in a DWARFDie.
25struct DWARFAttribute {
26 /// The debug info/types offset for this attribute.
27 uint64_t Offset = 0;
28 /// The debug info/types section byte size of the data for this attribute.
29 uint32_t ByteSize = 0;
30 /// The attribute enumeration of this attribute.
31 dwarf::Attribute Attr = dwarf::Attribute(0);
32 /// The form and value for this attribute.
33 DWARFFormValue Value;
34
35 bool isValid() const {
36 return Offset != 0 && Attr != dwarf::Attribute(0);
37 }
38
39 explicit operator bool() const {
40 return isValid();
41 }
42
43 /// Identify DWARF attributes that may contain a pointer to a location list.
44 LLVM_ABI static bool mayHaveLocationList(dwarf::Attribute Attr);
45
46 /// Identifies DWARF attributes that may contain a reference to a
47 /// DWARF expression.
48 LLVM_ABI static bool mayHaveLocationExpr(dwarf::Attribute Attr);
49};
50
51} // end namespace llvm
52
53#endif // LLVM_DEBUGINFO_DWARF_DWARFATTRIBUTE_H
54