Skip to main content

Chunk

Struct Chunk 

Source
pub struct Chunk {
    pub code: Vec<Instruction>,
    pub constants: Vec<JsValue>,
    pub names: Vec<String>,
    pub locals: Vec<u32>,
    pub functions: Vec<FunctionTemplate>,
}
Expand description

A compiled chunk of bytecode with its constant pool.

Fields§

§code: Vec<Instruction>

The bytecode instructions.

§constants: Vec<JsValue>

Constant pool — holds literal values.

§names: Vec<String>

Deduplicated name table for variable/property names. Indexed by operand in GetVar/SetVar/etc. opcodes. Separate from constants to allow zero-copy &str access in the VM.

§locals: Vec<u32>

Local slots table. Each entry stores an index into names. Slot index is used by GetLocal/SetLocal/InitLocal opcodes.

§functions: Vec<FunctionTemplate>

Function templates for MakeClosure.

Implementations§

Source§

impl Chunk

Source

pub fn new() -> Self

Source

pub fn add_function(&mut self, template: FunctionTemplate) -> u32

Add a function template and return its index.

Source

pub fn emit(&mut self, instr: Instruction) -> usize

Emit an instruction and return its index.

Source

pub fn emit_op(&mut self, op: OpCode) -> usize

Emit a simple (no-operand) instruction.

Source

pub fn emit_with(&mut self, op: OpCode, operand: u32) -> usize

Emit an instruction with one operand.

Source

pub fn add_constant(&mut self, value: JsValue) -> u32

Add a constant to the pool and return its index.

Source

pub fn add_name(&mut self, s: &str) -> u32

Add a name to the deduplicated name table and return its index. Used for variable names, property names — allows zero-copy &str access in the VM.

Source

pub fn add_local(&mut self, name_idx: u32) -> u32

Add a local slot for a name index and return its slot index.

Source

pub fn get_local_name(&self, slot: u32) -> &str

Get a local slot’s name (zero-copy reference).

Source

pub fn get_name(&self, idx: u32) -> &str

Get a name by index (zero-copy reference).

Source

pub fn patch_jump(&mut self, jump_idx: usize)

Patch a jump instruction’s operand to point to the current code position.

Source

pub fn current_pos(&self) -> usize

Get the current code position (for jump targets).

Source

pub fn disassemble(&self, name: &str) -> String

Disassemble the chunk for debugging.

Trait Implementations§

Source§

impl Clone for Chunk

Source§

fn clone(&self) -> Chunk

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Chunk

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl Freeze for Chunk

§

impl !RefUnwindSafe for Chunk

§

impl !Send for Chunk

§

impl !Sync for Chunk

§

impl Unpin for Chunk

§

impl !UnwindSafe for Chunk

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.