Struct PsObject 

pub struct PsObject {
    pub value: PsValue,
    pub flags: ObjFlags,
}

A PostScript object: a tagged value with metadata flags.

PsObject is Clone + Copy — it’s a value type containing indices into arena stores, not heap references.

Fields

value: PsValue

flags: ObjFlags

Implementations

impl PsObject

pub fn int(v: impl Into<i64>) -> Self

Build an integer object.

Generic over anything that widens losslessly to i64 so the many i32/u8/u16 call sites need no cast.

pub fn real(v: f64) -> Self

pub fn bool(v: bool) -> Self

pub fn null() -> Self

pub fn mark() -> Self

pub fn dict_mark() -> Self

Dict mark from << — distinct from [/mark marks.

pub fn name_lit(id: NameId) -> Self

Literal name: /foo

pub fn name_exec(id: NameId) -> Self

Executable name: foo

pub fn operator(op: OpCode) -> Self

pub fn string(entity: EntityId, len: u32) -> Self

Literal string.

pub fn array(entity: EntityId, len: u32) -> Self

Literal array.

pub fn procedure(entity: EntityId, len: u32) -> Self

Executable array (procedure body).

pub fn dict(entity: EntityId) -> Self

Dict object.

pub fn stopped_mark() -> Self

Stopped marker (internal).

pub fn loop_mark(entity: EntityId) -> Self

Loop marker (internal).

pub fn hard_return() -> Self

HardReturn marker (internal).

pub fn dict_end(entity: EntityId) -> Self

DictEnd marker (internal) — conditionally pops the dict stack when reached.

pub fn is_numeric(&self) -> bool

pub fn is_int(&self) -> bool

pub fn is_real(&self) -> bool

pub fn is_bool(&self) -> bool

pub fn is_array_type(&self) -> bool

pub fn is_composite(&self) -> bool

pub fn is_global_vm(&self) -> bool

Check if this object is in global VM using authoritative entity tag bits for composite types, falling back to ObjFlags for simple types.

pub fn type_name(&self) -> &'static [u8]

PostScript type name as bytes (e.g. b"integertype").

pub fn as_f64(&self) -> Option<f64>

Extract as f64 (works for both Int and Real).

pub fn as_i32(&self) -> Option<i32>

Extract as i32 (Int only), rejecting values outside i32 range.

PostScript integers are i64 (see PsValue::Int), but many callers need an i32 — array and string indices, character codes, operand counts. Those are all genuinely bounded, and a value too large to be one of them should fail the caller’s range check rather than wrap silently, so this returns None instead of truncating.

pub fn as_i64(&self) -> Option<i64>

Extract as i64 (Int only) — the full PostScript integer range.

Trait Implementations

impl Clone for PsObject

fn clone(&self) -> PsObject

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PsObject

impl Debug for PsObject

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

Formats the value using the given formatter.

impl PartialEq for PsObject

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PsObject