1 //===- Operator.cpp - Operator class --------------------------------------===//
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 // Operator wrapper to simplify using TableGen Record defining a MLIR Op.
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #include "mlir/TableGen/Operator.h"
14 #include "mlir/TableGen/Predicate.h"
15 #include "mlir/TableGen/Trait.h"
16 #include "mlir/TableGen/Type.h"
17 #include "llvm/ADT/EquivalenceClasses.h"
18 #include "llvm/ADT/STLExtras.h"
19 #include "llvm/ADT/Sequence.h"
20 #include "llvm/ADT/SmallPtrSet.h"
21 #include "llvm/ADT/StringExtras.h"
22 #include "llvm/ADT/TypeSwitch.h"
23 #include "llvm/Support/Debug.h"
24 #include "llvm/Support/ErrorHandling.h"
25 #include "llvm/Support/FormatVariadic.h"
26 #include "llvm/TableGen/Error.h"
27 #include "llvm/TableGen/Record.h"
28 
29 #define DEBUG_TYPE "mlir-tblgen-operator"
30 
31 using namespace mlir;
32 using namespace mlir::tblgen;
33 
34 using llvm::DagInit;
35 using llvm::DefInit;
36 using llvm::Record;
37 
38 Operator::Operator(const llvm::Record &def)
39     : dialect(def.getValueAsDef("opDialect")), def(def) {
40   // The first `_` in the op's TableGen def name is treated as separating the
41   // dialect prefix and the op class name. The dialect prefix will be ignored if
42   // not empty. Otherwise, if def name starts with a `_`, the `_` is considered
43   // as part of the class name.
44   StringRef prefix;
45   std::tie(prefix, cppClassName) = def.getName().split('_');
46   if (prefix.empty()) {
47     // Class name with a leading underscore and without dialect prefix
48     cppClassName = def.getName();
49   } else if (cppClassName.empty()) {
50     // Class name without dialect prefix
51     cppClassName = prefix;
52   }
53 
54   cppNamespace = def.getValueAsString("cppNamespace");
55 
56   populateOpStructure();
57   assertInvariants();
58 }
59 
60 std::string Operator::getOperationName() const {
61   auto prefix = dialect.getName();
62   auto opName = def.getValueAsString("opName");
63   if (prefix.empty())
64     return std::string(opName);
65   return std::string(llvm::formatv("{0}.{1}", prefix, opName));
66 }
67 
68 std::string Operator::getAdaptorName() const {
69   return std::string(llvm::formatv("{0}Adaptor", getCppClassName()));
70 }
71 
72 void Operator::assertInvariants() const {
73   // Check that the name of arguments/results/regions/successors don't overlap.
74   DenseMap<StringRef, StringRef> existingNames;
75   auto checkName = [&](StringRef name, StringRef entity) {
76     if (name.empty())
77       return;
78     auto insertion = existingNames.insert({name, entity});
79     if (insertion.second)
80       return;
81     if (entity == insertion.first->second)
82       PrintFatalError(getLoc(), "op has a conflict with two " + entity +
83                                     " having the same name '" + name + "'");
84     PrintFatalError(getLoc(), "op has a conflict with " +
85                                   insertion.first->second + " and " + entity +
86                                   " both having an entry with the name '" +
87                                   name + "'");
88   };
89   // Check operands amongst themselves.
90   for (int i : llvm::seq<int>(0, getNumOperands()))
91     checkName(getOperand(i).name, "operands");
92 
93   // Check results amongst themselves and against operands.
94   for (int i : llvm::seq<int>(0, getNumResults()))
95     checkName(getResult(i).name, "results");
96 
97   // Check regions amongst themselves and against operands and results.
98   for (int i : llvm::seq<int>(0, getNumRegions()))
99     checkName(getRegion(i).name, "regions");
100 
101   // Check successors amongst themselves and against operands, results, and
102   // regions.
103   for (int i : llvm::seq<int>(0, getNumSuccessors()))
104     checkName(getSuccessor(i).name, "successors");
105 }
106 
107 StringRef Operator::getDialectName() const { return dialect.getName(); }
108 
109 StringRef Operator::getCppClassName() const { return cppClassName; }
110 
111 std::string Operator::getQualCppClassName() const {
112   if (cppNamespace.empty())
113     return std::string(cppClassName);
114   return std::string(llvm::formatv("{0}::{1}", cppNamespace, cppClassName));
115 }
116 
117 StringRef Operator::getCppNamespace() const { return cppNamespace; }
118 
119 int Operator::getNumResults() const {
120   DagInit *results = def.getValueAsDag("results");
121   return results->getNumArgs();
122 }
123 
124 StringRef Operator::getExtraClassDeclaration() const {
125   constexpr auto attr = "extraClassDeclaration";
126   if (def.isValueUnset(attr))
127     return {};
128   return def.getValueAsString(attr);
129 }
130 
131 StringRef Operator::getExtraClassDefinition() const {
132   constexpr auto attr = "extraClassDefinition";
133   if (def.isValueUnset(attr))
134     return {};
135   return def.getValueAsString(attr);
136 }
137 
138 const llvm::Record &Operator::getDef() const { return def; }
139 
140 bool Operator::skipDefaultBuilders() const {
141   return def.getValueAsBit("skipDefaultBuilders");
142 }
143 
144 auto Operator::result_begin() const -> const_value_iterator {
145   return results.begin();
146 }
147 
148 auto Operator::result_end() const -> const_value_iterator {
149   return results.end();
150 }
151 
152 auto Operator::getResults() const -> const_value_range {
153   return {result_begin(), result_end()};
154 }
155 
156 TypeConstraint Operator::getResultTypeConstraint(int index) const {
157   DagInit *results = def.getValueAsDag("results");
158   return TypeConstraint(cast<DefInit>(results->getArg(index)));
159 }
160 
161 StringRef Operator::getResultName(int index) const {
162   DagInit *results = def.getValueAsDag("results");
163   return results->getArgNameStr(index);
164 }
165 
166 auto Operator::getResultDecorators(int index) const -> var_decorator_range {
167   Record *result =
168       cast<DefInit>(def.getValueAsDag("results")->getArg(index))->getDef();
169   if (!result->isSubClassOf("OpVariable"))
170     return var_decorator_range(nullptr, nullptr);
171   return *result->getValueAsListInit("decorators");
172 }
173 
174 unsigned Operator::getNumVariableLengthResults() const {
175   return llvm::count_if(results, [](const NamedTypeConstraint &c) {
176     return c.constraint.isVariableLength();
177   });
178 }
179 
180 unsigned Operator::getNumVariableLengthOperands() const {
181   return llvm::count_if(operands, [](const NamedTypeConstraint &c) {
182     return c.constraint.isVariableLength();
183   });
184 }
185 
186 bool Operator::hasSingleVariadicArg() const {
187   return getNumArgs() == 1 && getArg(0).is<NamedTypeConstraint *>() &&
188          getOperand(0).isVariadic();
189 }
190 
191 Operator::arg_iterator Operator::arg_begin() const { return arguments.begin(); }
192 
193 Operator::arg_iterator Operator::arg_end() const { return arguments.end(); }
194 
195 Operator::arg_range Operator::getArgs() const {
196   return {arg_begin(), arg_end()};
197 }
198 
199 StringRef Operator::getArgName(int index) const {
200   DagInit *argumentValues = def.getValueAsDag("arguments");
201   return argumentValues->getArgNameStr(index);
202 }
203 
204 auto Operator::getArgDecorators(int index) const -> var_decorator_range {
205   Record *arg =
206       cast<DefInit>(def.getValueAsDag("arguments")->getArg(index))->getDef();
207   if (!arg->isSubClassOf("OpVariable"))
208     return var_decorator_range(nullptr, nullptr);
209   return *arg->getValueAsListInit("decorators");
210 }
211 
212 const Trait *Operator::getTrait(StringRef trait) const {
213   for (const auto &t : traits) {
214     if (const auto *traitDef = dyn_cast<NativeTrait>(&t)) {
215       if (traitDef->getFullyQualifiedTraitName() == trait)
216         return traitDef;
217     } else if (const auto *traitDef = dyn_cast<InternalTrait>(&t)) {
218       if (traitDef->getFullyQualifiedTraitName() == trait)
219         return traitDef;
220     } else if (const auto *traitDef = dyn_cast<InterfaceTrait>(&t)) {
221       if (traitDef->getFullyQualifiedTraitName() == trait)
222         return traitDef;
223     }
224   }
225   return nullptr;
226 }
227 
228 auto Operator::region_begin() const -> const_region_iterator {
229   return regions.begin();
230 }
231 auto Operator::region_end() const -> const_region_iterator {
232   return regions.end();
233 }
234 auto Operator::getRegions() const
235     -> llvm::iterator_range<const_region_iterator> {
236   return {region_begin(), region_end()};
237 }
238 
239 unsigned Operator::getNumRegions() const { return regions.size(); }
240 
241 const NamedRegion &Operator::getRegion(unsigned index) const {
242   return regions[index];
243 }
244 
245 unsigned Operator::getNumVariadicRegions() const {
246   return llvm::count_if(regions,
247                         [](const NamedRegion &c) { return c.isVariadic(); });
248 }
249 
250 auto Operator::successor_begin() const -> const_successor_iterator {
251   return successors.begin();
252 }
253 auto Operator::successor_end() const -> const_successor_iterator {
254   return successors.end();
255 }
256 auto Operator::getSuccessors() const
257     -> llvm::iterator_range<const_successor_iterator> {
258   return {successor_begin(), successor_end()};
259 }
260 
261 unsigned Operator::getNumSuccessors() const { return successors.size(); }
262 
263 const NamedSuccessor &Operator::getSuccessor(unsigned index) const {
264   return successors[index];
265 }
266 
267 unsigned Operator::getNumVariadicSuccessors() const {
268   return llvm::count_if(successors,
269                         [](const NamedSuccessor &c) { return c.isVariadic(); });
270 }
271 
272 auto Operator::trait_begin() const -> const_trait_iterator {
273   return traits.begin();
274 }
275 auto Operator::trait_end() const -> const_trait_iterator {
276   return traits.end();
277 }
278 auto Operator::getTraits() const -> llvm::iterator_range<const_trait_iterator> {
279   return {trait_begin(), trait_end()};
280 }
281 
282 auto Operator::attribute_begin() const -> attribute_iterator {
283   return attributes.begin();
284 }
285 auto Operator::attribute_end() const -> attribute_iterator {
286   return attributes.end();
287 }
288 auto Operator::getAttributes() const
289     -> llvm::iterator_range<attribute_iterator> {
290   return {attribute_begin(), attribute_end()};
291 }
292 
293 auto Operator::operand_begin() const -> const_value_iterator {
294   return operands.begin();
295 }
296 auto Operator::operand_end() const -> const_value_iterator {
297   return operands.end();
298 }
299 auto Operator::getOperands() const -> const_value_range {
300   return {operand_begin(), operand_end()};
301 }
302 
303 auto Operator::getArg(int index) const -> Argument { return arguments[index]; }
304 
305 // Mapping from result index to combined argument and result index. Arguments
306 // are indexed to match getArg index, while the result indexes are mapped to
307 // avoid overlap.
308 static int resultIndex(int i) { return -1 - i; }
309 
310 bool Operator::isVariadic() const {
311   return any_of(llvm::concat<const NamedTypeConstraint>(operands, results),
312                 [](const NamedTypeConstraint &op) { return op.isVariadic(); });
313 }
314 
315 void Operator::populateTypeInferenceInfo(
316     const llvm::StringMap<int> &argumentsAndResultsIndex) {
317   // If the type inference op interface is not registered, then do not attempt
318   // to determine if the result types an be inferred.
319   auto &recordKeeper = def.getRecords();
320   auto *inferTrait = recordKeeper.getDef(inferTypeOpInterface);
321   allResultsHaveKnownTypes = false;
322   if (!inferTrait)
323     return;
324 
325   // If there are no results, the skip this else the build method generated
326   // overlaps with another autogenerated builder.
327   if (getNumResults() == 0)
328     return;
329 
330   // Skip for ops with variadic operands/results.
331   // TODO: This can be relaxed.
332   if (isVariadic())
333     return;
334 
335   // Skip cases currently being custom generated.
336   // TODO: Remove special cases.
337   if (getTrait("::mlir::OpTrait::SameOperandsAndResultType"))
338     return;
339 
340   // We create equivalence classes of argument/result types where arguments
341   // and results are mapped into the same index space and indices corresponding
342   // to the same type are in the same equivalence class.
343   llvm::EquivalenceClasses<int> ecs;
344   resultTypeMapping.resize(getNumResults());
345   // Captures the argument whose type matches a given result type. Preference
346   // towards capturing operands first before attributes.
347   auto captureMapping = [&](int i) {
348     bool found = false;
349     ecs.insert(resultIndex(i));
350     auto mi = ecs.findLeader(resultIndex(i));
351     for (auto me = ecs.member_end(); mi != me; ++mi) {
352       if (*mi < 0) {
353         auto tc = getResultTypeConstraint(i);
354         if (tc.getBuilderCall().hasValue()) {
355           resultTypeMapping[i].emplace_back(tc);
356           found = true;
357         }
358         continue;
359       }
360 
361       if (getArg(*mi).is<NamedAttribute *>()) {
362         // TODO: Handle attributes.
363         continue;
364       }
365       resultTypeMapping[i].emplace_back(*mi);
366       found = true;
367     }
368     return found;
369   };
370 
371   for (const Trait &trait : traits) {
372     const llvm::Record &def = trait.getDef();
373     // If the infer type op interface was manually added, then treat it as
374     // intention that the op needs special handling.
375     // TODO: Reconsider whether to always generate, this is more conservative
376     // and keeps existing behavior so starting that way for now.
377     if (def.isSubClassOf(
378             llvm::formatv("{0}::Trait", inferTypeOpInterface).str()))
379       return;
380     if (const auto *traitDef = dyn_cast<InterfaceTrait>(&trait))
381       if (&traitDef->getDef() == inferTrait)
382         return;
383 
384     if (!def.isSubClassOf("AllTypesMatch"))
385       continue;
386 
387     auto values = def.getValueAsListOfStrings("values");
388     auto root = argumentsAndResultsIndex.lookup(values.front());
389     for (StringRef str : values)
390       ecs.unionSets(argumentsAndResultsIndex.lookup(str), root);
391   }
392 
393   // Verifies that all output types have a corresponding known input type
394   // and chooses matching operand or attribute (in that order) that
395   // matches it.
396   allResultsHaveKnownTypes =
397       all_of(llvm::seq<int>(0, getNumResults()), captureMapping);
398 
399   // If the types could be computed, then add type inference trait.
400   if (allResultsHaveKnownTypes)
401     traits.push_back(Trait::create(inferTrait->getDefInit()));
402 }
403 
404 void Operator::populateOpStructure() {
405   auto &recordKeeper = def.getRecords();
406   auto *typeConstraintClass = recordKeeper.getClass("TypeConstraint");
407   auto *attrClass = recordKeeper.getClass("Attr");
408   auto *derivedAttrClass = recordKeeper.getClass("DerivedAttr");
409   auto *opVarClass = recordKeeper.getClass("OpVariable");
410   numNativeAttributes = 0;
411 
412   DagInit *argumentValues = def.getValueAsDag("arguments");
413   unsigned numArgs = argumentValues->getNumArgs();
414 
415   // Mapping from name of to argument or result index. Arguments are indexed
416   // to match getArg index, while the results are negatively indexed.
417   llvm::StringMap<int> argumentsAndResultsIndex;
418 
419   // Handle operands and native attributes.
420   for (unsigned i = 0; i != numArgs; ++i) {
421     auto *arg = argumentValues->getArg(i);
422     auto givenName = argumentValues->getArgNameStr(i);
423     auto *argDefInit = dyn_cast<DefInit>(arg);
424     if (!argDefInit)
425       PrintFatalError(def.getLoc(),
426                       Twine("undefined type for argument #") + Twine(i));
427     Record *argDef = argDefInit->getDef();
428     if (argDef->isSubClassOf(opVarClass))
429       argDef = argDef->getValueAsDef("constraint");
430 
431     if (argDef->isSubClassOf(typeConstraintClass)) {
432       operands.push_back(
433           NamedTypeConstraint{givenName, TypeConstraint(argDef)});
434     } else if (argDef->isSubClassOf(attrClass)) {
435       if (givenName.empty())
436         PrintFatalError(argDef->getLoc(), "attributes must be named");
437       if (argDef->isSubClassOf(derivedAttrClass))
438         PrintFatalError(argDef->getLoc(),
439                         "derived attributes not allowed in argument list");
440       attributes.push_back({givenName, Attribute(argDef)});
441       ++numNativeAttributes;
442     } else {
443       PrintFatalError(def.getLoc(), "unexpected def type; only defs deriving "
444                                     "from TypeConstraint or Attr are allowed");
445     }
446     if (!givenName.empty())
447       argumentsAndResultsIndex[givenName] = i;
448   }
449 
450   // Handle derived attributes.
451   for (const auto &val : def.getValues()) {
452     if (auto *record = dyn_cast<llvm::RecordRecTy>(val.getType())) {
453       if (!record->isSubClassOf(attrClass))
454         continue;
455       if (!record->isSubClassOf(derivedAttrClass))
456         PrintFatalError(def.getLoc(),
457                         "unexpected Attr where only DerivedAttr is allowed");
458 
459       if (record->getClasses().size() != 1) {
460         PrintFatalError(
461             def.getLoc(),
462             "unsupported attribute modelling, only single class expected");
463       }
464       attributes.push_back(
465           {cast<llvm::StringInit>(val.getNameInit())->getValue(),
466            Attribute(cast<DefInit>(val.getValue()))});
467     }
468   }
469 
470   // Populate `arguments`. This must happen after we've finalized `operands` and
471   // `attributes` because we will put their elements' pointers in `arguments`.
472   // SmallVector may perform re-allocation under the hood when adding new
473   // elements.
474   int operandIndex = 0, attrIndex = 0;
475   for (unsigned i = 0; i != numArgs; ++i) {
476     Record *argDef = dyn_cast<DefInit>(argumentValues->getArg(i))->getDef();
477     if (argDef->isSubClassOf(opVarClass))
478       argDef = argDef->getValueAsDef("constraint");
479 
480     if (argDef->isSubClassOf(typeConstraintClass)) {
481       attrOrOperandMapping.push_back(
482           {OperandOrAttribute::Kind::Operand, operandIndex});
483       arguments.emplace_back(&operands[operandIndex++]);
484     } else {
485       assert(argDef->isSubClassOf(attrClass));
486       attrOrOperandMapping.push_back(
487           {OperandOrAttribute::Kind::Attribute, attrIndex});
488       arguments.emplace_back(&attributes[attrIndex++]);
489     }
490   }
491 
492   auto *resultsDag = def.getValueAsDag("results");
493   auto *outsOp = dyn_cast<DefInit>(resultsDag->getOperator());
494   if (!outsOp || outsOp->getDef()->getName() != "outs") {
495     PrintFatalError(def.getLoc(), "'results' must have 'outs' directive");
496   }
497 
498   // Handle results.
499   for (unsigned i = 0, e = resultsDag->getNumArgs(); i < e; ++i) {
500     auto name = resultsDag->getArgNameStr(i);
501     auto *resultInit = dyn_cast<DefInit>(resultsDag->getArg(i));
502     if (!resultInit) {
503       PrintFatalError(def.getLoc(),
504                       Twine("undefined type for result #") + Twine(i));
505     }
506     auto *resultDef = resultInit->getDef();
507     if (resultDef->isSubClassOf(opVarClass))
508       resultDef = resultDef->getValueAsDef("constraint");
509     results.push_back({name, TypeConstraint(resultDef)});
510     if (!name.empty())
511       argumentsAndResultsIndex[name] = resultIndex(i);
512 
513     // We currently only support VariadicOfVariadic operands.
514     if (results.back().constraint.isVariadicOfVariadic()) {
515       PrintFatalError(
516           def.getLoc(),
517           "'VariadicOfVariadic' results are currently not supported");
518     }
519   }
520 
521   // Handle successors
522   auto *successorsDag = def.getValueAsDag("successors");
523   auto *successorsOp = dyn_cast<DefInit>(successorsDag->getOperator());
524   if (!successorsOp || successorsOp->getDef()->getName() != "successor") {
525     PrintFatalError(def.getLoc(),
526                     "'successors' must have 'successor' directive");
527   }
528 
529   for (unsigned i = 0, e = successorsDag->getNumArgs(); i < e; ++i) {
530     auto name = successorsDag->getArgNameStr(i);
531     auto *successorInit = dyn_cast<DefInit>(successorsDag->getArg(i));
532     if (!successorInit) {
533       PrintFatalError(def.getLoc(),
534                       Twine("undefined kind for successor #") + Twine(i));
535     }
536     Successor successor(successorInit->getDef());
537 
538     // Only support variadic successors if it is the last one for now.
539     if (i != e - 1 && successor.isVariadic())
540       PrintFatalError(def.getLoc(), "only the last successor can be variadic");
541     successors.push_back({name, successor});
542   }
543 
544   // Create list of traits, skipping over duplicates: appending to lists in
545   // tablegen is easy, making them unique less so, so dedupe here.
546   if (auto *traitList = def.getValueAsListInit("traits")) {
547     // This is uniquing based on pointers of the trait.
548     SmallPtrSet<const llvm::Init *, 32> traitSet;
549     traits.reserve(traitSet.size());
550 
551     std::function<void(llvm::ListInit *)> insert;
552     insert = [&](llvm::ListInit *traitList) {
553       for (auto *traitInit : *traitList) {
554         auto *def = cast<DefInit>(traitInit)->getDef();
555         if (def->isSubClassOf("TraitList")) {
556           insert(def->getValueAsListInit("traits"));
557           continue;
558         }
559         // Keep traits in the same order while skipping over duplicates.
560         if (traitSet.insert(traitInit).second)
561           traits.push_back(Trait::create(traitInit));
562       }
563     };
564     insert(traitList);
565   }
566 
567   populateTypeInferenceInfo(argumentsAndResultsIndex);
568 
569   // Handle regions
570   auto *regionsDag = def.getValueAsDag("regions");
571   auto *regionsOp = dyn_cast<DefInit>(regionsDag->getOperator());
572   if (!regionsOp || regionsOp->getDef()->getName() != "region") {
573     PrintFatalError(def.getLoc(), "'regions' must have 'region' directive");
574   }
575 
576   for (unsigned i = 0, e = regionsDag->getNumArgs(); i < e; ++i) {
577     auto name = regionsDag->getArgNameStr(i);
578     auto *regionInit = dyn_cast<DefInit>(regionsDag->getArg(i));
579     if (!regionInit) {
580       PrintFatalError(def.getLoc(),
581                       Twine("undefined kind for region #") + Twine(i));
582     }
583     Region region(regionInit->getDef());
584     if (region.isVariadic()) {
585       // Only support variadic regions if it is the last one for now.
586       if (i != e - 1)
587         PrintFatalError(def.getLoc(), "only the last region can be variadic");
588       if (name.empty())
589         PrintFatalError(def.getLoc(), "variadic regions must be named");
590     }
591 
592     regions.push_back({name, region});
593   }
594 
595   // Populate the builders.
596   auto *builderList =
597       dyn_cast_or_null<llvm::ListInit>(def.getValueInit("builders"));
598   if (builderList && !builderList->empty()) {
599     for (llvm::Init *init : builderList->getValues())
600       builders.emplace_back(cast<llvm::DefInit>(init)->getDef(), def.getLoc());
601   } else if (skipDefaultBuilders()) {
602     PrintFatalError(
603         def.getLoc(),
604         "default builders are skipped and no custom builders provided");
605   }
606 
607   LLVM_DEBUG(print(llvm::dbgs()));
608 }
609 
610 auto Operator::getSameTypeAsResult(int index) const -> ArrayRef<ArgOrType> {
611   assert(allResultTypesKnown());
612   return resultTypeMapping[index];
613 }
614 
615 ArrayRef<SMLoc> Operator::getLoc() const { return def.getLoc(); }
616 
617 bool Operator::hasDescription() const {
618   return def.getValue("description") != nullptr;
619 }
620 
621 StringRef Operator::getDescription() const {
622   return def.getValueAsString("description");
623 }
624 
625 bool Operator::hasSummary() const { return def.getValue("summary") != nullptr; }
626 
627 StringRef Operator::getSummary() const {
628   return def.getValueAsString("summary");
629 }
630 
631 bool Operator::hasAssemblyFormat() const {
632   auto *valueInit = def.getValueInit("assemblyFormat");
633   return isa<llvm::StringInit>(valueInit);
634 }
635 
636 StringRef Operator::getAssemblyFormat() const {
637   return TypeSwitch<llvm::Init *, StringRef>(def.getValueInit("assemblyFormat"))
638       .Case<llvm::StringInit>([&](auto *init) { return init->getValue(); });
639 }
640 
641 void Operator::print(llvm::raw_ostream &os) const {
642   os << "op '" << getOperationName() << "'\n";
643   for (Argument arg : arguments) {
644     if (auto *attr = arg.dyn_cast<NamedAttribute *>())
645       os << "[attribute] " << attr->name << '\n';
646     else
647       os << "[operand] " << arg.get<NamedTypeConstraint *>()->name << '\n';
648   }
649 }
650 
651 auto Operator::VariableDecoratorIterator::unwrap(llvm::Init *init)
652     -> VariableDecorator {
653   return VariableDecorator(cast<llvm::DefInit>(init)->getDef());
654 }
655 
656 auto Operator::getArgToOperandOrAttribute(int index) const
657     -> OperandOrAttribute {
658   return attrOrOperandMapping[index];
659 }
660 
661 // Helper to return the names for accessor.
662 static SmallVector<std::string, 2>
663 getGetterOrSetterNames(bool isGetter, const Operator &op, StringRef name) {
664   Dialect::EmitPrefix prefixType = op.getDialect().getEmitAccessorPrefix();
665   std::string prefix;
666   if (prefixType != Dialect::EmitPrefix::Raw)
667     prefix = isGetter ? "get" : "set";
668 
669   SmallVector<std::string, 2> names;
670   bool rawToo = prefixType == Dialect::EmitPrefix::Both;
671 
672   // Whether to skip generating prefixed form for argument. This just does some
673   // basic checks.
674   //
675   // There are a little bit more invasive checks possible for cases where not
676   // all ops have the trait that would cause overlap. For many cases here,
677   // renaming would be better (e.g., we can only guard in limited manner against
678   // methods from traits and interfaces here, so avoiding these in op definition
679   // is safer).
680   auto skip = [&](StringRef newName) {
681     bool shouldSkip = newName == "getAttributeNames" ||
682                       newName == "getAttributes" || newName == "getOperation" ||
683                       newName == "getType";
684     if (newName == "getOperands") {
685       // To reduce noise, skip generating the prefixed form and the warning if
686       // $operands correspond to single variadic argument.
687       if (op.getNumOperands() == 1 && op.getNumVariableLengthOperands() == 1)
688         return true;
689       shouldSkip = true;
690     }
691     if (newName == "getRegions") {
692       if (op.getNumRegions() == 1 && op.getNumVariadicRegions() == 1)
693         return true;
694       shouldSkip = true;
695     }
696     if (!shouldSkip)
697       return false;
698 
699     // This note could be avoided where the final function generated would
700     // have been identical. But preferably in the op definition avoiding using
701     // the generic name and then getting a more specialize type is better.
702     PrintNote(op.getLoc(),
703               "Skipping generation of prefixed accessor `" + newName +
704                   "` as it overlaps with default one; generating raw form (`" +
705                   name + "`) still");
706     return true;
707   };
708 
709   if (!prefix.empty()) {
710     names.push_back(
711         prefix + convertToCamelFromSnakeCase(name, /*capitalizeFirst=*/true));
712     // Skip cases which would overlap with default ones for now.
713     if (skip(names.back())) {
714       rawToo = true;
715       names.clear();
716     } else if (rawToo) {
717       LLVM_DEBUG(llvm::errs() << "WITH_GETTER(\"" << op.getQualCppClassName()
718                               << "::" << name << "\")\n"
719                               << "WITH_GETTER(\"" << op.getQualCppClassName()
720                               << "Adaptor::" << name << "\")\n";);
721     }
722   }
723 
724   if (prefix.empty() || rawToo)
725     names.push_back(name.str());
726   return names;
727 }
728 
729 SmallVector<std::string, 2> Operator::getGetterNames(StringRef name) const {
730   return getGetterOrSetterNames(/*isGetter=*/true, *this, name);
731 }
732 
733 SmallVector<std::string, 2> Operator::getSetterNames(StringRef name) const {
734   return getGetterOrSetterNames(/*isGetter=*/false, *this, name);
735 }
736