Struct Runtime 

pub struct Runtime(/* private fields */);

Scheme-rs core runtime

Practically, the runtime is the core entry point for running Scheme programs with scheme-rs. It initializes the garbage collector and JIT compiler tasks and creates a new library registry.

There is not much you can do with a Runtime beyond creating it and using it to run programs, however a lot of functions require it as an arguments, such as TopLevelEnvironment::new_repl.

You can also use the runtime to define libraries from Rust code.

Runtime is automatically reference counted, so if you have all of the procedures you need you can drop it without any issue.

Safety:

The runtime contains the only live references to the Cranelift Context and therefore modules and allocated functions in the form a Sender of compilation tasks.

When that sender’s ref count is zero, it will cause the receiver to fail and the compilation task will exit, allowing for a graceful shutdown.

However, this is dropping a lifetime. If we clone a procedure and drop the runtime from whence it was cleaved, we’re left with a dangling pointer.

In order to remedy this it is vitally important the closure has a back pointer to the runtime.

Implementations

impl Runtime

pub fn new() -> Self

Creates a new runtime. Also initializes the garbage collector and creates a default registry with the bridge functions populated.

pub fn run_program(&self, path: &Path) -> Result<Vec<Value>, Exception>

Run a program at the given location and return the values.

pub fn def_lib(&self, lib: &str) -> Result<(), Exception>

Define a library from Rust code. Useful if file system access is disabled.

Trait Implementations

impl Clone for Runtime

fn clone(&self) -> Runtime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Runtime

fn default() -> Self

Returns the “default value” for a type.

impl Trace for Runtime

unsafe fn visit_children(&self, visitor: &mut dyn FnMut(OpaqueGcPtr))

Safety

unsafe fn finalize(&mut self)

Safety