Struct generic_vec::raw::Heap

#[repr(C)]pub struct Heap<T, A: ?Sized + AllocRef = Global> { /* fields omitted */ }

This is supported on crate feature alloc only.

A heap storage that can reallocate if necessary,

Usable with the alloc feature

The allocator type paramter is only available on nightly

Implementations

impl<T> Heap<T>

pub const fn new() -> Self

Create a new zero-capacity heap vector

pub const unsafe fn from_raw_parts(ptr: NonNull<T>, capacity: usize) -> Self

Create a new Heap<T>storage from the given pointer and capacity

Safety

If the capacity is non-zero

• You must have allocated the pointer from the Global allocator
• The pointer must be valid to read-write for the range ptr..ptr.add(capacity)

pub const fn into_raw_parts(self) -> (NonNull<T>, usize)

Convert a Heap storage into a pointer and capacity, without deallocating the storage

impl<T, A: AllocRef> Heap<T, A>

pub const fn with_alloc(alloc: A) -> Self

This is supported on crate feature nightly only.

Create a new zero-capacity heap vector with the given allocator

pub const unsafe fn from_raw_parts_in(
    ptr: NonNull<T>,
    capacity: usize,
    alloc: A
) -> Self

This is supported on crate feature nightly only.

Create a new Heap<T>storage from the given pointer and capacity

Safety

If the capacity is non-zero

• You must have allocated the pointer from the given allocator
• The pointer must be valid to read-write for the range ptr..ptr.add(capacity)

pub fn into_raw_parts_with_alloc(self) -> (NonNull<T>, usize, A)

This is supported on crate feature nightly only.

Convert a Heap storage into a pointer and capacity, without deallocating the storage

Trait Implementations

impl<T, A: AllocRef + Default> Default for Heap<T, A>

pub fn default() -> Self

Returns the "default value" for a type.

impl<T, A: ?Sized + AllocRef> Drop for Heap<T, A>

pub fn drop(&mut self)

Executes the destructor for this type.

impl<T, A: AllocRef + Send> Send for Heap<T, A>

impl<T, U, A: ?Sized + AllocRef> Storage<U> for Heap<T, A>

pub const IS_ALIGNED: bool

Is the pointer from as_ptr guaranteed to be aligned to T

pub fn capacity(&self) -> usize

The number of elements that it is valid to write to this Storage

pub fn as_ptr(&self) -> *const U

Returns a pointer to the first element

pub fn as_mut_ptr(&mut self) -> *mut U

Returns a mutable pointer to the first element

pub fn reserve(&mut self, new_capacity: usize)

Reserves space for at least new_capacity elements

pub fn try_reserve(&mut self, new_capacity: usize) -> bool

Tries to reserve space for at least new_capacity elements

impl<T, U, A: Default + AllocRef> StorageWithCapacity<U> for Heap<T, A>

pub fn with_capacity(cap: usize) -> Self

Creates a new storage with at least the given storage capacity

impl<T, A: AllocRef + Sync> Sync for Heap<T, A>