Struct netsblox_vm::gc::Gc

pub struct Gc<'gc, T>where
    T: 'gc + ?Sized,{ /* private fields */ }

A garbage collected pointer to a type T. Implements Copy, and is implemented as a plain machine pointer. You can only allocate Gc pointers through a &Mutation<'gc> inside an arena type, and through “generativity” such Gc pointers may not escape the arena they were born in or be stored inside TLS. This, combined with correct Collect implementations, means that Gc pointers will never be dangling and are always safe to access.

Implementations

impl<'gc, T> Gc<'gc, T>where T: Collect + 'gc,

pub fn new(mc: &Mutation<'gc>, t: T) -> Gc<'gc, T>

impl<'gc, T> Gc<'gc, T>where T: 'gc,

pub unsafe fn cast<U>(this: Gc<'gc, T>) -> Gc<'gc, U>where U: 'gc,

Cast the internal pointer to a different type.

SAFETY: It must be valid to dereference a *mut U that has come from casting a *mut T.

pub unsafe fn from_ptr(ptr: *const T) -> Gc<'gc, T>

Retrieve a Gc from a raw pointer obtained from Gc::as_ptr

SAFETY: The provided pointer must have been obtained from Gc::as_ptr, and the pointer must not have been collected yet.

impl<'gc, T> Gc<'gc, T>where T: Unlock + 'gc + ?Sized,

pub fn unlock(self, mc: &Mutation<'gc>) -> &'gc <T as Unlock>::Unlocked

Shorthand for Gc::write(mc, self).unlock().

impl<'gc, T> Gc<'gc, T>where T: 'gc + ?Sized,

pub fn as_ref(self) -> &'gc T

Obtains a long-lived reference to the contents of this Gc.

Unlike AsRef or Deref, the returned reference isn’t bound to the Gc itself, and will stay valid for the entirety of the current arena callback.

pub fn downgrade(this: Gc<'gc, T>) -> GcWeak<'gc, T>

pub fn write(mc: &Mutation<'gc>, gc: Gc<'gc, T>) -> &'gc Write<T>

Triggers a write barrier on this Gc, allowing for further safe mutation.

pub fn ptr_eq(this: Gc<'gc, T>, other: Gc<'gc, T>) -> bool

pub fn as_ptr(gc: Gc<'gc, T>) -> *const T

impl<'gc, T> Gc<'gc, Lock<T>>where T: Copy + 'gc,

pub fn get(self) -> T

pub fn set(self, mc: &Mutation<'gc>, t: T)

impl<'gc, T> Gc<'gc, RefLock<T>>where T: 'gc + ?Sized,

pub fn borrow(self) -> Ref<'gc, T>

pub fn try_borrow(self) -> Result<Ref<'gc, T>, BorrowError>

pub fn borrow_mut(self, mc: &Mutation<'gc>) -> RefMut<'gc, T>

pub fn try_borrow_mut( self, mc: &Mutation<'gc> ) -> Result<RefMut<'gc, T>, BorrowMutError>

Trait Implementations

impl<'gc, T> AsRef<T> for Gc<'gc, T>where T: 'gc + ?Sized,

fn as_ref(&self) -> &T

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

impl<'gc, T> Clone for Gc<'gc, T>where T: 'gc + ?Sized,

fn clone(&self) -> Gc<'gc, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'gc, T> Collect for Gc<'gc, T>where T: 'gc + ?Sized,

fn trace(&self, cc: &Collection)

Must call Collect::trace on all held Gc pointers. If this type holds inner types that implement Collect, a valid implementation would simply call Collect::trace on all the held values to ensure this.

fn needs_trace() -> boolwhere Self: Sized,

As an optimization, if this type can never hold a Gc pointer and trace is unnecessary to call, you may implement this method and return false. The default implementation returns true, signaling that Collect::trace must be called.

impl<'gc, T> Debug for Gc<'gc, T>where T: Debug + 'gc + ?Sized,

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

Formats the value using the given formatter.

impl<'gc, T> Deref for Gc<'gc, T>where T: 'gc + ?Sized,

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<'gc, T> Display for Gc<'gc, T>where T: Display + 'gc + ?Sized,

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

Formats the value using the given formatter.

impl<'gc, C: CustomTypes<S>, S: System<C>> From<Gc<'gc, RefLock<Closure<'gc, C, S>>>> for Value<'gc, C, S>

fn from(v: Gc<'gc, RefLock<Closure<'gc, C, S>>>) -> Self

Converts to this type from the input type.

impl<'gc, C: CustomTypes<S>, S: System<C>> From<Gc<'gc, RefLock<Entity<'gc, C, S>>>> for Value<'gc, C, S>

fn from(v: Gc<'gc, RefLock<Entity<'gc, C, S>>>) -> Self

Converts to this type from the input type.

impl<'gc, C: CustomTypes<S>, S: System<C>> From<Gc<'gc, RefLock<VecDeque<Value<'gc, C, S>, Global>>>> for Value<'gc, C, S>

fn from(v: Gc<'gc, RefLock<VecDeque<Value<'gc, C, S>>>>) -> Self

Converts to this type from the input type.

impl<'gc, T> Pointer for Gc<'gc, T>where T: 'gc + ?Sized,

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

Formats the value using the given formatter.

impl<'gc, T> Copy for Gc<'gc, T>where T: 'gc + ?Sized,