Struct jrsonnet_gc::Gc [−][src]
Expand description
A garbage-collected pointer type over an immutable value.
See the module level documentation for more details.
Implementations
Constructs a new Gc<T>
with the given value.
Collection
This method could trigger a garbage collection.
Examples
use jrsonnet_gc::Gc; let five = Gc::new(5); assert_eq!(*five, 5);
Consumes the Gc
, returning the wrapped pointer.
To avoid a memory leak, the pointer must be converted back into a Gc
using Gc::from_raw
.
Examples
use jrsonnet_gc::Gc; let x = Gc::new(22); let x_ptr = Gc::into_raw(x); assert_eq!(unsafe { *x_ptr }, 22);
Constructs an Gc
from a raw pointer.
The raw pointer must have been previously returned by a call to a
Gc::into_raw
.
This function is unsafe because improper use may lead to memory problems. For example, a use-after-free will occur if the function is called twice on the same raw pointer.
Examples
use jrsonnet_gc::Gc; let x = Gc::new(22); let x_ptr = Gc::into_raw(x); unsafe { // Convert back to an `Gc` to prevent leak. let x = Gc::from_raw(x_ptr); assert_eq!(*x, 22); // Further calls to `Gc::from_raw(x_ptr)` would be memory unsafe. } // The memory can be freed at any time after `x` went out of scope above // (when the collector is run), which would result in `x_ptr` dangling!
Trait Implementations
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
Runs Finalize::finalize() on this object and all contained subobjects Read more
Auto Trait Implementations
impl<T> !RefUnwindSafe for Gc<T>
impl<T> !UnwindSafe for Gc<T>
Blanket Implementations
Mutably borrows from an owned value. Read more