
A distinct attribute associates a referenced attribute with a unique identifier. Every call to its create function allocates a new distinct attribute instance. The address of the attribute instance temporarily serves as its unique identifier. Similar to the names of SSA values, the final unique identifiers are generated during pretty printing. Examples: #distinct = distinct[0]<42.0 : f32> #distinct1 = distinct[1]<42.0 : f32> #distinct2 = distinct[2]<array<i32: 10, 42>> This mechanism is meant to generate attributes with a unique identifier, which can be used to mark groups of operations that share a common properties such as if they are aliasing. The design of the distinct attribute ensures minimal memory footprint per distinct attribute since it only contains a reference to another attribute. All distinct attributes are stored outside of the storage uniquer in a thread local store that is part of the context. It uses one bump pointer allocator per thread to ensure distinct attributes can be created in-parallel. Reviewed By: rriddle, Dinistro, zero9178 Differential Revision: https://reviews.llvm.org/D153360
2.1 KiB
Builtin Dialect
The builtin dialect contains a core set of Attributes, Operations, and Types
that have wide applicability across a very large number of domains and
abstractions. Many of the components of this dialect are also instrumental in
the implementation of the core IR. As such, this dialect is implicitly loaded in
every MLIRContext
, and available directly to all users of MLIR.
Given the far-reaching nature of this dialect and the fact that MLIR is extensible by design, any potential additions are heavily scrutinized.
[TOC]
Attributes
[include "Dialects/BuiltinAttributes.md"]
Location Attributes
A subset of the builtin attribute values correspond to source locations, that may be attached to Operations.
[include "Dialects/BuiltinLocationAttributes.md"]
DistinctAttribute
A DistinctAttribute associates an attribute with a unique identifier.
As a result, multiple DistinctAttribute instances may point to the same
attribute. Every call to the create
function allocates a new
DistinctAttribute instance. The address of the attribute instance serves as a
temporary unique identifier. Similar to the names of SSA values, the final
unique identifiers are generated during pretty printing. This delayed
numbering ensures the printed identifiers are deterministic even if
multiple DistinctAttribute instances are created in-parallel.
Syntax:
distinct-id ::= integer-literal
distinct-attribute ::= `distinct` `[` distinct-id `]<` attribute `>`
Examples:
#distinct = distinct[0]<42.0 : f32>
#distinct1 = distinct[1]<42.0 : f32>
#distinct2 = distinct[2]<array<i32: 10, 42>>
This mechanism is meant to generate attributes with a unique identifier, which can be used to mark groups of operations that share a common property. For example, groups of aliasing memory operations may be marked using one DistinctAttribute instance per alias group.
Operations
[include "Dialects/BuiltinOps.md"]
Types
[include "Dialects/BuiltinTypes.md"]
Type Interfaces
[include "Dialects/BuiltinTypeInterfaces.md"]