Files
clang-p2996/mlir/lib/Dialect/IRDL/IRDLVerifiers.cpp
Daniil Dudkin d4bde6968e [mlir][irdl] Introduce a way to define regions
This patch introduces new operations:
`irdl.region` and `irdl.regions`.
The former lets us to specify characteristics of a region,
such as the arguments for the entry block and the number of blocks.
The latter accepts all results of the former operations
to define the set of the regions for the operation.

Example:

```
    irdl.dialect @example {
      irdl.operation @op_with_regions {
          %r0 = irdl.region
          %r1 = irdl.region()
          %v0 = irdl.is i32
          %v1 = irdl.is i64
          %r2 = irdl.region(%v0, %v1)
          %r3 = irdl.region with size 3

          irdl.regions(%r0, %r1, %r2, %r3)
      }
    }
```

The above snippet demonstrates an operation named `@op_with_regions`,
which is constrained to have four regions.

* Region `%r0` doesn't have any constraints on the arguments or the number of blocks.
* Region `%r1` should have an empty set of arguments.
* Region `%r2` should have two arguments of types `i32` and `i64`.
* Region `%r3` should contain exactly three blocks.

In the future the block count constraint may be expanded to support range of possible number of blocks.

Reviewed By: math-fehr, Mogball

Differential Revision: https://reviews.llvm.org/D155112
2023-08-23 17:55:10 +03:00

227 lines
7.9 KiB
C++

