Struct OrderRef 

pub struct OrderRef<'a>(/* private fields */);

Lifetime-scoped read borrow of a cached order.

Returned by crate::cache::Cache::order. The borrow drops with the enclosing scope, which makes any attempt to hold it across a cache mutation panic at runtime: a loud failure beats the silent staleness that a stored clone would produce.

Method calls on the inner OrderAny resolve via Deref; comparisons against &OrderAny or owned OrderAny values are direct (order_ref == &order); Display and Debug forward to the inner record. Use cloned when an owned snapshot is required (for example, before crossing a boundary that may dispatch events).

Implementations

impl<'a> OrderRef<'a>

pub fn new(inner: Ref<'a, OrderAny>) -> Self

Wraps the given Ref borrow.

pub fn cloned(&self) -> OrderAny

Returns an owned snapshot of the borrowed order.

Mirrors Option::cloned and Iterator::cloned; the snapshot will not reflect later mutations of the underlying cell.

Methods from Deref<Target = OrderAny>

pub fn init_event(&self) -> &OrderInitialized

Returns a reference to the crate::events::OrderInitialized event.

This is always the first event in the order’s event list (invariant).

Panics

Panics if the first event is not OrderInitialized (violates invariant).

Trait Implementations

impl AsRef<OrderAny> for OrderRef<'_>

fn as_ref(&self) -> &OrderAny

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for OrderRef<'_>

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

Formats the value using the given formatter.

impl Deref for OrderRef<'_>

type Target = OrderAny

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Display for OrderRef<'_>

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

Formats the value using the given formatter.

impl<'a> From<Ref<'a, OrderAny>> for OrderRef<'a>

fn from(inner: Ref<'a, OrderAny>) -> Self

Converts to this type from the input type.

impl PartialEq for OrderRef<'_>

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 PartialEq<&OrderAny> for OrderRef<'_>

fn eq(&self, other: &&OrderAny) -> 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 PartialEq<OrderAny> for OrderRef<'_>

fn eq(&self, other: &OrderAny) -> 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.