Struct LuaStringImpl 

pub struct LuaStringImpl { /* private fields */ }

A Lua string: an immutable, reference-counted byte sequence. Corresponds to C’s TString.

Short strings (<= MAX_SHORT_LEN = 40 bytes) are interned in the StringPool on GlobalState; two short strings with the same bytes are guaranteed to be the same GcRef (pointer equality via Rc::ptr_eq). In practice the only LuaStringImpl ever created is the bootstrap OOM message — see the module doc.

Long strings are heap-allocated independently and never interned. hash is set once at construction in [create_str_obj], not computed lazily.

Implementations

impl LuaStringImpl

pub fn as_bytes(&self) -> &[u8]

Returns the string’s bytes.

pub fn len(&self) -> usize

Returns the byte length of the string.

pub fn is_long(&self) -> bool

Returns true if this is a long (non-interned) string.

pub fn is_short(&self) -> bool

Returns true if this is a short (interned) string.

pub fn is_reserved_word(&self) -> bool

Returns true if this short string is a Lua reserved word.

pub fn is_white(&self) -> bool

GC color predicate. LuaStringImpl values are never registered with the tracing collector (see the module doc), so this always returns false.

pub fn flip_white(&self)

Flip GC color from white to the current non-white (resurrect a dead object). No-op; see Self::is_white.

Trait Implementations

impl Eq for LuaStringImpl

impl PartialEq for LuaStringImpl

fn eq(&self, other: &Self) -> bool

Equality for Lua strings.

For short strings (interned), pointer equality via Rc::ptr_eq is sufficient and matches eqshrstr in C. For long strings, we fall back to byte comparison, matching luaS_eqlngstr in C.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Trace for LuaStringImpl

The byte buffer is a Rust Rc<[u8]> (not GC-managed); no fields to mark.

fn type_name(&self) -> &'static str

Concrete Rust type name for diagnostic/testC telemetry (Heap::type_name_count). Collector behavior must not branch on this. The default covers container blanket impls, which are never GC-boxed directly; concrete runtime types override it with std::any::type_name::<Self>().

fn trace(&self, _m: &mut Marker)