1 //===---- llvm/MDBuilder.h - Builder for LLVM metadata ----------*- 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 the MDBuilder class, which is used as a convenient way to
11 // create LLVM metadata with a consistent and simplified interface.
13 //===----------------------------------------------------------------------===//
15 #ifndef LLVM_IR_MDBUILDER_H
16 #define LLVM_IR_MDBUILDER_H
18 #include "llvm/Support/DataTypes.h"
24 template <typename T> class ArrayRef;
34 MDBuilder(LLVMContext &context) : Context(context) {}
36 /// \brief Return the given string as metadata.
37 MDString *createString(StringRef Str);
39 //===------------------------------------------------------------------===//
41 //===------------------------------------------------------------------===//
43 /// \brief Return metadata with the given settings. The special value 0.0
44 /// for the Accuracy parameter indicates the default (maximal precision)
46 MDNode *createFPMath(float Accuracy);
48 //===------------------------------------------------------------------===//
50 //===------------------------------------------------------------------===//
52 /// \brief Return metadata containing two branch weights.
53 MDNode *createBranchWeights(uint32_t TrueWeight, uint32_t FalseWeight);
55 /// \brief Return metadata containing a number of branch weights.
56 MDNode *createBranchWeights(ArrayRef<uint32_t> Weights);
58 //===------------------------------------------------------------------===//
60 //===------------------------------------------------------------------===//
62 /// \brief Return metadata describing the range [Lo, Hi).
63 MDNode *createRange(const APInt &Lo, const APInt &Hi);
65 //===------------------------------------------------------------------===//
67 //===------------------------------------------------------------------===//
69 /// \brief Return metadata appropriate for a TBAA root node. Each returned
70 /// node is distinct from all other metadata and will never be identified
71 /// (uniqued) with anything else.
72 MDNode *createAnonymousTBAARoot();
74 /// \brief Return metadata appropriate for a TBAA root node with the given
75 /// name. This may be identified (uniqued) with other roots with the same
77 MDNode *createTBAARoot(StringRef Name);
79 /// \brief Return metadata for a non-root TBAA node with the given name,
80 /// parent in the TBAA tree, and value for 'pointsToConstantMemory'.
81 MDNode *createTBAANode(StringRef Name, MDNode *Parent,
82 bool isConstant = false);
84 struct TBAAStructField {
88 TBAAStructField(uint64_t Offset, uint64_t Size, MDNode *TBAA) :
89 Offset(Offset), Size(Size), TBAA(TBAA) {}
92 /// \brief Return metadata for a tbaa.struct node with the given
93 /// struct field descriptions.
94 MDNode *createTBAAStructNode(ArrayRef<TBAAStructField> Fields);
96 /// \brief Return metadata for a TBAA struct node in the type DAG
97 /// with the given name, a list of pairs (offset, field type in the type DAG).
99 createTBAAStructTypeNode(StringRef Name,
100 ArrayRef<std::pair<MDNode *, uint64_t>> Fields);
102 /// \brief Return metadata for a TBAA scalar type node with the
103 /// given name, an offset and a parent in the TBAA type DAG.
104 MDNode *createTBAAScalarTypeNode(StringRef Name, MDNode *Parent,
105 uint64_t Offset = 0);
107 /// \brief Return metadata for a TBAA tag node with the given
108 /// base type, access type and offset relative to the base type.
109 MDNode *createTBAAStructTagNode(MDNode *BaseType, MDNode *AccessType,
113 } // end namespace llvm