luaur-bytecode 0.1.1

Luau bytecode format and builder (Rust).
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

use crate::enums::dump_flags::DumpFlags;
use crate::records::bytecode_builder::BytecodeBuilder;
use luaur_common::functions::vformat_append::vformatAppend;

impl BytecodeBuilder {
    pub fn add_debug_remark(&mut self, args: core::fmt::Arguments<'_>) {
        if (self.dump_flags & (DumpFlags::Dump_Remarks as u32)) == 0 {
            return;
        }

        let offset = self.debug_remark_buffer.len();

        // C++ `addDebugRemark(const char* format, ...)` printf-formats the whole remark.
        // Rust has no printf, so callers pass the fully-rendered message as a single
        // `format_args!(...)` (the C-style `%d`/`%.2f` become `{}`/`{:.2}`).
        vformatAppend(&mut self.debug_remark_buffer, args);

        // we null-terminate all remarks to avoid storing remark length
        self.debug_remark_buffer.push('\0');

        self.debug_remarks
            .push((self.insns.len() as u32, offset as u32));

        let remark_len = self.debug_remark_buffer.as_bytes()[offset..]
            .iter()
            .position(|&b| b == 0)
            .unwrap_or(self.debug_remark_buffer.len() - offset) as i32;

        let remark_str =
            self.debug_remark_buffer[offset..offset + (remark_len as usize)].to_string();

        self.dump_remarks.push((self.debug_line, remark_str));
    }
}