clang 20.0.0git
EvaluationResult.cpp
Go to the documentation of this file.
1//===----- EvaluationResult.cpp - Result class for the VM ------*- 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#include "EvaluationResult.h"
10#include "InterpState.h"
11#include "Record.h"
12#include "clang/AST/ExprCXX.h"
13#include "llvm/ADT/SetVector.h"
14
15namespace clang {
16namespace interp {
17
19 assert(!empty());
20 switch (Kind) {
21 case LValue:
22 // Either a pointer or a function pointer.
23 if (const auto *P = std::get_if<Pointer>(&Value))
24 return P->toAPValue(Ctx->getASTContext());
25 else if (const auto *FP = std::get_if<FunctionPointer>(&Value))
26 return FP->toAPValue(Ctx->getASTContext());
27 else
28 llvm_unreachable("Unhandled LValue type");
29 break;
30 case RValue:
31 return std::get<APValue>(Value);
32 case Valid:
33 return APValue();
34 default:
35 llvm_unreachable("Unhandled result kind?");
36 }
37}
38
39std::optional<APValue> EvaluationResult::toRValue() const {
40 if (Kind == RValue)
41 return toAPValue();
42
43 assert(Kind == LValue);
44
45 // We have a pointer and want an RValue.
46 if (const auto *P = std::get_if<Pointer>(&Value))
47 return P->toRValue(*Ctx, getSourceType());
48 else if (const auto *FP = std::get_if<FunctionPointer>(&Value)) // Nope
49 return FP->toAPValue(Ctx->getASTContext());
50 llvm_unreachable("Unhandled lvalue kind");
51}
52
54 const FieldDecl *SubObjDecl) {
55 assert(SubObjDecl && "Subobject declaration does not exist");
56 S.FFDiag(Loc, diag::note_constexpr_uninitialized)
57 << /*(name)*/ 1 << SubObjDecl;
58 S.Note(SubObjDecl->getLocation(),
59 diag::note_constexpr_subobject_declared_here);
60}
61
62static bool CheckFieldsInitialized(InterpState &S, SourceLocation Loc,
63 const Pointer &BasePtr, const Record *R);
64
66 const Pointer &BasePtr,
67 const ConstantArrayType *CAT) {
68 bool Result = true;
69 size_t NumElems = CAT->getZExtSize();
70 QualType ElemType = CAT->getElementType();
71
72 if (ElemType->isRecordType()) {
73 const Record *R = BasePtr.getElemRecord();
74 for (size_t I = 0; I != NumElems; ++I) {
75 Pointer ElemPtr = BasePtr.atIndex(I).narrow();
76 Result &= CheckFieldsInitialized(S, Loc, ElemPtr, R);
77 }
78 } else if (const auto *ElemCAT = dyn_cast<ConstantArrayType>(ElemType)) {
79 for (size_t I = 0; I != NumElems; ++I) {
80 Pointer ElemPtr = BasePtr.atIndex(I).narrow();
81 Result &= CheckArrayInitialized(S, Loc, ElemPtr, ElemCAT);
82 }
83 } else {
84 for (size_t I = 0; I != NumElems; ++I) {
85 if (!BasePtr.atIndex(I).isInitialized()) {
87 Result = false;
88 }
89 }
90 }
91
92 return Result;
93}
94
96 const Pointer &BasePtr, const Record *R) {
97 assert(R);
98 bool Result = true;
99 // Check all fields of this record are initialized.
100 for (const Record::Field &F : R->fields()) {
101 Pointer FieldPtr = BasePtr.atField(F.Offset);
102 QualType FieldType = F.Decl->getType();
103
104 // Don't check inactive union members.
105 if (R->isUnion() && !FieldPtr.isActive())
106 continue;
107
108 if (FieldType->isRecordType()) {
109 Result &= CheckFieldsInitialized(S, Loc, FieldPtr, FieldPtr.getRecord());
110 } else if (FieldType->isIncompleteArrayType()) {
111 // Nothing to do here.
112 } else if (F.Decl->isUnnamedBitField()) {
113 // Nothing do do here.
114 } else if (FieldType->isArrayType()) {
115 const auto *CAT =
116 cast<ConstantArrayType>(FieldType->getAsArrayTypeUnsafe());
117 Result &= CheckArrayInitialized(S, Loc, FieldPtr, CAT);
118 } else if (!FieldPtr.isInitialized()) {
120 Result = false;
121 }
122 }
123
124 // Check Fields in all bases
125 for (const Record::Base &B : R->bases()) {
126 Pointer P = BasePtr.atField(B.Offset);
127 if (!P.isInitialized()) {
128 const Descriptor *Desc = BasePtr.getDeclDesc();
129 if (Desc->asDecl())
130 S.FFDiag(BasePtr.getDeclDesc()->asDecl()->getLocation(),
131 diag::note_constexpr_uninitialized_base)
132 << B.Desc->getType();
133 else
134 S.FFDiag(BasePtr.getDeclDesc()->asExpr()->getExprLoc(),
135 diag::note_constexpr_uninitialized_base)
136 << B.Desc->getType();
137
138 return false;
139 }
140 Result &= CheckFieldsInitialized(S, Loc, P, B.R);
141 }
142
143 // TODO: Virtual bases
144
145 return Result;
146}
147
149 const Pointer &Ptr) const {
150 assert(Source);
151 assert(empty());
152
153 if (Ptr.isZero())
154 return true;
155
156 // We can't inspect dead pointers at all. Return true here so we can
157 // diagnose them later.
158 if (!Ptr.isLive())
159 return true;
160
161 SourceLocation InitLoc;
162 if (const auto *D = Source.dyn_cast<const Decl *>())
163 InitLoc = cast<VarDecl>(D)->getAnyInitializer()->getExprLoc();
164 else if (const auto *E = Source.dyn_cast<const Expr *>())
165 InitLoc = E->getExprLoc();
166
167 if (const Record *R = Ptr.getRecord())
168 return CheckFieldsInitialized(S, InitLoc, Ptr, R);
169
170 if (const auto *CAT = dyn_cast_if_present<ConstantArrayType>(
172 return CheckArrayInitialized(S, InitLoc, Ptr, CAT);
173
174 return true;
175}
176
177static void collectBlocks(const Pointer &Ptr,
178 llvm::SetVector<const Block *> &Blocks) {
179 auto isUsefulPtr = [](const Pointer &P) -> bool {
180 return P.isLive() && !P.isZero() && !P.isDummy() &&
181 !P.isUnknownSizeArray() && !P.isOnePastEnd() && P.isBlockPointer();
182 };
183
184 if (!isUsefulPtr(Ptr))
185 return;
186
187 Blocks.insert(Ptr.block());
188
189 const Descriptor *Desc = Ptr.getFieldDesc();
190 if (!Desc)
191 return;
192
193 if (const Record *R = Desc->ElemRecord) {
194 for (const Record::Field &F : R->fields()) {
195 const Pointer &FieldPtr = Ptr.atField(F.Offset);
196 assert(FieldPtr.block() == Ptr.block());
197 collectBlocks(FieldPtr, Blocks);
198 }
199 } else if (Desc->isPrimitive() && Desc->getPrimType() == PT_Ptr) {
200 const Pointer &Pointee = Ptr.deref<Pointer>();
201 if (isUsefulPtr(Pointee) && !Blocks.contains(Pointee.block()))
202 collectBlocks(Pointee, Blocks);
203
204 } else if (Desc->isPrimitiveArray() && Desc->getPrimType() == PT_Ptr) {
205 for (unsigned I = 0; I != Desc->getNumElems(); ++I) {
206 const Pointer &ElemPointee = Ptr.atIndex(I).deref<Pointer>();
207 if (isUsefulPtr(ElemPointee) && !Blocks.contains(ElemPointee.block()))
208 collectBlocks(ElemPointee, Blocks);
209 }
210 } else if (Desc->isCompositeArray()) {
211 for (unsigned I = 0; I != Desc->getNumElems(); ++I) {
212 const Pointer &ElemPtr = Ptr.atIndex(I).narrow();
213 collectBlocks(ElemPtr, Blocks);
214 }
215 }
216}
217
219 const Pointer &Ptr,
220 const SourceInfo &Info) {
221 // Collect all blocks that this pointer (transitively) points to and
222 // return false if any of them is a dynamic block.
223 llvm::SetVector<const Block *> Blocks;
224
225 collectBlocks(Ptr, Blocks);
226
227 for (const Block *B : Blocks) {
228 if (B->isDynamic()) {
229 assert(B->getDescriptor());
230 assert(B->getDescriptor()->asExpr());
231
232 S.FFDiag(Info, diag::note_constexpr_dynamic_alloc)
233 << Ptr.getType()->isReferenceType() << !Ptr.isRoot();
234 S.Note(B->getDescriptor()->asExpr()->getExprLoc(),
235 diag::note_constexpr_dynamic_alloc_here);
236 return false;
237 }
238 }
239
240 return true;
241}
242
243} // namespace interp
244} // namespace clang
StringRef P
const Decl * D
Expr * E
Defines the clang::Expr interface and subclasses for C++ expressions.
llvm::MachO::Record Record
Definition: MachO.h:31
SourceLocation Loc
Definition: SemaObjC.cpp:758
APValue - This class implements a discriminated union of [uninitialized] [APSInt] [APFloat],...
Definition: APValue.h:122
QualType getElementType() const
Definition: Type.h:3552
Represents the canonical version of C arrays with a specified constant size.
Definition: Type.h:3578
uint64_t getZExtSize() const
Return the size zero-extended as a uint64_t.
Definition: Type.h:3654
Decl - This represents one declaration (or definition), e.g.
Definition: DeclBase.h:86
SourceLocation getLocation() const
Definition: DeclBase.h:445
This represents one expression.
Definition: Expr.h:110
SourceLocation getExprLoc() const LLVM_READONLY
getExprLoc - Return the preferred location for the arrow when diagnosing a problem with a generic exp...
Definition: Expr.cpp:277
Represents a member of a struct/union/class.
Definition: Decl.h:3030
A (possibly-)qualified type.
Definition: Type.h:941
Encodes a location in the source.
bool isIncompleteArrayType() const
Definition: Type.h:8072
bool isArrayType() const
Definition: Type.h:8064
bool isReferenceType() const
Definition: Type.h:8010
const ArrayType * getAsArrayTypeUnsafe() const
A variant of getAs<> for array types which silently discards qualifiers from the outermost type.
Definition: Type.h:8569
bool isRecordType() const
Definition: Type.h:8092
A memory block, either on the stack or in the heap.
Definition: InterpBlock.h:49
Holds all information required to evaluate constexpr code in a module.
Definition: Context.h:40
ASTContext & getASTContext() const
Returns the AST context.
Definition: Context.h:61
std::optional< APValue > toRValue() const
If the result is an LValue, convert that to an RValue and return it.
APValue toAPValue() const
Returns an APValue for the evaluation result.
bool checkReturnValue(InterpState &S, const Context &Ctx, const Pointer &Ptr, const SourceInfo &Info)
Check that none of the blocks the given pointer (transitively) points to are dynamically allocated.
bool checkFullyInitialized(InterpState &S, const Pointer &Ptr) const
Check that all subobjects of the given pointer have been initialized.
Interpreter context.
Definition: InterpState.h:36
A pointer to a memory block, live or dead.
Definition: Pointer.h:80
Pointer narrow() const
Restricts the scope of an array element pointer.
Definition: Pointer.h:179
bool isInitialized() const
Checks if an object was initialized.
Definition: Pointer.cpp:271
Pointer atIndex(uint64_t Idx) const
Offsets a pointer inside an array.
Definition: Pointer.h:144
bool isActive() const
Checks if the object is active.
Definition: Pointer.h:506
Pointer atField(unsigned Off) const
Creates a pointer to a field.
Definition: Pointer.h:163
T & deref() const
Dereferences the pointer, if it's live.
Definition: Pointer.h:609
QualType getType() const
Returns the type of the innermost field.
Definition: Pointer.h:334
bool isLive() const
Checks if the pointer is live.
Definition: Pointer.h:265
bool isZero() const
Checks if the pointer is null.
Definition: Pointer.h:256
bool isRoot() const
Pointer points directly to a block.
Definition: Pointer.h:418
const Descriptor * getDeclDesc() const
Accessor for information about the declaration site.
Definition: Pointer.h:279
const Record * getElemRecord() const
Returns the element record type, if this is a non-primive array.
Definition: Pointer.h:453
const FieldDecl * getField() const
Returns the field information.
Definition: Pointer.h:458
const Block * block() const
Definition: Pointer.h:559
const Descriptor * getFieldDesc() const
Accessors for information about the innermost field.
Definition: Pointer.h:324
const Record * getRecord() const
Returns the record descriptor of a class.
Definition: Pointer.h:451
Structure/Class descriptor.
Definition: Record.h:25
bool isUnion() const
Checks if the record is a union.
Definition: Record.h:56
llvm::iterator_range< const_base_iter > bases() const
Definition: Record.h:85
llvm::iterator_range< const_field_iter > fields() const
Definition: Record.h:77
Describes the statement/declaration an opcode was generated from.
Definition: Source.h:72
static void collectBlocks(const Pointer &Ptr, llvm::SetVector< const Block * > &Blocks)
static bool CheckFieldsInitialized(InterpState &S, SourceLocation Loc, const Pointer &BasePtr, const Record *R)
static void DiagnoseUninitializedSubobject(InterpState &S, SourceLocation Loc, const FieldDecl *SubObjDecl)
static bool CheckArrayInitialized(InterpState &S, SourceLocation Loc, const Pointer &BasePtr, const ConstantArrayType *CAT)
The JSON file list parser is used to communicate input to InstallAPI.
@ Result
The result type of a method or function.
Describes a memory block created by an allocation site.
Definition: Descriptor.h:107
unsigned getNumElems() const
Returns the number of elements stored in the block.
Definition: Descriptor.h:233
bool isPrimitive() const
Checks if the descriptor is of a primitive.
Definition: Descriptor.h:247
bool isCompositeArray() const
Checks if the descriptor is of an array of composites.
Definition: Descriptor.h:240
const Decl * asDecl() const
Definition: Descriptor.h:194
bool isPrimitiveArray() const
Checks if the descriptor is of an array of primitives.
Definition: Descriptor.h:238
PrimType getPrimType() const
Definition: Descriptor.h:220
const Record *const ElemRecord
Pointer to the record, if block contains records.
Definition: Descriptor.h:137
const Expr * asExpr() const
Definition: Descriptor.h:195