[TableGen] Consolidate constraint related concepts
Previously we have multiple mechanisms to specify op definition and match constraints:
TypeConstraint, AttributeConstraint, Type, Attr, mAttr, mAttrAnyOf, mPat. These variants
are not added because there are so many distinct cases we need to model; essentially,
they are all carrying a predicate. It's just an artifact of implementation.
It's quite confusing for users to grasp these variants and choose among them. Instead,
as the OpBase TableGen file, we need to strike to provide an unified mechanism. Each
dialect has the flexibility to define its own aliases if wanted.
This CL removes mAttr, mAttrAnyOf, mPat. A new base class, Constraint, is added. Now
TypeConstraint and AttrConstraint derive from Constraint. Type and Attr further derive
from TypeConstraint and AttrConstraint, respectively.
Comments are revised and examples are added to make it clear how to use constraints.
PiperOrigin-RevId: 240125076
2019-03-25 21:09:26 +08:00
|
|
|
//===- Constraint.cpp - Constraint 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.
|
|
|
|
// =============================================================================
|
|
|
|
//
|
|
|
|
// Constraint wrapper to simplify using TableGen Record for constraints.
|
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
|
|
|
#include "mlir/TableGen/Constraint.h"
|
|
|
|
#include "llvm/TableGen/Record.h"
|
|
|
|
|
|
|
|
using namespace mlir::tblgen;
|
|
|
|
|
|
|
|
Constraint::Constraint(const llvm::Record *record)
|
|
|
|
: def(record), kind(CK_Uncategorized) {
|
|
|
|
if (record->isSubClassOf("TypeConstraint")) {
|
|
|
|
kind = CK_Type;
|
|
|
|
} else if (record->isSubClassOf("AttrConstraint")) {
|
|
|
|
kind = CK_Attr;
|
2019-05-31 07:50:16 +08:00
|
|
|
} else if (record->isSubClassOf("RegionConstraint")) {
|
|
|
|
kind = CK_Region;
|
[TableGen] Consolidate constraint related concepts
Previously we have multiple mechanisms to specify op definition and match constraints:
TypeConstraint, AttributeConstraint, Type, Attr, mAttr, mAttrAnyOf, mPat. These variants
are not added because there are so many distinct cases we need to model; essentially,
they are all carrying a predicate. It's just an artifact of implementation.
It's quite confusing for users to grasp these variants and choose among them. Instead,
as the OpBase TableGen file, we need to strike to provide an unified mechanism. Each
dialect has the flexibility to define its own aliases if wanted.
This CL removes mAttr, mAttrAnyOf, mPat. A new base class, Constraint, is added. Now
TypeConstraint and AttrConstraint derive from Constraint. Type and Attr further derive
from TypeConstraint and AttrConstraint, respectively.
Comments are revised and examples are added to make it clear how to use constraints.
PiperOrigin-RevId: 240125076
2019-03-25 21:09:26 +08:00
|
|
|
} else {
|
|
|
|
assert(record->isSubClassOf("Constraint"));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
Constraint::Constraint(Kind kind, const llvm::Record *record)
|
|
|
|
: def(record), kind(kind) {}
|
|
|
|
|
|
|
|
Pred Constraint::getPredicate() const {
|
|
|
|
auto *val = def->getValue("predicate");
|
|
|
|
|
|
|
|
// If no predicate is specified, then return the null predicate (which
|
|
|
|
// corresponds to true).
|
|
|
|
if (!val)
|
|
|
|
return Pred();
|
|
|
|
|
|
|
|
const auto *pred = dyn_cast<llvm::DefInit>(val->getValue());
|
|
|
|
return Pred(pred);
|
|
|
|
}
|
|
|
|
|
|
|
|
std::string Constraint::getConditionTemplate() const {
|
|
|
|
return getPredicate().getCondition();
|
|
|
|
}
|
|
|
|
|
|
|
|
llvm::StringRef Constraint::getDescription() const {
|
|
|
|
auto doc = def->getValueAsString("description");
|
|
|
|
if (doc.empty())
|
|
|
|
return def->getName();
|
|
|
|
return doc;
|
|
|
|
}
|
|
|
|
|
|
|
|
AppliedConstraint::AppliedConstraint(Constraint &&c,
|
|
|
|
std::vector<std::string> &&e)
|
|
|
|
: constraint(c), entities(std::move(e)) {}
|