Enum BoxOrStatic 

#[repr(C, u8)]
pub enum BoxOrStatic<T> {
    Boxed(*mut T),
    Static(*const T),
}

A value that is either heap-allocated (parsed at runtime) or a compile-time static reference. Used to reduce enum size for large CSS property payloads by storing them behind a pointer instead of inline.

• Size: 1 (tag) + 7 (padding) + 8 (pointer) = 16 bytes on 64-bit
• Static variant: no allocation, just a *const T pointer to static data
• Boxed variant: heap-allocated via Box::into_raw, freed on Drop

Variants

Boxed(*mut T)

Heap-allocated (parsed at runtime). Owned — freed on Drop.

Static(*const T)

Compile-time constant (e.g. from const CSS defaults). Not freed.

Implementations

impl<T> BoxOrStatic<T>

pub fn heap(value: T) -> Self

Allocate value on the heap and return a Boxed variant.

pub fn as_ref(&self) -> &T

Return a reference to the inner value.

Safety invariant

The inner pointer must be non-null. This is guaranteed by heap and the Static constructor (which should always point to valid data).

pub fn as_mut(&mut self) -> &mut T

Return a mutable reference to the inner value (only for Boxed). Panics if called on Static.

pub fn into_inner(self) -> T

where T: Clone,

Consume self and return the inner value.

Trait Implementations

impl<T: Clone> Clone for BoxOrStatic<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for BoxOrStatic<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for BoxOrStatic<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T> Deref for BoxOrStatic<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: Display> Display for BoxOrStatic<T>

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

Formats the value using the given formatter.

impl<T> Drop for BoxOrStatic<T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<T: FormatAsRustCode + 'static> FormatAsRustCode for BoxOrStatic<T>

fn format_as_rust_code(&self, tabs: usize) -> String

impl<T: Hash> Hash for BoxOrStatic<T>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Ord> Ord for BoxOrStatic<T>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T: PartialEq> PartialEq for BoxOrStatic<T>

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: PartialOrd> PartialOrd for BoxOrStatic<T>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T: PrintAsCssValue> PrintAsCssValue for BoxOrStatic<T>

fn print_as_css_value(&self) -> String

impl<T: Eq> Eq for BoxOrStatic<T>

impl<T: Send + 'static> Send for BoxOrStatic<T>

impl<T: Sync + 'static> Sync for BoxOrStatic<T>