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