#include "Bindings/Python/IRModule.h"

Inheritance diagram for mlir::python::PyOperation:

Public Member Functions
	~PyOperation () override
PyOperation &	getOperation () override
	Each must provide access to the raw Operation.
void	detachFromParent ()
	Detaches the operation from its parent block and updates its state accordingly.
	operator MlirOperation () const
	Gets the backing operation.
MlirOperation	get () const
PyOperationRef	getRef ()
bool	isAttached ()
void	setAttached (const nanobind::object &parent=nanobind::object())
void	setDetached ()
void	checkValid () const
PyBlock	getBlock ()
	Gets the owning block or raises an exception if the operation has no owning block.
std::optional< PyOperationRef >	getParentOperation ()
	Gets the parent operation or raises an exception if the operation has no parent.
nanobind::object	getCapsule ()
	Gets a capsule wrapping the void* within the MlirOperation.
nanobind::object	createOpView ()
	Creates an OpView suitable for this operation.
void	erase ()
	Erases the underlying MlirOperation, removes its pointer from the parent context's live operations map, and sets the valid bit false.
void	setInvalid ()
	Invalidate the operation.
nanobind::object	clone (const nanobind::object &ip)
	Clones this operation.
	PyOperation (PyMlirContextRef contextRef, MlirOperation operation)
Public Member Functions inherited from mlir::python::PyOperationBase
virtual	~PyOperationBase ()=default
void	print (std::optional< int64_t > largeElementsLimit, std::optional< int64_t > largeResourceLimit, bool enableDebugInfo, bool prettyDebugInfo, bool printGenericOpForm, bool useLocalScope, bool useNameLocAsPrefix, bool assumeVerified, nanobind::object fileObject, bool binary, bool skipRegions)
	Implements the bound 'print' method and helps with others.
void	print (PyAsmState &state, nanobind::object fileObject, bool binary)
nanobind::object	getAsm (bool binary, std::optional< int64_t > largeElementsLimit, std::optional< int64_t > largeResourceLimit, bool enableDebugInfo, bool prettyDebugInfo, bool printGenericOpForm, bool useLocalScope, bool useNameLocAsPrefix, bool assumeVerified, bool skipRegions)
void	writeBytecode (const nanobind::object &fileObject, std::optional< int64_t > bytecodeVersion)
void	walk (std::function< MlirWalkResult(MlirOperation)> callback, MlirWalkOrder walkOrder)
void	moveAfter (PyOperationBase &other)
	Moves the operation before or after the other operation.
void	moveBefore (PyOperationBase &other)
bool	isBeforeInBlock (PyOperationBase &other)
	Given an operation 'other' that is within the same parent block, return whether the current operation is before 'other' in the operation list of the parent block.
bool	verify ()
	Verify the operation.
Public Member Functions inherited from mlir::python::BaseContextObject
	BaseContextObject (PyMlirContextRef ref)
PyMlirContextRef &	getContext ()
	Accesses the context reference.

Static Public Member Functions
static PyOperationRef	forOperation (PyMlirContextRef contextRef, MlirOperation operation, nanobind::object parentKeepAlive=nanobind::object())
	Returns a PyOperation for the given MlirOperation, optionally associating it with a parentKeepAlive.
static PyOperationRef	createDetached (PyMlirContextRef contextRef, MlirOperation operation, nanobind::object parentKeepAlive=nanobind::object())
	Creates a detached operation.
static PyOperationRef	parse (PyMlirContextRef contextRef, const std::string &sourceStr, const std::string &sourceName)
	Parses a source string (either text assembly or bytecode), creating a detached operation.
static nanobind::object	createFromCapsule (const nanobind::object &capsule)
	Creates a PyOperation from the MlirOperation wrapped by a capsule.
static nanobind::object	create (std::string_view name, std::optional< std::vector< PyType * > > results, llvm::ArrayRef< MlirValue > operands, std::optional< nanobind::dict > attributes, std::optional< std::vector< PyBlock * > > successors, int regions, PyLocation &location, const nanobind::object &ip, bool inferType)
	Creates an operation. See corresponding python docstring.

Friends
class	PyOperationBase
class	PySymbolTable

Detailed Description

Definition at line 605 of file IRModule.h.

