rune/runtime/
runtime_context.rs

Help
1use core::fmt;
2
3use ::rust_alloc::sync::Arc;
4
5use crate as rune;
6use crate::alloc::prelude::*;
7use crate::hash;
8use crate::runtime::{ConstConstruct, ConstValue, InstAddress, Memory, Output, VmResult};
9use crate::Hash;
10
11/// A type-reduced function handler.
12pub(crate) type FunctionHandler =
13    dyn Fn(&mut dyn Memory, InstAddress, usize, Output) -> VmResult<()> + Send + Sync;
14
15/// Static run context visible to the virtual machine.
16///
17/// This contains:
18/// * Declared functions.
19/// * Declared instance functions.
20/// * Built-in type checks.
21#[derive(Default, TryClone)]
22pub struct RuntimeContext {
23    /// Registered native function handlers.
24    functions: hash::Map<Arc<FunctionHandler>>,
25    /// Named constant values
26    constants: hash::Map<ConstValue>,
27    /// Constant constructors.
28    construct: hash::Map<Arc<dyn ConstConstruct>>,
29}
30
31assert_impl!(RuntimeContext: Send + Sync);
32
33impl RuntimeContext {
34    pub(crate) fn new(
35        functions: hash::Map<Arc<FunctionHandler>>,
36        constants: hash::Map<ConstValue>,
37        construct: hash::Map<Arc<dyn ConstConstruct>>,
38    ) -> Self {
39        Self {
40            functions,
41            constants,
42            construct,
43        }
44    }
45
46    /// Lookup the given native function handler in the context.
47    #[inline]
48    pub fn function(&self, hash: &Hash) -> Option<&Arc<FunctionHandler>> {
49        self.functions.get(hash)
50    }
51
52    /// Read a constant value.
53    #[inline]
54    pub fn constant(&self, hash: &Hash) -> Option<&ConstValue> {
55        self.constants.get(hash)
56    }
57
58    /// Read a constant constructor.
59    #[inline]
60    pub(crate) fn construct(&self, hash: &Hash) -> Option<&dyn ConstConstruct> {
61        Some(&**self.construct.get(hash)?)
62    }
63}
64
65impl fmt::Debug for RuntimeContext {
66    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
67        write!(f, "RuntimeContext")
68    }
69}
70
71#[cfg(test)]
72static_assertions::assert_impl_all!(RuntimeContext: Send, Sync);
rune/runtime/runtime_context.rs

rune/runtime/
runtime_context.rs
