Struct MutableRuntimeTable 

pub struct MutableRuntimeTable<P> { /* private fields */ }

A mutable table keyed by arbitrary runtime values.

Unlike MutableTable, this table does not implement the kernel symbol-keyed table contract. It is the shared substrate for guest language hash/map/table values whose keys can be booleans, numbers, strings, symbols, or object identities. Writes require standard_mutate_capability; reads are always allowed.

Implementations

impl<P: RuntimeKeyPolicy> MutableRuntimeTable<P>

pub fn new(policy: P) -> Self

Creates an empty runtime-keyed table.

pub fn with_entries( cx: &mut Cx, policy: P, entries: Vec<(Value, Value)>, ) -> Result<Self>

Creates a runtime-keyed table seeded with entries.

Seeding is construction, not mutation, so it does not require the mutate capability. Later duplicate keys replace earlier entries.

pub fn policy(&self) -> &P

Returns the table’s key policy.

pub fn get(&self, cx: &mut Cx, key: &Value) -> Result<Option<Value>>

Reads a value using the configured key policy.

pub fn get_runtime_key(&self, key: &RuntimeKey) -> Result<Option<Value>>

Reads a value using an already-derived runtime key.

pub fn set(&self, cx: &mut Cx, key: Value, value: Value) -> Result<()>

Writes a value using the configured key policy.

pub fn set_runtime_key( &self, cx: &mut Cx, key: RuntimeKey, value: Value, ) -> Result<()>

Writes a value using an already-derived runtime key.

pub fn del(&self, cx: &mut Cx, key: &Value) -> Result<Option<Value>>

Deletes a value using the configured key policy.

pub fn del_runtime_key( &self, cx: &mut Cx, key: &RuntimeKey, ) -> Result<Option<Value>>

Deletes a value using an already-derived runtime key.

pub fn entries_in_key_order(&self) -> Result<Vec<(RuntimeKey, Value)>>

Returns entries in deterministic key order.

pub fn len(&self) -> Result<usize>

Returns the number of entries.

pub fn is_empty(&self) -> Result<bool>

Returns whether the table is empty.

pub fn clear(&self, cx: &mut Cx) -> Result<()>

Clears the table after checking mutation authority.

Trait Implementations

impl<P: RuntimeKeyPolicy + 'static> Object for MutableRuntimeTable<P>

fn display(&self, _cx: &mut Cx) -> Result<String>

Render the object as a human-readable display string.

fn as_any(&self) -> &dyn Any

Expose the object for Rust downcasting.

fn header(&self) -> &ObjectHeader

Identity and trust header for the object; defaults to the shared anonymous header.

fn op(&self, _key: &OpKey) -> Option<&dyn Op>

Resolve the operation registered under key, if any.

fn claims( &self, _cx: &mut Cx, _pattern: &ClaimPattern, _sink: &mut dyn ClaimSink, ) -> Result<(), Error>

Emit the object’s claims matching pattern into sink.

fn snapshot(&self, _cx: &mut Cx) -> Result<Option<Datum>, Error>

Optional content-addressable snapshot of the object’s state.

impl<P: RuntimeKeyPolicy + 'static> ObjectCompat for MutableRuntimeTable<P>

fn as_expr(&self, cx: &mut Cx) -> Result<Expr>

Expression form of the object; defaults to an opaque extension node.

fn truth(&self, _cx: &mut Cx) -> Result<bool>

Truthiness of the object; defaults to true.

fn class(&self, cx: &mut Cx) -> Result<Value, Error>

Class object this value belongs to; defaults to nil.

fn as_callable(&self) -> Option<&dyn Callable>

Callable view, if the object can be invoked.

fn as_class(&self) -> Option<&dyn Class>

Class view, if the object is a class.

fn as_shape(&self) -> Option<&dyn Shape>

Shape view, if the object is a shape.

fn as_object_encoder(&self) -> Option<&dyn ObjectEncode>

Object-encoder view, if the object encodes other objects.

fn as_read_constructor(&self) -> Option<&dyn ReadConstructor>

Read-constructor view, if the object decodes data forms.

fn as_number_domain(&self) -> Option<&(dyn NumberDomain + 'static)>

Number-domain view, if the object is a number domain.

fn as_number_value(&self) -> Option<&dyn NumberValue>

Number-value view, if the object is a domain number.

fn as_eval_fabric(&self) -> Option<&dyn EvalFabric>

Eval-fabric view, if the object is a distributed eval surface.

fn as_stream(&self) -> Option<&dyn Stream>

Stream view, if the object is a stream.

fn as_sequence(&self) -> Option<&dyn Sequence>

Sequence view, if the object is a sequence.

fn as_thunk(&self) -> Option<&dyn Thunk>

Thunk view, if the object is a deferred computation.

fn as_list(&self) -> Option<&(dyn ListValue + 'static)>

List view, if the object is a list value.

fn as_table_impl(&self) -> Option<&(dyn Table + 'static)>

Table-implementation view, if the object is a table.

fn as_dir(&self) -> Option<&(dyn Dir + 'static)>

Directory view, if the object is a directory.

fn publish_shape_satisfaction_claims( &self, _cx: &mut Cx, _shape: &Ref, ) -> Result<bool, Error>

Publish claims asserting that the object satisfies shape; returns whether any were published.

fn as_table(&self, cx: &mut Cx) -> Result<Value, Error>

Project the object into a table value; the default exposes its display.