clang 18.0.0git
CheckerHelpers.cpp
Go to the documentation of this file.
1//===---- CheckerHelpers.cpp - Helper functions for checkers ----*- 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// This file defines several static functions for use in checkers.
10//
11//===----------------------------------------------------------------------===//
12
14#include "clang/AST/Decl.h"
15#include "clang/AST/Expr.h"
17#include <optional>
18
19namespace clang {
20
21namespace ento {
22
23// Recursively find any substatements containing macros
24bool containsMacro(const Stmt *S) {
25 if (S->getBeginLoc().isMacroID())
26 return true;
27
28 if (S->getEndLoc().isMacroID())
29 return true;
30
31 for (const Stmt *Child : S->children())
32 if (Child && containsMacro(Child))
33 return true;
34
35 return false;
36}
37
38// Recursively find any substatements containing enum constants
39bool containsEnum(const Stmt *S) {
40 const DeclRefExpr *DR = dyn_cast<DeclRefExpr>(S);
41
42 if (DR && isa<EnumConstantDecl>(DR->getDecl()))
43 return true;
44
45 for (const Stmt *Child : S->children())
46 if (Child && containsEnum(Child))
47 return true;
48
49 return false;
50}
51
52// Recursively find any substatements containing static vars
53bool containsStaticLocal(const Stmt *S) {
54 const DeclRefExpr *DR = dyn_cast<DeclRefExpr>(S);
55
56 if (DR)
57 if (const VarDecl *VD = dyn_cast<VarDecl>(DR->getDecl()))
58 if (VD->isStaticLocal())
59 return true;
60
61 for (const Stmt *Child : S->children())
62 if (Child && containsStaticLocal(Child))
63 return true;
64
65 return false;
66}
67
68// Recursively find any substatements containing __builtin_offsetof
70 if (isa<OffsetOfExpr>(S))
71 return true;
72
73 for (const Stmt *Child : S->children())
74 if (Child && containsBuiltinOffsetOf(Child))
75 return true;
76
77 return false;
78}
79
80// Extract lhs and rhs from assignment statement
81std::pair<const clang::VarDecl *, const clang::Expr *>
83 const VarDecl *VD = nullptr;
84 const Expr *RHS = nullptr;
85
86 if (auto Assign = dyn_cast_or_null<BinaryOperator>(S)) {
87 if (Assign->isAssignmentOp()) {
88 // Ordinary assignment
89 RHS = Assign->getRHS();
90 if (auto DE = dyn_cast_or_null<DeclRefExpr>(Assign->getLHS()))
91 VD = dyn_cast_or_null<VarDecl>(DE->getDecl());
92 }
93 } else if (auto PD = dyn_cast_or_null<DeclStmt>(S)) {
94 // Initialization
95 assert(PD->isSingleDecl() && "We process decls one by one");
96 VD = cast<VarDecl>(PD->getSingleDecl());
97 RHS = VD->getAnyInitializer();
98 }
99
100 return std::make_pair(VD, RHS);
101}
102
104 const auto *AttrType = Type->getAs<AttributedType>();
105 if (!AttrType)
107 if (AttrType->getAttrKind() == attr::TypeNullable)
109 else if (AttrType->getAttrKind() == attr::TypeNonNull)
112}
113
114std::optional<int> tryExpandAsInteger(StringRef Macro, const Preprocessor &PP) {
115 const auto *MacroII = PP.getIdentifierInfo(Macro);
116 if (!MacroII)
117 return std::nullopt;
118 const MacroInfo *MI = PP.getMacroInfo(MacroII);
119 if (!MI)
120 return std::nullopt;
121
122 // Filter out parens.
123 std::vector<Token> FilteredTokens;
124 FilteredTokens.reserve(MI->tokens().size());
125 for (auto &T : MI->tokens())
126 if (!T.isOneOf(tok::l_paren, tok::r_paren))
127 FilteredTokens.push_back(T);
128
129 // Parse an integer at the end of the macro definition.
130 const Token &T = FilteredTokens.back();
131 // FIXME: EOF macro token coming from a PCH file on macOS while marked as
132 // literal, doesn't contain any literal data
133 if (!T.isLiteral() || !T.getLiteralData())
134 return std::nullopt;
135 StringRef ValueStr = StringRef(T.getLiteralData(), T.getLength());
136 llvm::APInt IntValue;
137 constexpr unsigned AutoSenseRadix = 0;
138 if (ValueStr.getAsInteger(AutoSenseRadix, IntValue))
139 return std::nullopt;
140
141 // Parse an optional minus sign.
142 size_t Size = FilteredTokens.size();
143 if (Size >= 2) {
144 if (FilteredTokens[Size - 2].is(tok::minus))
145 IntValue = -IntValue;
146 }
147
148 return IntValue.getSExtValue();
149}
150
152 bool IsBinary) {
153 llvm::StringMap<BinaryOperatorKind> BinOps{
154#define BINARY_OPERATION(Name, Spelling) {Spelling, BO_##Name},
155#include "clang/AST/OperationKinds.def"
156 };
157 llvm::StringMap<UnaryOperatorKind> UnOps{
158#define UNARY_OPERATION(Name, Spelling) {Spelling, UO_##Name},
159#include "clang/AST/OperationKinds.def"
160 };
161
162 switch (OOK) {
163#define OVERLOADED_OPERATOR(Name, Spelling, Token, Unary, Binary, MemberOnly) \
164 case OO_##Name: \
165 if (IsBinary) { \
166 auto BinOpIt = BinOps.find(Spelling); \
167 if (BinOpIt != BinOps.end()) \
168 return OperatorKind(BinOpIt->second); \
169 else \
170 llvm_unreachable("operator was expected to be binary but is not"); \
171 } else { \
172 auto UnOpIt = UnOps.find(Spelling); \
173 if (UnOpIt != UnOps.end()) \
174 return OperatorKind(UnOpIt->second); \
175 else \
176 llvm_unreachable("operator was expected to be unary but is not"); \
177 } \
178 break;
179#include "clang/Basic/OperatorKinds.def"
180 default:
181 llvm_unreachable("unexpected operator kind");
182 }
183}
184
185} // namespace ento
186} // namespace clang
Defines the clang::Preprocessor interface.
An attributed type is a type to which a type attribute has been applied.
Definition: Type.h:5026
A reference to a declared variable, function, enum, etc.
Definition: Expr.h:1248
ValueDecl * getDecl()
Definition: Expr.h:1316
This represents one expression.
Definition: Expr.h:110
Encapsulates the data about a macro definition (e.g.
Definition: MacroInfo.h:39
ArrayRef< Token > tokens() const
Definition: MacroInfo.h:249
Engages in a tight little dance with the lexer to efficiently preprocess tokens.
Definition: Preprocessor.h:128
const MacroInfo * getMacroInfo(const IdentifierInfo *II) const
IdentifierInfo * getIdentifierInfo(StringRef Name) const
Return information about the specified preprocessor identifier token.
A (possibly-)qualified type.
Definition: Type.h:736
Stmt - This represents one statement.
Definition: Stmt.h:84
Token - This structure provides full information about a lexed token.
Definition: Token.h:35
bool isLiteral() const
Return true if this is a "literal", like a numeric constant, string, etc.
Definition: Token.h:115
unsigned getLength() const
Definition: Token.h:134
const char * getLiteralData() const
getLiteralData - For a literal token (numeric constant, string, etc), this returns a pointer to the s...
Definition: Token.h:224
The base class of the type hierarchy.
Definition: Type.h:1602
const T * getAs() const
Member-template getAs<specific type>'.
Definition: Type.h:7558
Represents a variable declaration or definition.
Definition: Decl.h:916
const Expr * getAnyInitializer() const
Get the initializer for this variable, no matter which declaration it is attached to.
Definition: Decl.h:1340
bool containsEnum(const Stmt *S)
Nullability getNullabilityAnnotation(QualType Type)
Get nullability annotation for a given type.
bool containsStaticLocal(const Stmt *S)
std::pair< const clang::VarDecl *, const clang::Expr * > parseAssignment(const Stmt *S)
OperatorKind operationKindFromOverloadedOperator(OverloadedOperatorKind OOK, bool IsBinary)
bool containsBuiltinOffsetOf(const Stmt *S)
std::optional< int > tryExpandAsInteger(StringRef Macro, const Preprocessor &PP)
Try to parse the value of a defined preprocessor macro.
bool containsMacro(const Stmt *S)
OverloadedOperatorKind
Enumeration specifying the different kinds of C++ overloaded operators.
Definition: OperatorKinds.h:21