Constructor & Destructor Documentation

◆ ~PyOperation()

PyOperation::~PyOperation ( )

override

Definition at line 1021 of file IRCore.cpp.

References erase(), isAttached(), and setInvalid().

◆ PyOperation()

PyOperation::PyOperation	(	PyMlirContextRef	contextRef,
		MlirOperation	operation )

Definition at line 1018 of file IRCore.cpp.

References mlir::python::BaseContextObject::BaseContextObject().

Referenced by getOperation().

Member Function Documentation

◆ checkValid()

void PyOperation::checkValid ( ) const

◆ clone()

nb::object PyOperation::clone ( const nanobind::object & ip )

Clones this operation.

Definition at line 1424 of file IRCore.cpp.

References createDetached(), createOpView(), mlir::python::BaseContextObject::getContext(), maybeInsertOperation(), and mlirOperationClone().

◆ create()

nb::object PyOperation::create	(	std::string_view	name,
		std::optional< std::vector< PyType * > >	results,
		llvm::ArrayRef< MlirValue >	operands,
		std::optional< nanobind::dict >	attributes,
		std::optional< std::vector< PyBlock * > >	successors,
		int	regions,
		PyLocation &	location,
		const nanobind::object &	ip,
		bool	inferType )

static

Creates an operation. See corresponding python docstring.

Definition at line 1309 of file IRCore.cpp.

References createDetached(), mlir::python::BaseContextObject::getContext(), mlir::python::PyObjectRef< T >::getObject(), maybeInsertOperation(), mlirAttributeGetContext(), mlirIdentifierGet(), mlirNamedAttributeGet(), mlirOperationCreate(), mlirOperationStateAddAttributes(), mlirOperationStateAddOperands(), mlirOperationStateAddOwnedRegions(), mlirOperationStateAddResults(), mlirOperationStateAddSuccessors(), mlirOperationStateGet(), mlirRegionCreate(), result, and toMlirStringRef().

Referenced by mlir::python::PyOpView::buildGeneric().

◆ createDetached()

PyOperationRef PyOperation::createDetached	(	PyMlirContextRef	contextRef,
		MlirOperation	operation,
		nanobind::object	parentKeepAlive = nanobind::object() )

static

Creates a detached operation.

The operation must not be associated with any existing live operation.

Definition at line 1070 of file IRCore.cpp.

Referenced by clone(), create(), and parse().

◆ createFromCapsule()

nb::object PyOperation::createFromCapsule ( const nanobind::object & capsule )

static

Creates a PyOperation from the MlirOperation wrapped by a capsule.

Ownership of the underlying MlirOperation is taken by calling this function.

Definition at line 1285 of file IRCore.cpp.

References mlir::python::PyMlirContext::forContext(), forOperation(), mlirOperationGetContext(), mlirPythonCapsuleToOperation(), and mlir::python::PyObjectRef< T >::releaseObject().

◆ createOpView()

nb::object PyOperation::createOpView ( )

Creates an OpView suitable for this operation.

Definition at line 1433 of file IRCore.cpp.

References checkValid(), mlir::python::PyOpView::constructDerived(), MlirStringRef::data, mlir::python::PyGlobals::get(), get(), getRef(), MlirStringRef::length, mlir::python::PyGlobals::lookupOperationClass(), mlirIdentifierStr(), and mlirOperationGetName().

Referenced by PyOpResultList::bindDerived(), clone(), and mlir::python::PySymbolTable::dunderGetItem().

◆ detachFromParent()

void mlir::python::PyOperation::detachFromParent ( )

inline

Detaches the operation from its parent block and updates its state accordingly.

Definition at line 630 of file IRModule.h.

References getOperation(), mlirOperationRemoveFromParent(), and setDetached().

◆ erase()

void PyOperation::erase ( )

Erases the underlying MlirOperation, removes its pointer from the parent context's live operations map, and sets the valid bit false.

Definition at line 1444 of file IRCore.cpp.

References checkValid(), mlirOperationDestroy(), and setInvalid().

Referenced by ~PyOperation().

◆ forOperation()

PyOperationRef PyOperation::forOperation	(	PyMlirContextRef	contextRef,
		MlirOperation	operation,
		nanobind::object	parentKeepAlive = nanobind::object() )