Skip to main content

Ref

zerodds_ast_core::reference

Enum Ref

pub enum Ref<T> {
    Resolved(Id<T>),
    Pending(PendingRef),
    Broken(BreakCause),
}

Expand description

A reference from one node to another.

Deliberately not Option<Id<T>>: type discovery delivers types whose targets have not arrived yet, and “absent” and “not resolved yet” are different facts that both need representing. Spec §2.

Variants§

Resolved(Id<T>)

Points at a live node.

Pending(PendingRef)

Names a target that has not been resolved yet.

Broken(BreakCause)

Resolution was attempted and failed.

Implementations§

impl<T> Ref<T>

pub const fn resolved(&self) -> Option<Id<T>>

The handle, if resolved.

pub const fn is_resolved(&self) -> bool

Whether this reference points at a live node.

pub const fn is_pending(&self) -> bool

Whether resolution is still outstanding.

pub const fn is_broken(&self) -> bool

Whether resolution failed.

pub const fn pending_key(&self) -> Option<&PendingRef>

The lookup key, for the pending-reference index.

None once the reference is resolved or broken. A broken reference is not waiting on anything and must not be retried implicitly — a diagnostic already reported must not silently vanish. Spec §2.

pub const fn break_cause(&self) -> Option<&BreakCause>

The failure cause, if broken.

Trait Implementations§

impl<T: Clone> Clone for Ref<T>

fn clone(&self) -> Self

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

impl<T: Debug> Debug for Ref<T>

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

Formats the value using the given formatter. Read more

impl<T: Eq> Eq for Ref<T>

impl<T: PartialEq> PartialEq for Ref<T>

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

Equality operator ==. Read more

1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

impl<T: PartialEq> StructuralPartialEq for Ref<T>

Auto Trait Implementations§

impl<T> Freeze for Ref<T>
where Id<T>: Freeze,

impl<T> RefUnwindSafe for Ref<T>
where Id<T>: RefUnwindSafe,

impl<T> Send for Ref<T>
where Id<T>: Send,

impl<T> Sync for Ref<T>
where Id<T>: Sync,

impl<T> Unpin for Ref<T>
where Id<T>: Unpin,

impl<T> UnsafeUnpin for Ref<T>
where Id<T>: UnsafeUnpin,

impl<T> UnwindSafe for Ref<T>
where Id<T>: UnwindSafe,

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

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

Performs copy-assignment from self to dest. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = !

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, !>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.