tvm
Public Member Functions | Public Attributes | Static Public Attributes | List of all members
tvm::script::printer::IRDocsifierNode Class Reference

IRDocsifier is the top-level interface in the IR->Doc process. More...

#include <ir_docsifier.h>

Inheritance diagram for tvm::script::printer::IRDocsifierNode:
Collaboration diagram for tvm::script::printer::IRDocsifierNode:

Public Member Functions

void VisitAttrs (tvm::AttrVisitor *v)
 
 TVM_DECLARE_FINAL_OBJECT_INFO (IRDocsifierNode, Object)
 
template<class TDoc >
TDoc AsDoc (const TracedObject< ObjectRef > &obj) const
 Transform the input object into TDoc. More...
 
ExprDoc AsExprDoc (const TracedObject< ObjectRef > &obj)
 Helper method to transform object into ExprDoc. More...
 
WithCtx WithDispatchToken (const String &token)
 Push a new dispatch token into the stack. More...
 
WithCtx WithFrame (const Frame &frame)
 Push a new frame the stack. More...
 
template<typename FrameType >
Optional< FrameType > GetFrame () const
 Get the top frame with type FrameType. More...
 
- Public Member Functions inherited from tvm::runtime::Object
uint32_t type_index () const
 
std::string GetTypeKey () const
 
size_t GetTypeKeyHash () const
 
template<typename TargetType >
bool IsInstance () const
 
bool unique () const
 
 Object ()
 
 Object (const Object &other)
 
 Object (Object &&other)
 
Objectoperator= (const Object &other)
 
Objectoperator= (Object &&other)
 

Public Attributes

VarTable vars
 The var table to use during the printing process. More...
 
Array< Frameframes
 The stack of frames. More...
 
Array< Stringdispatch_tokens
 The stack of dispatch tokens. More...
 
Map< String, Stringir_prefix
 This map connects IR dipatch token to the name of identifier. More...
 

Static Public Attributes

static constexpr const char * _type_key = "script.printer.IRDocsifier"
 
- Static Public Attributes inherited from tvm::runtime::Object
static constexpr const char * _type_key = "runtime.Object"
 
static constexpr bool _type_final = false
 
static constexpr uint32_t _type_child_slots = 0
 
static constexpr bool _type_child_slots_can_overflow = true
 
static constexpr bool _type_has_method_visit_attrs = true
 
static constexpr bool _type_has_method_sequal_reduce = false
 
static constexpr bool _type_has_method_shash_reduce = false
 
static constexpr uint32_t _type_index = TypeIndex::kDynamic
 

Additional Inherited Members

- Public Types inherited from tvm::runtime::Object
typedef void(* FDeleter) (Object *self)
 Object deleter. More...
 
using RefCounterType = std::atomic< int32_t >
 
- Static Public Member Functions inherited from tvm::runtime::Object
static std::string TypeIndex2Key (uint32_t tindex)
 Get the type key of the corresponding index from runtime. More...
 
static size_t TypeIndex2KeyHash (uint32_t tindex)
 Get the type key hash of the corresponding index from runtime. More...
 
static uint32_t TypeKey2Index (const std::string &key)
 Get the type index of the corresponding key from runtime. More...
 
static uint32_t _GetOrAllocRuntimeTypeIndex ()
 
static uint32_t RuntimeTypeIndex ()
 
- Protected Member Functions inherited from tvm::runtime::Object
void IncRef ()
 developer function, increases reference counter. More...
 
void DecRef ()
 developer function, decrease reference counter. More...
 
- Static Protected Member Functions inherited from tvm::runtime::Object
static uint32_t GetOrAllocRuntimeTypeIndex (const std::string &key, uint32_t static_tindex, uint32_t parent_tindex, uint32_t type_child_slots, bool type_child_slots_can_overflow)
 Get the type index using type key. More...
 
- Protected Attributes inherited from tvm::runtime::Object
uint32_t type_index_ {0}
 Type index(tag) that indicates the type of the object. More...
 
RefCounterType ref_counter_ {0}
 The internal reference counter. More...
 
FDeleter deleter_ = nullptr
 deleter of this object to enable customized allocation. If the deleter is nullptr, no deletion will be performed. The creator of the object must always set the deleter field properly. More...
 

Detailed Description

IRDocsifier is the top-level interface in the IR->Doc process.

It provides methods to convert IR node object to Doc, operate on Frame objects and change dispatch tokens.

Example usage:

TVM_STATIC_IR_FUNCTOR(IRDocsifier, vtable)
.set_dispatch([](TracedObject<tir::Var> obj, IRDocsifier p) { return IdDoc("x"); });
TracedObject<tir::Var> var = ...;
IRDocsifier p;
p->AsDoc(var); // returns an IdDoc("x")

Member Function Documentation

◆ AsDoc()

template<class TDoc >
TDoc tvm::script::printer::IRDocsifierNode::AsDoc ( const TracedObject< ObjectRef > &  obj) const
inline

Transform the input object into TDoc.

Parameters
objThe object to be transformed.
Returns
The Doc object.

◆ AsExprDoc()

ExprDoc tvm::script::printer::IRDocsifierNode::AsExprDoc ( const TracedObject< ObjectRef > &  obj)
inline

Helper method to transform object into ExprDoc.

Parameters
objThe object to be transformed.
Returns
The ExprDoc object.

◆ GetFrame()

template<typename FrameType >
Optional<FrameType> tvm::script::printer::IRDocsifierNode::GetFrame ( ) const
inline

Get the top frame with type FrameType.

Template Parameters
FrameTypeThe type of frame to get.

◆ TVM_DECLARE_FINAL_OBJECT_INFO()

tvm::script::printer::IRDocsifierNode::TVM_DECLARE_FINAL_OBJECT_INFO ( IRDocsifierNode  ,
Object   
)

◆ VisitAttrs()

void tvm::script::printer::IRDocsifierNode::VisitAttrs ( tvm::AttrVisitor v)
inline

◆ WithDispatchToken()

WithCtx tvm::script::printer::IRDocsifierNode::WithDispatchToken ( const String token)
inline

Push a new dispatch token into the stack.

The top dispatch token decides which dispatch table to use when printing Object. This method returns a RAII guard which pops the token when going out of the scope.

Parameters
tokenThe dispatch token to push.
Returns
A RAII guard to pop dispatch token when going out of scope.

◆ WithFrame()

WithCtx tvm::script::printer::IRDocsifierNode::WithFrame ( const Frame frame)
inline

Push a new frame the stack.

Frame contains the contextual information that's needed during printing, for example, variables in the scope. This method returns a RAII guard which pops the frame and call the cleanup method of frame when going out of the scope.

Parameters
frameThe frame to push.
Returns
A RAII guard to pop frame and call the exit method of frame when going out of scope

Member Data Documentation

◆ _type_key

constexpr const char* tvm::script::printer::IRDocsifierNode::_type_key = "script.printer.IRDocsifier"
static

◆ dispatch_tokens

Array<String> tvm::script::printer::IRDocsifierNode::dispatch_tokens

The stack of dispatch tokens.

The dispatch token on the top decides which dispatch function to use when converting IR node object to Doc.

◆ frames

Array<Frame> tvm::script::printer::IRDocsifierNode::frames

The stack of frames.

See also
FrameNode

◆ ir_prefix

Map<String, String> tvm::script::printer::IRDocsifierNode::ir_prefix

This map connects IR dipatch token to the name of identifier.

◆ vars

VarTable tvm::script::printer::IRDocsifierNode::vars

The var table to use during the printing process.

See also
VarTableNode

The documentation for this class was generated from the following file: