Struct melior::dialect::ods::transform::ReplicateOperation

pub struct ReplicateOperation<'c> { /* private fields */ }

A replicate operation. Lists payload ops multiple times in the new handle.

Produces a new handle associated with a list of payload IR ops that is computed by repeating the list of payload IR ops associated with the operand handle as many times as the “pattern” handle has associated operations. For example, if pattern is associated with [op1, op2] and the operand handle is associated with [op3, op4, op5], the resulting handle will be associated with [op3, op4, op5, op3, op4, op5].

This transformation is useful to “align” the sizes of payload IR lists before a transformation that expects, e.g., identically-sized lists. For example, a transformation may be parameterized by same notional per-target size computed at runtime and supplied as another handle, the replication allows this size to be computed only once and used for every target instead of replicating the computation itself.

Note that it is undesirable to pass a handle with duplicate operations to an operation that consumes the handle. Handle consumption often indicates that the associated payload IR ops are destroyed, so having the same op listed more than once will lead to double-free. Single-operand MergeHandlesOp may be used to deduplicate the associated list of payload IR ops when necessary. Furthermore, a combination of ReplicateOp and MergeHandlesOp can be used to construct arbitrary lists with repetitions.

Implementations

impl<'c> ReplicateOperation<'c>

pub fn name() -> &'static str

Returns a name.

pub fn as_operation(&self) -> &Operation<'c>

Returns a generic operation.

pub fn builder( context: &'c Context, location: Location<'c> ) -> ReplicateOperationBuilder<'c, Unset, Unset, Unset>

Creates a builder.

pub fn replicated(&self) -> impl Iterator<Item = OperationResult<'c, '_>>

pub fn pattern(&self) -> Result<Value<'c, '_>, Error>

pub fn handles(&self) -> impl Iterator<Item = Value<'c, '_>>

Trait Implementations

impl<'c> From<ReplicateOperation<'c>> for Operation<'c>

fn from(operation: ReplicateOperation<'c>) -> Self

Converts to this type from the input type.

impl<'c> TryFrom<Operation<'c>> for ReplicateOperation<'c>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(operation: Operation<'c>) -> Result<Self, Self::Error>

Performs the conversion.