wasmi 2.0.0-beta.2

WebAssembly interpreter
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

use super::{Reset, StackPos};
use crate::{Error, engine::translator::func::LocalIdx};
use alloc::vec::Vec;
use core::iter;

/// Store the index of the first occurrence on the stack for every local variable.
#[derive(Debug, Default)]
pub struct LocalsHead {
    /// The index of the first occurrence of every local variable.
    first_operands: Vec<Option<StackPos>>,
}

impl Reset for LocalsHead {
    fn reset(&mut self) {
        self.first_operands.clear();
    }
}

impl LocalsHead {
    /// Slots `amount` of locals.
    ///
    /// # Errors
    ///
    /// If too many locals are registered.
    pub fn register(&mut self, amount: usize) -> Result<(), Error> {
        self.first_operands.extend(iter::repeat_n(None, amount));
        Ok(())
    }

    /// Converts `index` into a `usize` value.
    fn local_idx_to_index(index: LocalIdx) -> usize {
        let index = u32::from(index);
        let Ok(index) = usize::try_from(index) else {
            panic!("out of bounds `LocalIdx`: {index}")
        };
        index
    }

    /// Replaces the first operand for this local on the stack and returns the old one.
    ///
    /// # Panics
    ///
    /// If `index` is out of bounds.
    pub fn replace_first(
        &mut self,
        index: LocalIdx,
        first_operand: Option<StackPos>,
    ) -> Option<StackPos> {
        let index = Self::local_idx_to_index(index);
        let cell = &mut self.first_operands[index];
        match first_operand {
            Some(first_operand) => cell.replace(first_operand),
            None => cell.take(),
        }
    }
}