Enum VmValue 

pub enum VmValue {
    Int(i64),
    Float(f64),
    String(Rc<str>),
    Bytes(Rc<Vec<u8>>),
    Bool(bool),
    Nil,
    List(Rc<Vec<VmValue>>),
    Dict(Rc<BTreeMap<String, VmValue>>),
    Closure(Rc<VmClosure>),
    BuiltinRef(Rc<str>),
    BuiltinRefId {
        id: BuiltinId,
        name: Rc<str>,
    },
    Duration(u64),
    EnumVariant {
        enum_name: Rc<str>,
        variant: Rc<str>,
        fields: Rc<Vec<VmValue>>,
    },
    StructInstance {
        layout: Rc<StructLayout>,
        fields: Rc<Vec<Option<VmValue>>>,
    },
    TaskHandle(String),
    Channel(VmChannelHandle),
    Atomic(VmAtomicHandle),
    McpClient(VmMcpClientHandle),
    Set(Rc<Vec<VmValue>>),
    Generator(VmGenerator),
    Range(VmRange),
    Iter(Rc<RefCell<VmIter>>),
    Pair(Rc<(VmValue, VmValue)>),
}

VM runtime value.

Rare compound payloads use shared pointers so cloning or moving common values does not pay for the largest enum alternatives. Unsafe layouts such as NaN boxing or tagged pointers are deliberately deferred until Harn has a stronger object/heap story.

Variants

Int(i64)

Float(f64)

String(Rc<str>)

Bytes(Rc<Vec<u8>>)

Bool(bool)

Nil

List(Rc<Vec<VmValue>>)

Dict(Rc<BTreeMap<String, VmValue>>)

Closure(Rc<VmClosure>)

BuiltinRef(Rc<str>)

Reference to a registered builtin function, used when a builtin name is referenced as a value (e.g. snake_dict.rekey(snake_to_camel)). The contained string is the builtin’s registered name.

BuiltinRefId

Compact builtin reference for callback positions. Carries the name for policy, diagnostics, and fallback if the ID cannot be used.

Fields

id: BuiltinId

name: Rc<str>

Duration(u64)

EnumVariant

Fields

enum_name: Rc<str>

variant: Rc<str>

fields: Rc<Vec<VmValue>>

StructInstance

Fields

layout: Rc<StructLayout>

fields: Rc<Vec<Option<VmValue>>>

TaskHandle(String)

Channel(VmChannelHandle)

Atomic(VmAtomicHandle)

McpClient(VmMcpClientHandle)

Set(Rc<Vec<VmValue>>)

Generator(VmGenerator)

Range(VmRange)

Iter(Rc<RefCell<VmIter>>)

Lazy iterator handle. Single-pass, fused. See crate::vm::iter::VmIter.

Pair(Rc<(VmValue, VmValue)>)

Two-element pair value. Produced by pair(a, b), yielded by the Dict iterator source, and (later) by zip / enumerate combinators. Accessed via .first / .second, and destructurable in for (a, b) in ... loops.

Implementations

impl VmValue

pub fn enum_variant( enum_name: impl Into<Rc<str>>, variant: impl Into<Rc<str>>, fields: Vec<VmValue>, ) -> Self

pub fn struct_instance( struct_name: impl Into<Rc<str>>, fields: BTreeMap<String, VmValue>, ) -> Self

pub fn is_truthy(&self) -> bool

pub fn type_name(&self) -> &'static str

pub fn struct_name(&self) -> Option<&str>

pub fn struct_field(&self, field_name: &str) -> Option<&VmValue>

pub fn struct_fields_map(&self) -> Option<BTreeMap<String, VmValue>>

pub fn struct_instance_from_map( struct_name: impl Into<String>, fields: BTreeMap<String, VmValue>, ) -> Self

pub fn struct_instance_with_layout( struct_name: impl Into<String>, field_names: Vec<String>, field_values: BTreeMap<String, VmValue>, ) -> Self

pub fn struct_instance_with_property( &self, field_name: String, value: VmValue, ) -> Option<Self>

pub fn display(&self) -> String

pub fn write_display(&self, out: &mut String)

Writes the display representation directly into out, avoiding intermediate Vec allocations for collections.

pub fn as_dict(&self) -> Option<&BTreeMap<String, VmValue>>

Get the value as a BTreeMap reference, if it’s a Dict.

pub fn as_int(&self) -> Option<i64>

pub fn as_bytes(&self) -> Option<&[u8]>

Trait Implementations

impl Clone for VmValue

fn clone(&self) -> VmValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VmValue

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

Formats the value using the given formatter.