Struct Chunk 

pub struct Chunk {
    pub code: Vec<u8>,
    pub constants: Vec<VMValue>,
    pub lines: Vec<u32>,
    pub key_symbols: Vec<Option<Symbol>>,
    pub source_file: Option<String>,
}

A compiled bytecode chunk.

Contains the instruction stream, a constant pool for literal values and nested function chunks, and source line information for error reporting.

Fields

code: Vec<u8>

The raw bytecode instruction stream.

constants: Vec<VMValue>

Constant pool: literals, string keys, nested chunks.

lines: Vec<u32>

Source line number for each byte in code (1:1 mapping). Used for error messages. Line 0 means “unknown”.

key_symbols: Vec<Option<Symbol>>

Pre-resolved symbols for constant pool entries that are string keys.

Maps constant index -> interned Symbol. Populated at compile time so the VM can skip the intern() call on every GetAttr/HasAttr dispatch. Only entries used as attrset keys are populated.

source_file: Option<String>

The source file this chunk was compiled from (if known). Used for error diagnostics — not set for inline expressions.

Implementations

impl Chunk

pub fn new() -> Self

Create an empty chunk.

pub fn write_byte(&mut self, byte: u8, line: u32)

Write a single byte to the instruction stream.

pub fn write_op(&mut self, op: OpCode, line: u32)

Write an opcode to the instruction stream.

pub fn write_u16(&mut self, value: u16, line: u32)

Write a u16 operand as two little-endian bytes.

pub fn write_u32(&mut self, value: u32, line: u32)

Write a u32 operand as four little-endian bytes.

pub fn add_constant(&mut self, value: VMValue) -> Result<u16, CompileError>

Add a constant to the pool and return its index.

Returns an error if the pool exceeds u16::MAX entries.

pub fn add_key_constant( &mut self, value: VMValue, sym: Symbol, ) -> Result<u16, CompileError>

Add a constant string and its pre-interned symbol to the pool.

The symbol is stored in key_symbols so the VM can skip the intern() call when resolving attribute keys at runtime.

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

Read a u16 operand from the bytecode at the given offset.

Returns the value and the offset past the two bytes.

pub fn read_u32(&self, offset: usize) -> u32

Read a u32 operand from the bytecode at the given offset.

pub fn len(&self) -> usize

Return the current length of the bytecode stream.

pub fn is_empty(&self) -> bool

Whether the chunk contains no instructions.

pub fn patch_u16(&mut self, offset: usize, value: u16)

Patch a u16 value at the given offset in the bytecode stream.

Used for back-patching jump targets after the target offset is known.

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() -> Chunk

Returns the “default value” for a type.