//===- Pattern.cpp - Pattern wrapper class --------------------------------===// // // Copyright 2019 The MLIR Authors. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // ============================================================================= // // Pattern wrapper class to simplify using TableGen Record defining a MLIR // Pattern. // //===----------------------------------------------------------------------===// #include "mlir/TableGen/Pattern.h" #include "llvm/ADT/Twine.h" #include "llvm/Support/FormatVariadic.h" #include "llvm/TableGen/Error.h" #include "llvm/TableGen/Record.h" using namespace mlir; using llvm::formatv; using mlir::tblgen::Operator; bool tblgen::DagLeaf::isUnspecified() const { return dyn_cast_or_null(def); } bool tblgen::DagLeaf::isOperandMatcher() const { // Operand matchers specify a type constraint. return isSubClassOf("TypeConstraint"); } bool tblgen::DagLeaf::isAttrMatcher() const { // Attribute matchers specify an attribute constraint. return isSubClassOf("AttrConstraint"); } bool tblgen::DagLeaf::isNativeCodeCall() const { return isSubClassOf("NativeCodeCall"); } bool tblgen::DagLeaf::isConstantAttr() const { return isSubClassOf("ConstantAttr"); } bool tblgen::DagLeaf::isEnumAttrCase() const { return isSubClassOf("EnumAttrCaseInfo"); } tblgen::Constraint tblgen::DagLeaf::getAsConstraint() const { assert((isOperandMatcher() || isAttrMatcher()) && "the DAG leaf must be operand or attribute"); return Constraint(cast(def)->getDef()); } tblgen::ConstantAttr tblgen::DagLeaf::getAsConstantAttr() const { assert(isConstantAttr() && "the DAG leaf must be constant attribute"); return ConstantAttr(cast(def)); } tblgen::EnumAttrCase tblgen::DagLeaf::getAsEnumAttrCase() const { assert(isEnumAttrCase() && "the DAG leaf must be an enum attribute case"); return EnumAttrCase(cast(def)); } std::string tblgen::DagLeaf::getConditionTemplate() const { return getAsConstraint().getConditionTemplate(); } llvm::StringRef tblgen::DagLeaf::getNativeCodeTemplate() const { assert(isNativeCodeCall() && "the DAG leaf must be NativeCodeCall"); return cast(def)->getDef()->getValueAsString("expression"); } bool tblgen::DagLeaf::isSubClassOf(StringRef superclass) const { if (auto *defInit = dyn_cast_or_null(def)) return defInit->getDef()->isSubClassOf(superclass); return false; } bool tblgen::DagNode::isNativeCodeCall() const { if (auto *defInit = dyn_cast_or_null(node->getOperator())) return defInit->getDef()->isSubClassOf("NativeCodeCall"); return false; } bool tblgen::DagNode::isOperation() const { return !(isNativeCodeCall() || isReplaceWithValue()); } llvm::StringRef tblgen::DagNode::getNativeCodeTemplate() const { assert(isNativeCodeCall() && "the DAG leaf must be NativeCodeCall"); return cast(node->getOperator()) ->getDef() ->getValueAsString("expression"); } llvm::StringRef tblgen::DagNode::getSymbol() const { return node->getNameStr(); } Operator &tblgen::DagNode::getDialectOp(RecordOperatorMap *mapper) const { llvm::Record *opDef = cast(node->getOperator())->getDef(); auto it = mapper->find(opDef); if (it != mapper->end()) return *it->second; return *mapper->try_emplace(opDef, llvm::make_unique(opDef)) .first->second; } int tblgen::DagNode::getNumOps() const { int count = isReplaceWithValue() ? 0 : 1; for (int i = 0, e = getNumArgs(); i != e; ++i) { if (auto child = getArgAsNestedDag(i)) count += child.getNumOps(); } return count; } int tblgen::DagNode::getNumArgs() const { return node->getNumArgs(); } bool tblgen::DagNode::isNestedDagArg(unsigned index) const { return isa(node->getArg(index)); } tblgen::DagNode tblgen::DagNode::getArgAsNestedDag(unsigned index) const { return DagNode(dyn_cast_or_null(node->getArg(index))); } tblgen::DagLeaf tblgen::DagNode::getArgAsLeaf(unsigned index) const { assert(!isNestedDagArg(index)); return DagLeaf(node->getArg(index)); } StringRef tblgen::DagNode::getArgName(unsigned index) const { return node->getArgNameStr(index); } bool tblgen::DagNode::isReplaceWithValue() const { auto *dagOpDef = cast(node->getOperator())->getDef(); return dagOpDef->getName() == "replaceWithValue"; } tblgen::Pattern::Pattern(const llvm::Record *def, RecordOperatorMap *mapper) : def(*def), recordOpMap(mapper) { collectBoundSymbols(getSourcePattern(), srcBoundOps, /*isSrcPattern=*/true); for (int i = 0, e = getNumResultPatterns(); i < e; ++i) collectBoundSymbols(getResultPattern(i), resBoundOps, /*isSrcPattern=*/false); } tblgen::DagNode tblgen::Pattern::getSourcePattern() const { return tblgen::DagNode(def.getValueAsDag("sourcePattern")); } int tblgen::Pattern::getNumResultPatterns() const { auto *results = def.getValueAsListInit("resultPatterns"); return results->size(); } tblgen::DagNode tblgen::Pattern::getResultPattern(unsigned index) const { auto *results = def.getValueAsListInit("resultPatterns"); return tblgen::DagNode(cast(results->getElement(index))); } void tblgen::Pattern::ensureBoundInSourcePattern(llvm::StringRef name) const { if (srcBoundArguments.find(name) == srcBoundArguments.end() && srcBoundOps.find(name) == srcBoundOps.end()) PrintFatalError(def.getLoc(), Twine("referencing unbound variable '") + name + "'"); } llvm::StringMap & tblgen::Pattern::getSourcePatternBoundArgs() { return srcBoundArguments; } llvm::StringMap & tblgen::Pattern::getSourcePatternBoundOps() { return srcBoundOps; } llvm::StringMap & tblgen::Pattern::getResultPatternBoundOps() { return resBoundOps; } const tblgen::Operator &tblgen::Pattern::getSourceRootOp() { return getSourcePattern().getDialectOp(recordOpMap); } tblgen::Operator &tblgen::Pattern::getDialectOp(DagNode node) { return node.getDialectOp(recordOpMap); } std::vector tblgen::Pattern::getConstraints() const { auto *listInit = def.getValueAsListInit("constraints"); std::vector ret; ret.reserve(listInit->size()); for (auto it : *listInit) { auto *dagInit = dyn_cast(it); if (!dagInit) PrintFatalError(def.getLoc(), "all elemements in Pattern multi-entity " "constraints should be DAG nodes"); std::vector entities; entities.reserve(dagInit->arg_size()); for (auto *argName : dagInit->getArgNames()) entities.push_back(argName->getValue()); ret.emplace_back(cast(dagInit->getOperator())->getDef(), dagInit->getNameStr(), std::move(entities)); } return ret; } int tblgen::Pattern::getBenefit() const { // The initial benefit value is a heuristic with number of ops in the source // pattern. int initBenefit = getSourcePattern().getNumOps(); llvm::DagInit *delta = def.getValueAsDag("benefitDelta"); if (delta->getNumArgs() != 1 || !isa(delta->getArg(0))) { PrintFatalError(def.getLoc(), "The 'addBenefit' takes and only takes one integer value"); } return initBenefit + dyn_cast(delta->getArg(0))->getValue(); } std::vector tblgen::Pattern::getLocation() const { std::vector> result; result.reserve(def.getLoc().size()); for (auto loc : def.getLoc()) { unsigned buf = llvm::SrcMgr.FindBufferContainingLoc(loc); assert(buf && "invalid source location"); result.emplace_back( llvm::SrcMgr.getBufferInfo(buf).Buffer->getBufferIdentifier(), llvm::SrcMgr.getLineAndColumn(loc, buf).first); } return result; } void tblgen::Pattern::collectBoundSymbols(DagNode tree, SymbolOperatorMap &symOpMap, bool isSrcPattern) { auto treeName = tree.getSymbol(); if (!tree.isOperation()) { if (!treeName.empty()) { PrintFatalError( def.getLoc(), formatv("binding symbol '{0}' to non-operation unsupported right now", treeName)); } return; } auto &op = getDialectOp(tree); auto numOpArgs = op.getNumArgs(); auto numTreeArgs = tree.getNumArgs(); if (numOpArgs != numTreeArgs) { PrintFatalError(def.getLoc(), formatv("op '{0}' argument number mismatch: " "{1} in pattern vs. {2} in definition", op.getOperationName(), numTreeArgs, numOpArgs)); } // The name attached to the DAG node's operator is for representing the // results generated from this op. It should be remembered as bound results. if (!treeName.empty()) symOpMap.try_emplace(treeName, &op); for (int i = 0; i != numTreeArgs; ++i) { if (auto treeArg = tree.getArgAsNestedDag(i)) { // This DAG node argument is a DAG node itself. Go inside recursively. collectBoundSymbols(treeArg, symOpMap, isSrcPattern); } else if (isSrcPattern) { // We can only bind symbols to op arguments in source pattern. Those // symbols are referenced in result patterns. auto treeArgName = tree.getArgName(i); if (!treeArgName.empty()) srcBoundArguments.try_emplace(treeArgName, op.getArg(i)); } } }