Struct Chunk 

pub struct Chunk {
    pub code: Vec<u8>,
    pub constants: Vec<Constant>,
    pub lines: Vec<u32>,
    pub columns: Vec<u32>,
    pub source_file: Option<String>,
    pub functions: Vec<CompiledFunctionRef>,
    /* private fields */
}

A compiled chunk of bytecode.

Fields

code: Vec<u8>

The bytecode instructions.

constants: Vec<Constant>

Constant pool.

lines: Vec<u32>

Source line numbers for each instruction (for error reporting).

columns: Vec<u32>

Source column numbers for each instruction (for error reporting). Parallel to lines; 0 means no column info available.

source_file: Option<String>

Source file that this chunk was compiled from, when known. Set for chunks compiled from imported modules so runtime errors can report the correct file path for each frame instead of always pointing at the entry-point pipeline.

functions: Vec<CompiledFunctionRef>

Compiled function bodies (for closures).

Implementations

impl Chunk

pub fn new() -> Self

pub fn set_column(&mut self, col: u32)

Set the current column for subsequent emit calls.

pub fn add_constant(&mut self, constant: Constant) -> u16

Add a constant and return its index.

pub fn emit(&mut self, op: Op, line: u32)

Emit a single-byte instruction.

pub fn emit_u16(&mut self, op: Op, arg: u16, line: u32)

Emit an instruction with a u16 argument.

pub fn emit_u8(&mut self, op: Op, arg: u8, line: u32)

Emit an instruction with a u8 argument.

pub fn emit_call_builtin( &mut self, id: BuiltinId, name_idx: u16, arg_count: u8, line: u32, )

Emit a direct builtin call.

pub fn emit_call_builtin_spread( &mut self, id: BuiltinId, name_idx: u16, line: u32, )

Emit a direct builtin spread call.

pub fn emit_method_call(&mut self, name_idx: u16, arg_count: u8, line: u32)

Emit a method call: op + u16 (method name) + u8 (arg count).

pub fn emit_method_call_opt(&mut self, name_idx: u16, arg_count: u8, line: u32)

Emit an optional method call (?.) — returns nil if receiver is nil.

pub fn current_offset(&self) -> usize

Current code offset (for jump patching).

pub fn emit_jump(&mut self, op: Op, line: u32) -> usize

Emit a jump instruction with a placeholder offset. Returns the position to patch.

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

Patch a jump instruction at the given position to jump to the current offset.

pub fn patch_jump_to(&mut self, patch_pos: usize, target: usize)

Patch a jump to a specific target position.

pub fn read_u16(&self, pos: usize) -> u16

Read a u16 argument at the given position.

pub fn read_u64(&self, pos: usize) -> u64

Read a u64 argument at the given position.

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

Disassemble for debugging.

Trait Implementations

impl Clone for Chunk

fn clone(&self) -> Chunk

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Chunk

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

Formats the value using the given formatter.

impl Default for Chunk

fn default() -> Self

Returns the “default value” for a type.