Struct World 

pub struct World { /* private fields */ }

One typed variable scope per scenario, layered over the persistent global store.

Reads resolve scenario-first (scenario values shadow globals); saveAs: global writes through to the store.

Implementations

impl World

pub fn new(global: GlobalStore) -> Self

A world over the given global store, with an empty scenario scope.

pub fn get(&self, name: &str) -> Option<&Value>

Read a variable: the scenario scope shadows the global store.

pub fn set(&mut self, name: impl Into<String>, value: Value)

Set a variable in the scenario scope.

pub fn set_global(&mut self, name: impl Into<String>, value: Value)

Promote a value into the persistent global store (saveAs: global). The key joins the scenario’s write set (see World::promotions).

pub fn global(&self) -> &GlobalStore

The underlying global store.

pub fn promotions(&self) -> impl Iterator<Item = (&str, &Value)>

The scenario’s promotions — only the keys actually written via World::set_global, with their current values. This is what merges back into the shared store; the untouched snapshot remainder must not.

pub fn merged(&self) -> BTreeMap<&str, &Value>

The merged view (globals overlaid by scenario values), in key order — the seed set for an engine’s variable bridge.

Trait Implementations

impl Debug for World

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

Formats the value using the given formatter.

impl Default for World

fn default() -> World

Returns the “default value” for a type.