luau-vm 0.732.0

Pure-Rust Luau virtual machine, garbage collector, and standard libraries
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

use luau_common::BString;

use crate::gc::GcObject;
use crate::handle::RawHandle;
use crate::value::TValueCursor;

mod dump;
mod heap;
mod validate;

pub(super) use dump::{DumpContext, dump_gco, dump_gco_visitor};
pub(super) use heap::{HeapEnumContext, enum_heap_gco_visitor};
pub(super) use validate::validate_gco_visitor;

/// `safejson`
pub(super) fn safe_json(byte: u8) -> bool {
    (32..128).contains(&byte) && byte != b'\\' && byte != b'"'
}

pub(in crate::gc) fn append_decimal(output: &mut BString, value: impl ToString) {
    output.extend_from_slice(value.to_string().as_bytes());
}

/// `dumpref`
pub(in crate::gc) unsafe fn append_ref(output: &mut BString, object: GcObject) {
    output.push(b'"');
    output.extend_from_slice(format!("{:p}", object.as_ptr()).as_bytes());
    output.push(b'"');
}

/// `dumprefs`
pub(super) unsafe fn append_dump_refs(output: &mut BString, data: TValueCursor, size: usize) {
    let mut first = true;

    for index in 0..size {
        let value = unsafe { data.add(index) };
        if unsafe { value.value_unchecked() }.is_collectable() {
            if !first {
                output.push(b',');
            }
            first = false;
            unsafe { append_ref(output, value.value_unchecked().gc_value()) };
        }
    }
}

/// `dumpstringdata`
pub(super) fn append_dump_string_data(output: &mut BString, bytes: &[u8]) {
    for &byte in bytes {
        output.push(if safe_json(byte) { byte } else { b'?' });
    }
}