Struct deno_core::arena::ArenaUnique
source · pub struct ArenaUnique<T> { /* private fields */ }
Expand description
An arena-based unique ownership container allowing allocation and deallocation of objects with exclusive ownership semantics.
ArenaUnique
provides exclusive ownership semantics similar to
a Box
. It utilizes a RawArena
for allocation and
deallocation of objects, maintaining the sole ownership of the
allocated data and enabling safe cleanup when the ArenaUnique
instance is dropped.
This container guarantees exclusive access to the allocated data within the arena, allowing single-threaded operations while efficiently managing memory and ensuring cleanup on drop.
Implementations§
source§impl<T> ArenaUnique<T>
impl<T> ArenaUnique<T>
sourcepub const fn overhead() -> usize
pub const fn overhead() -> usize
Returns the constant overhead per allocation to assist with making allocations page-aligned.
sourcepub const fn allocation_size() -> usize
pub const fn allocation_size() -> usize
Returns the size of each allocation.
pub fn with_capacity(capacity: usize) -> Self
sourcepub fn allocate(&self, data: T) -> ArenaBox<T> ⓘ
pub fn allocate(&self, data: T) -> ArenaBox<T> ⓘ
Allocates a new data instance of type T
within the arena, encapsulating it within an ArenaBox
.
This method creates a new instance of type T
within the RawArena
. The provided data
is initialized within the arena, and an ArenaBox
is returned to manage this allocated data.
The ArenaBox
serves as a reference to the allocated data within the arena, providing safe access
and management of the stored value.
§Safety
The provided data
is allocated within the arena and managed by the ArenaBox
. Improper handling
or misuse of the returned ArenaBox
pointer may lead to memory leaks or memory unsafety.
§Example
// Define a struct that will be allocated within the arena
struct MyStruct {
data: usize,
}
// Create a new instance of ArenaUnique with a specified base capacity
let arena: ArenaUnique<MyStruct> = ArenaUnique::with_capacity(16);
// Allocate a new MyStruct instance within the arena
let data_instance = MyStruct { data: 42 };
let allocated_box = arena.allocate(data_instance);
// Now, allocated_box can be used as a managed reference to the allocated data
assert_eq!(allocated_box.data, 42); // Validate the data stored in the allocated box
sourcepub unsafe fn reserve_space(&self) -> Option<ArenaUniqueReservation<T>>
pub unsafe fn reserve_space(&self) -> Option<ArenaUniqueReservation<T>>
Attempt to reserve space in this arena.
§Safety
Reservations must be either completed or forgotten, and must be provided to the same arena that created them.
sourcepub unsafe fn forget_reservation(&self, reservation: ArenaUniqueReservation<T>)
pub unsafe fn forget_reservation(&self, reservation: ArenaUniqueReservation<T>)
Forget a reservation.
§Safety
Reservations must be either completed or forgotten, and must be provided to the same arena that created them.
sourcepub unsafe fn complete_reservation(
&self,
reservation: ArenaUniqueReservation<T>,
data: T
) -> ArenaBox<T> ⓘ
pub unsafe fn complete_reservation( &self, reservation: ArenaUniqueReservation<T>, data: T ) -> ArenaBox<T> ⓘ
Complete a reservation.
§Safety
Reservations must be either completed or forgotten, and must be provided to the same arena that created them.
Trait Implementations§
Auto Trait Implementations§
impl<T> Freeze for ArenaUnique<T>
impl<T> !RefUnwindSafe for ArenaUnique<T>
impl<T> !Send for ArenaUnique<T>
impl<T> !Sync for ArenaUnique<T>
impl<T> Unpin for ArenaUnique<T>
impl<T> !UnwindSafe for ArenaUnique<T>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> FmtForward for T
impl<T> FmtForward for T
source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.source§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moresource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moresource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R ) -> R
source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.source§impl<T> Tap for T
impl<T> Tap for T
source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read moresource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read moresource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read moresource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read moresource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read moresource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read moresource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.