Struct TypePlanCore 

pub struct TypePlanCore { /* private fields */ }

Type-erased plan data that owns all allocations.

This is what Partial actually stores a reference to. The type safety comes from the TypePlan<T> wrapper at the API boundary.

Users should build plans using TypePlan::<T>::build() which provides type safety.

Implementations

impl TypePlanCore

pub unsafe fn from_shape(shape: &'static Shape) -> Result<Arc<Self>, AllocError>

Build a TypePlanCore directly from a shape, with process-global caching.

Under std, one plan is cached per unique shape (&'static Shape) for the lifetime of the process. In no_std, this builds a fresh plan each call.

Safety

The caller must ensure that the shape is valid and corresponds to a real type. Using an incorrect or maliciously crafted shape can lead to undefined behavior when materializing values.

pub fn root(&self) -> &TypePlanNode

Get the root node.

pub fn root_id(&self) -> NodeId

Get the root node index.

pub fn node(&self, idx: NodeId) -> &TypePlanNode

Get a node by its index.

pub fn field(&self, idx: Idx<FieldPlan>) -> &FieldPlan

Get a field by its index.

pub fn fields(&self, range: SliceRange<FieldPlan>) -> &[FieldPlan]

Get a slice of fields from a range.

pub fn variant(&self, idx: Idx<VariantPlanMeta>) -> &VariantPlanMeta

Get a variant by its index.

pub fn variants(&self, range: SliceRange<VariantPlanMeta>) -> &[VariantPlanMeta]

Get a slice of variants from a range.

pub fn validators( &self, range: SliceRange<PrecomputedValidator>, ) -> &[PrecomputedValidator]

Get a slice of validators from a range.

pub fn struct_field_node( &self, parent: &TypePlanNode, idx: usize, ) -> Option<&TypePlanNode>

Get the child node for a struct field by index. Follows BackRef nodes for recursive types.

pub fn enum_variant_field_node( &self, parent: &TypePlanNode, variant_idx: usize, field_idx: usize, ) -> Option<&TypePlanNode>

Get the child node for an enum variant’s field. Follows BackRef nodes for recursive types.

pub fn list_item_node(&self, parent: &TypePlanNode) -> Option<&TypePlanNode>

Get the child node for list/array items.

pub fn set_item_node(&self, parent: &TypePlanNode) -> Option<&TypePlanNode>

Get the child node for set items.

pub fn map_key_node(&self, parent: &TypePlanNode) -> Option<&TypePlanNode>

Get the child node for map keys.

pub fn map_value_node(&self, parent: &TypePlanNode) -> Option<&TypePlanNode>

Get the child node for map values.

pub fn option_inner_node(&self, parent: &TypePlanNode) -> Option<&TypePlanNode>

Get the child node for Option inner type.

pub fn result_ok_node(&self, parent: &TypePlanNode) -> Option<&TypePlanNode>

Get the child node for Result Ok type.

pub fn result_err_node(&self, parent: &TypePlanNode) -> Option<&TypePlanNode>

Get the child node for Result Err type.

pub fn pointer_pointee_node( &self, parent: &TypePlanNode, ) -> Option<&TypePlanNode>

Get the child node for pointer pointee.

pub fn inner_node(&self, parent: &TypePlanNode) -> Option<&TypePlanNode>

Get the child node for shape.inner navigation (used by begin_inner).

pub fn resolve_backref<'a>(&'a self, node: &'a TypePlanNode) -> &'a TypePlanNode

Resolve a BackRef to get the actual node it points to.

pub fn as_struct_plan<'a>( &'a self, node: &'a TypePlanNode, ) -> Option<&'a StructPlan>

Get the StructPlan if a node is a struct type. Follows BackRef nodes for recursive types.

pub fn as_enum_plan<'a>( &'a self, node: &'a TypePlanNode, ) -> Option<&'a EnumPlan>

Get the EnumPlan if a node is an enum type. Follows BackRef nodes for recursive types.

pub fn resolve_backref_id(&self, node_id: NodeId) -> &TypePlanNode

Resolve a BackRef (by node ID) to get the actual node it points to.

pub fn struct_plan_by_id(&self, node_id: NodeId) -> Option<&StructPlan>

Get the StructPlan for a node ID, if it’s a struct type. Follows BackRef nodes for recursive types.

pub fn enum_plan_by_id(&self, node_id: NodeId) -> Option<&EnumPlan>

Get the EnumPlan for a node ID, if it’s an enum type. Follows BackRef nodes for recursive types.

pub fn struct_field_node_id( &self, parent_id: NodeId, idx: usize, ) -> Option<NodeId>

Get the child node ID for a struct field by index. Follows BackRef nodes for recursive types.

pub fn enum_variant_field_node_id( &self, parent_id: NodeId, variant_idx: usize, field_idx: usize, ) -> Option<NodeId>

Get the child node ID for an enum variant’s field. Follows BackRef nodes for recursive types.

pub fn list_item_node_id(&self, parent_id: NodeId) -> Option<NodeId>

Get the child node ID for list/array items.

pub fn set_item_node_id(&self, parent_id: NodeId) -> Option<NodeId>

Get the child node ID for set items.

pub fn map_key_node_id(&self, parent_id: NodeId) -> Option<NodeId>

Get the child node ID for map keys.

pub fn map_value_node_id(&self, parent_id: NodeId) -> Option<NodeId>

Get the child node ID for map values.

pub fn option_some_node_id(&self, parent_id: NodeId) -> Option<NodeId>

Get the child node ID for Option’s Some variant.

pub fn result_nodes_id(&self, parent_id: NodeId) -> Option<(NodeId, NodeId)>

Get the child node IDs for Result’s Ok and Err variants.

pub fn pointer_inner_node_id(&self, parent_id: NodeId) -> Option<NodeId>

Get the child node ID for smart pointer inner type.

pub fn inner_node_id(&self, parent_id: NodeId) -> Option<NodeId>

Get the child node ID for transparent convert inner type.

Trait Implementations

impl Debug for TypePlanCore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.