//===- IRDLVerifiers.cpp - IRDL verifiers ------------------------- C++ -*-===//
//
// This file is licensed under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
//
// Verifiers for objects declared by IRDL.
//
//===----------------------------------------------------------------------===//
#include "mlir/Dialect/IRDL/IRDLVerifiers.h"
#include "mlir/IR/Attributes.h"
#include "mlir/IR/Block.h"
#include "mlir/IR/BuiltinAttributes.h"
#include "mlir/IR/Diagnostics.h"
#include "mlir/IR/ExtensibleDialect.h"
#include "mlir/IR/Location.h"
#include "mlir/IR/Region.h"
#include "mlir/IR/Value.h"
#include "mlir/Support/LogicalResult.h"
#include "llvm/Support/FormatVariadic.h"
using namespace mlir;
using namespace mlir::irdl;
ConstraintVerifier::ConstraintVerifier(
ArrayRef<std::unique_ptr<Constraint>> constraints)
: constraints(constraints), assigned() {
assigned.resize(this->constraints.size());
}
LogicalResult
ConstraintVerifier::verify(function_ref<InFlightDiagnostic()> emitError,
Attribute attr, unsigned variable) {
assert(variable < constraints.size() && "invalid constraint variable");
// If the variable is already assigned, check that the attribute is the same.
if (assigned[variable].has_value()) {
if (attr == assigned[variable].value()) {
return success();
} else {
if (emitError)
return emitError() << "expected '" << assigned[variable].value()
<< "' but got '" << attr << "'";
return failure();
}
}
// Otherwise, check the constraint and assign the attribute to the variable.
LogicalResult result = constraints[variable]->verify(emitError, attr, *this);
if (succeeded(result))
assigned[variable] = attr;
return result;
}
LogicalResult IsConstraint::verify(function_ref<InFlightDiagnostic()> emitError,
Attribute attr,
ConstraintVerifier &context) const {
if (attr == expectedAttribute)
return success();
if (emitError)
return emitError() << "expected '" << expectedAttribute << "' but got '"
<< attr << "'";
return failure();
}
LogicalResult DynParametricAttrConstraint::verify(
function_ref<InFlightDiagnostic()> emitError, Attribute attr,
ConstraintVerifier &context) const {
// Check that the base is the expected one.
auto dynAttr = dyn_cast<DynamicAttr>(attr);
if (!dynAttr || dynAttr.getAttrDef() != attrDef) {
if (emitError) {
StringRef dialectName = attrDef->getDialect()->getNamespace();
StringRef attrName = attrDef->getName();
return emitError() << "expected base attribute '" << attrName << '.'
<< dialectName << "' but got '" << attr << "'";
}
return failure();
}
// Check that the parameters satisfy the constraints.
ArrayRef<Attribute> params = dynAttr.getParams();
if (params.size() != constraints.size()) {
if (emitError) {
StringRef dialectName = attrDef->getDialect()->getNamespace();
StringRef attrName = attrDef->getName();
emitError() << "attribute '" << dialectName << "." << attrName
<< "' expects " << params.size() << " parameters but got "
<< constraints.size();
}
return failure();
}
for (size_t i = 0, s = params.size(); i < s; i++)
if (failed(context.verify(emitError, params[i], constraints[i])))
return failure();
return success();
}
LogicalResult DynParametricTypeConstraint::verify(
function_ref<InFlightDiagnostic()> emitError, Attribute attr,
ConstraintVerifier &context) const {
// Check that the base is a TypeAttr.
auto typeAttr = dyn_cast<TypeAttr>(attr);
if (!typeAttr) {
if (emitError)
return emitError() << "expected type, got attribute '" << attr;
return failure();
}
// Check that the type base is the expected one.
auto dynType = dyn_cast<DynamicType>(typeAttr.getValue());
if (!dynType || dynType.getTypeDef() != typeDef) {
if (emitError) {
StringRef dialectName = typeDef->getDialect()->getNamespace();
StringRef attrName = typeDef->getName();
return emitError() << "expected base type '" << dialectName << '.'
<< attrName << "' but got '" << attr << "'";
}
return failure();
}
// Check that the parameters satisfy the constraints.
ArrayRef<Attribute> params = dynType.getParams();
if (params.size() != constraints.size()) {
if (emitError) {
StringRef dialectName = typeDef->getDialect()->getNamespace();
StringRef attrName = typeDef->getName();
emitError() << "attribute '" << dialectName << "." << attrName
<< "' expects " << params.size() << " parameters but got "
<< constraints.size();
}
return failure();
}
for (size_t i = 0, s = params.size(); i < s; i++)
if (failed(context.verify(emitError, params[i], constraints[i])))
return failure();
return success();
}
LogicalResult
AnyOfConstraint::verify(function_ref<InFlightDiagnostic()> emitError,
Attribute attr, ConstraintVerifier &context) const {
for (unsigned constr : constraints) {
// We do not pass the `emitError` here, since we want to emit an error
// only if none of the constraints are satisfied.
if (succeeded(context.verify({}, attr, constr))) {
return success();
}
}
if (emitError)
return emitError() << "'" << attr << "' does not satisfy the constraint";
return failure();
}
LogicalResult
AllOfConstraint::verify(function_ref<InFlightDiagnostic()> emitError,
Attribute attr, ConstraintVerifier &context) const {
for (unsigned constr : constraints) {
if (failed(context.verify(emitError, attr, constr))) {
return failure();
}
}
return success();
}
LogicalResult
AnyAttributeConstraint::verify(function_ref<InFlightDiagnostic()> emitError,
Attribute attr,
ConstraintVerifier &context) const {
return success();
}
LogicalResult RegionConstraint::verify(mlir::Region &region,
ConstraintVerifier &constraintContext) {
const auto emitError = [parentOp = region.getParentOp()](mlir::Location loc) {
return [loc, parentOp] {
InFlightDiagnostic diag = mlir::emitError(loc);
// If we already have been given location of the parent operation, which
// might happen when the region location is passed, we do not want to
// produce the note on the same location
if (loc != parentOp->getLoc())
diag.attachNote(parentOp->getLoc()).append("see the operation");
return diag;
};
};
if (blockCount.has_value() && *blockCount != region.getBlocks().size()) {
return emitError(region.getLoc())()
<< "expected region " << region.getRegionNumber() << " to have "
<< *blockCount << " block(s) but got " << region.getBlocks().size();
}
if (argumentConstraints.has_value()) {
auto actualArgs = region.getArguments();
if (actualArgs.size() != argumentConstraints->size()) {
const mlir::Location firstArgLoc =
actualArgs.empty() ? region.getLoc() : actualArgs.front().getLoc();
return emitError(firstArgLoc)()
<< "expected region " << region.getRegionNumber() << " to have "
<< argumentConstraints->size() << " arguments but got "
<< actualArgs.size();
}
for (auto [arg, constraint] : llvm::zip(actualArgs, *argumentConstraints)) {
mlir::Attribute type = TypeAttr::get(arg.getType());
if (failed(constraintContext.verify(emitError(arg.getLoc()), type,
constraint))) {
return failure();
}
}
}
return success();
}