1 //===--- VariantValue.cpp - Polymorphic value type -*- C++ -*-===/
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 ///
10 /// \file
11 /// Polymorphic value type.
12 ///
13 //===----------------------------------------------------------------------===//
14 
15 #include "clang/ASTMatchers/Dynamic/VariantValue.h"
16 #include "clang/Basic/LLVM.h"
17 #include "llvm/ADT/STLExtras.h"
18 
19 namespace clang {
20 namespace ast_matchers {
21 namespace dynamic {
22 
asString() const23 std::string ArgKind::asString() const {
24   switch (getArgKind()) {
25   case AK_Matcher:
26     return (Twine("Matcher<") + MatcherKind.asStringRef() + ">").str();
27   case AK_Boolean:
28     return "boolean";
29   case AK_Double:
30     return "double";
31   case AK_Unsigned:
32     return "unsigned";
33   case AK_String:
34     return "string";
35   }
36   llvm_unreachable("unhandled ArgKind");
37 }
38 
isConvertibleTo(ArgKind To,unsigned * Specificity) const39 bool ArgKind::isConvertibleTo(ArgKind To, unsigned *Specificity) const {
40   if (K != To.K)
41     return false;
42   if (K != AK_Matcher) {
43     if (Specificity)
44       *Specificity = 1;
45     return true;
46   }
47   unsigned Distance;
48   if (!MatcherKind.isBaseOf(To.MatcherKind, &Distance))
49     return false;
50 
51   if (Specificity)
52     *Specificity = 100 - Distance;
53   return true;
54 }
55 
56 bool
canConstructFrom(const DynTypedMatcher & Matcher,bool & IsExactMatch) const57 VariantMatcher::MatcherOps::canConstructFrom(const DynTypedMatcher &Matcher,
58                                              bool &IsExactMatch) const {
59   IsExactMatch = Matcher.getSupportedKind().isSame(NodeKind);
60   return Matcher.canConvertTo(NodeKind);
61 }
62 
63 llvm::Optional<DynTypedMatcher>
constructVariadicOperator(DynTypedMatcher::VariadicOperator Op,ArrayRef<VariantMatcher> InnerMatchers) const64 VariantMatcher::MatcherOps::constructVariadicOperator(
65     DynTypedMatcher::VariadicOperator Op,
66     ArrayRef<VariantMatcher> InnerMatchers) const {
67   std::vector<DynTypedMatcher> DynMatchers;
68   for (const auto &InnerMatcher : InnerMatchers) {
69     // Abort if any of the inner matchers can't be converted to
70     // Matcher<T>.
71     if (!InnerMatcher.Value)
72       return llvm::None;
73     llvm::Optional<DynTypedMatcher> Inner =
74         InnerMatcher.Value->getTypedMatcher(*this);
75     if (!Inner)
76       return llvm::None;
77     DynMatchers.push_back(*Inner);
78   }
79   return DynTypedMatcher::constructVariadic(Op, NodeKind, DynMatchers);
80 }
81 
~Payload()82 VariantMatcher::Payload::~Payload() {}
83 
84 class VariantMatcher::SinglePayload : public VariantMatcher::Payload {
85 public:
SinglePayload(const DynTypedMatcher & Matcher)86   SinglePayload(const DynTypedMatcher &Matcher) : Matcher(Matcher) {}
87 
getSingleMatcher() const88   llvm::Optional<DynTypedMatcher> getSingleMatcher() const override {
89     return Matcher;
90   }
91 
getTypeAsString() const92   std::string getTypeAsString() const override {
93     return (Twine("Matcher<") + Matcher.getSupportedKind().asStringRef() + ">")
94         .str();
95   }
96 
97   llvm::Optional<DynTypedMatcher>
getTypedMatcher(const MatcherOps & Ops) const98   getTypedMatcher(const MatcherOps &Ops) const override {
99     bool Ignore;
100     if (Ops.canConstructFrom(Matcher, Ignore))
101       return Matcher;
102     return llvm::None;
103   }
104 
isConvertibleTo(ast_type_traits::ASTNodeKind Kind,unsigned * Specificity) const105   bool isConvertibleTo(ast_type_traits::ASTNodeKind Kind,
106                        unsigned *Specificity) const override {
107     return ArgKind(Matcher.getSupportedKind())
108         .isConvertibleTo(Kind, Specificity);
109   }
110 
111 private:
112   const DynTypedMatcher Matcher;
113 };
114 
115 class VariantMatcher::PolymorphicPayload : public VariantMatcher::Payload {
116 public:
PolymorphicPayload(std::vector<DynTypedMatcher> MatchersIn)117   PolymorphicPayload(std::vector<DynTypedMatcher> MatchersIn)
118       : Matchers(std::move(MatchersIn)) {}
119 
~PolymorphicPayload()120   ~PolymorphicPayload() override {}
121 
getSingleMatcher() const122   llvm::Optional<DynTypedMatcher> getSingleMatcher() const override {
123     if (Matchers.size() != 1)
124       return llvm::Optional<DynTypedMatcher>();
125     return Matchers[0];
126   }
127 
getTypeAsString() const128   std::string getTypeAsString() const override {
129     std::string Inner;
130     for (size_t i = 0, e = Matchers.size(); i != e; ++i) {
131       if (i != 0)
132         Inner += "|";
133       Inner += Matchers[i].getSupportedKind().asStringRef();
134     }
135     return (Twine("Matcher<") + Inner + ">").str();
136   }
137 
138   llvm::Optional<DynTypedMatcher>
getTypedMatcher(const MatcherOps & Ops) const139   getTypedMatcher(const MatcherOps &Ops) const override {
140     bool FoundIsExact = false;
141     const DynTypedMatcher *Found = nullptr;
142     int NumFound = 0;
143     for (size_t i = 0, e = Matchers.size(); i != e; ++i) {
144       bool IsExactMatch;
145       if (Ops.canConstructFrom(Matchers[i], IsExactMatch)) {
146         if (Found) {
147           if (FoundIsExact) {
148             assert(!IsExactMatch && "We should not have two exact matches.");
149             continue;
150           }
151         }
152         Found = &Matchers[i];
153         FoundIsExact = IsExactMatch;
154         ++NumFound;
155       }
156     }
157     // We only succeed if we found exactly one, or if we found an exact match.
158     if (Found && (FoundIsExact || NumFound == 1))
159       return *Found;
160     return llvm::None;
161   }
162 
isConvertibleTo(ast_type_traits::ASTNodeKind Kind,unsigned * Specificity) const163   bool isConvertibleTo(ast_type_traits::ASTNodeKind Kind,
164                        unsigned *Specificity) const override {
165     unsigned MaxSpecificity = 0;
166     for (const DynTypedMatcher &Matcher : Matchers) {
167       unsigned ThisSpecificity;
168       if (ArgKind(Matcher.getSupportedKind())
169               .isConvertibleTo(Kind, &ThisSpecificity)) {
170         MaxSpecificity = std::max(MaxSpecificity, ThisSpecificity);
171       }
172     }
173     if (Specificity)
174       *Specificity = MaxSpecificity;
175     return MaxSpecificity > 0;
176   }
177 
178   const std::vector<DynTypedMatcher> Matchers;
179 };
180 
181 class VariantMatcher::VariadicOpPayload : public VariantMatcher::Payload {
182 public:
VariadicOpPayload(DynTypedMatcher::VariadicOperator Op,std::vector<VariantMatcher> Args)183   VariadicOpPayload(DynTypedMatcher::VariadicOperator Op,
184                     std::vector<VariantMatcher> Args)
185       : Op(Op), Args(std::move(Args)) {}
186 
getSingleMatcher() const187   llvm::Optional<DynTypedMatcher> getSingleMatcher() const override {
188     return llvm::Optional<DynTypedMatcher>();
189   }
190 
getTypeAsString() const191   std::string getTypeAsString() const override {
192     std::string Inner;
193     for (size_t i = 0, e = Args.size(); i != e; ++i) {
194       if (i != 0)
195         Inner += "&";
196       Inner += Args[i].getTypeAsString();
197     }
198     return Inner;
199   }
200 
201   llvm::Optional<DynTypedMatcher>
getTypedMatcher(const MatcherOps & Ops) const202   getTypedMatcher(const MatcherOps &Ops) const override {
203     return Ops.constructVariadicOperator(Op, Args);
204   }
205 
isConvertibleTo(ast_type_traits::ASTNodeKind Kind,unsigned * Specificity) const206   bool isConvertibleTo(ast_type_traits::ASTNodeKind Kind,
207                        unsigned *Specificity) const override {
208     for (const VariantMatcher &Matcher : Args) {
209       if (!Matcher.isConvertibleTo(Kind, Specificity))
210         return false;
211     }
212     return true;
213   }
214 
215 private:
216   const DynTypedMatcher::VariadicOperator Op;
217   const std::vector<VariantMatcher> Args;
218 };
219 
VariantMatcher()220 VariantMatcher::VariantMatcher() {}
221 
SingleMatcher(const DynTypedMatcher & Matcher)222 VariantMatcher VariantMatcher::SingleMatcher(const DynTypedMatcher &Matcher) {
223   return VariantMatcher(std::make_shared<SinglePayload>(Matcher));
224 }
225 
226 VariantMatcher
PolymorphicMatcher(std::vector<DynTypedMatcher> Matchers)227 VariantMatcher::PolymorphicMatcher(std::vector<DynTypedMatcher> Matchers) {
228   return VariantMatcher(
229       std::make_shared<PolymorphicPayload>(std::move(Matchers)));
230 }
231 
VariadicOperatorMatcher(DynTypedMatcher::VariadicOperator Op,std::vector<VariantMatcher> Args)232 VariantMatcher VariantMatcher::VariadicOperatorMatcher(
233     DynTypedMatcher::VariadicOperator Op,
234     std::vector<VariantMatcher> Args) {
235   return VariantMatcher(
236       std::make_shared<VariadicOpPayload>(Op, std::move(Args)));
237 }
238 
getSingleMatcher() const239 llvm::Optional<DynTypedMatcher> VariantMatcher::getSingleMatcher() const {
240   return Value ? Value->getSingleMatcher() : llvm::Optional<DynTypedMatcher>();
241 }
242 
reset()243 void VariantMatcher::reset() { Value.reset(); }
244 
getTypeAsString() const245 std::string VariantMatcher::getTypeAsString() const {
246   if (Value) return Value->getTypeAsString();
247   return "<Nothing>";
248 }
249 
VariantValue(const VariantValue & Other)250 VariantValue::VariantValue(const VariantValue &Other) : Type(VT_Nothing) {
251   *this = Other;
252 }
253 
VariantValue(bool Boolean)254 VariantValue::VariantValue(bool Boolean) : Type(VT_Nothing) {
255   setBoolean(Boolean);
256 }
257 
VariantValue(double Double)258 VariantValue::VariantValue(double Double) : Type(VT_Nothing) {
259   setDouble(Double);
260 }
261 
VariantValue(unsigned Unsigned)262 VariantValue::VariantValue(unsigned Unsigned) : Type(VT_Nothing) {
263   setUnsigned(Unsigned);
264 }
265 
VariantValue(StringRef String)266 VariantValue::VariantValue(StringRef String) : Type(VT_Nothing) {
267   setString(String);
268 }
269 
VariantValue(const VariantMatcher & Matcher)270 VariantValue::VariantValue(const VariantMatcher &Matcher) : Type(VT_Nothing) {
271   setMatcher(Matcher);
272 }
273 
~VariantValue()274 VariantValue::~VariantValue() { reset(); }
275 
operator =(const VariantValue & Other)276 VariantValue &VariantValue::operator=(const VariantValue &Other) {
277   if (this == &Other) return *this;
278   reset();
279   switch (Other.Type) {
280   case VT_Boolean:
281     setBoolean(Other.getBoolean());
282     break;
283   case VT_Double:
284     setDouble(Other.getDouble());
285     break;
286   case VT_Unsigned:
287     setUnsigned(Other.getUnsigned());
288     break;
289   case VT_String:
290     setString(Other.getString());
291     break;
292   case VT_Matcher:
293     setMatcher(Other.getMatcher());
294     break;
295   case VT_Nothing:
296     Type = VT_Nothing;
297     break;
298   }
299   return *this;
300 }
301 
reset()302 void VariantValue::reset() {
303   switch (Type) {
304   case VT_String:
305     delete Value.String;
306     break;
307   case VT_Matcher:
308     delete Value.Matcher;
309     break;
310   // Cases that do nothing.
311   case VT_Boolean:
312   case VT_Double:
313   case VT_Unsigned:
314   case VT_Nothing:
315     break;
316   }
317   Type = VT_Nothing;
318 }
319 
isBoolean() const320 bool VariantValue::isBoolean() const {
321   return Type == VT_Boolean;
322 }
323 
getBoolean() const324 bool VariantValue::getBoolean() const {
325   assert(isBoolean());
326   return Value.Boolean;
327 }
328 
setBoolean(bool NewValue)329 void VariantValue::setBoolean(bool NewValue) {
330   reset();
331   Type = VT_Boolean;
332   Value.Boolean = NewValue;
333 }
334 
isDouble() const335 bool VariantValue::isDouble() const {
336   return Type == VT_Double;
337 }
338 
getDouble() const339 double VariantValue::getDouble() const {
340   assert(isDouble());
341   return Value.Double;
342 }
343 
setDouble(double NewValue)344 void VariantValue::setDouble(double NewValue) {
345   reset();
346   Type = VT_Double;
347   Value.Double = NewValue;
348 }
349 
isUnsigned() const350 bool VariantValue::isUnsigned() const {
351   return Type == VT_Unsigned;
352 }
353 
getUnsigned() const354 unsigned VariantValue::getUnsigned() const {
355   assert(isUnsigned());
356   return Value.Unsigned;
357 }
358 
setUnsigned(unsigned NewValue)359 void VariantValue::setUnsigned(unsigned NewValue) {
360   reset();
361   Type = VT_Unsigned;
362   Value.Unsigned = NewValue;
363 }
364 
isString() const365 bool VariantValue::isString() const {
366   return Type == VT_String;
367 }
368 
getString() const369 const std::string &VariantValue::getString() const {
370   assert(isString());
371   return *Value.String;
372 }
373 
setString(StringRef NewValue)374 void VariantValue::setString(StringRef NewValue) {
375   reset();
376   Type = VT_String;
377   Value.String = new std::string(NewValue);
378 }
379 
isMatcher() const380 bool VariantValue::isMatcher() const {
381   return Type == VT_Matcher;
382 }
383 
getMatcher() const384 const VariantMatcher &VariantValue::getMatcher() const {
385   assert(isMatcher());
386   return *Value.Matcher;
387 }
388 
setMatcher(const VariantMatcher & NewValue)389 void VariantValue::setMatcher(const VariantMatcher &NewValue) {
390   reset();
391   Type = VT_Matcher;
392   Value.Matcher = new VariantMatcher(NewValue);
393 }
394 
isConvertibleTo(ArgKind Kind,unsigned * Specificity) const395 bool VariantValue::isConvertibleTo(ArgKind Kind, unsigned *Specificity) const {
396   switch (Kind.getArgKind()) {
397   case ArgKind::AK_Boolean:
398     if (!isBoolean())
399       return false;
400     *Specificity = 1;
401     return true;
402 
403   case ArgKind::AK_Double:
404     if (!isDouble())
405       return false;
406     *Specificity = 1;
407     return true;
408 
409   case ArgKind::AK_Unsigned:
410     if (!isUnsigned())
411       return false;
412     *Specificity = 1;
413     return true;
414 
415   case ArgKind::AK_String:
416     if (!isString())
417       return false;
418     *Specificity = 1;
419     return true;
420 
421   case ArgKind::AK_Matcher:
422     if (!isMatcher())
423       return false;
424     return getMatcher().isConvertibleTo(Kind.getMatcherKind(), Specificity);
425   }
426   llvm_unreachable("Invalid Type");
427 }
428 
isConvertibleTo(ArrayRef<ArgKind> Kinds,unsigned * Specificity) const429 bool VariantValue::isConvertibleTo(ArrayRef<ArgKind> Kinds,
430                                    unsigned *Specificity) const {
431   unsigned MaxSpecificity = 0;
432   for (const ArgKind& Kind : Kinds) {
433     unsigned ThisSpecificity;
434     if (!isConvertibleTo(Kind, &ThisSpecificity))
435       continue;
436     MaxSpecificity = std::max(MaxSpecificity, ThisSpecificity);
437   }
438   if (Specificity && MaxSpecificity > 0) {
439     *Specificity = MaxSpecificity;
440   }
441   return MaxSpecificity > 0;
442 }
443 
getTypeAsString() const444 std::string VariantValue::getTypeAsString() const {
445   switch (Type) {
446   case VT_String: return "String";
447   case VT_Matcher: return getMatcher().getTypeAsString();
448   case VT_Boolean: return "Boolean";
449   case VT_Double: return "Double";
450   case VT_Unsigned: return "Unsigned";
451   case VT_Nothing: return "Nothing";
452   }
453   llvm_unreachable("Invalid Type");
454 }
455 
456 } // end namespace dynamic
457 } // end namespace ast_matchers
458 } // end namespace clang
459