Enum RefMode 

#[repr(u8)]
pub enum RefMode {
    None = 0,
    NullOnly = 1,
    Tracking = 2,
}

Controls how reference and null flags are handled during serialization.

This enum combines nullable semantics and reference tracking into one parameter, enabling fine-grained control per type and per field:

• None = non-nullable, no ref tracking (primitives)
• NullOnly = nullable, no circular ref tracking
• Tracking = nullable, with circular ref tracking (Rc/Arc/Weak)

Variants

None = 0

Skip ref handling entirely. No ref/null flags are written/read. Used for non-nullable primitives or when caller handles ref externally.

NullOnly = 1

Only null check without reference tracking. Write: NullFlag (-3) for None, NotNullValueFlag (-1) for Some. Read: Read flag and return ForyDefault on null.

Tracking = 2

Full reference tracking with circular reference support. Write: Uses RefWriter which writes NullFlag, RefFlag+refId, or RefValueFlag. Read: Uses RefReader with full reference resolution.

Implementations

impl RefMode

pub const fn from_flags(nullable: bool, track_ref: bool) -> Self

Create RefMode from nullable and track_ref flags.

pub const fn has_ref_flag(self) -> bool

Check if this mode reads/writes ref flags.

pub const fn tracks_refs(self) -> bool

Check if this mode tracks circular references.

pub const fn is_nullable(self) -> bool

Check if this mode handles nullable values.

Trait Implementations

impl Clone for RefMode

fn clone(&self) -> RefMode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RefMode

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

Formats the value using the given formatter.

impl Default for RefMode

fn default() -> RefMode

Returns the “default value” for a type.

impl PartialEq for RefMode

fn eq(&self, other: &RefMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for RefMode

impl Eq for RefMode

impl StructuralPartialEq for RefMode