Struct VecBuilder 

pub struct VecBuilder { /* private fields */ }

Used to build a new vector.

This struct is created by the builder method on RawVec.

Implementations

impl VecBuilder

pub const fn capacity(&mut self, capacity: usize) -> &mut Self

The built RawVec will have the minimum capacity required for capacity elements.

The capacity can be greater due to the alignment to the page size.

pub const fn growth_strategy( &mut self, growth_strategy: GrowthStrategy, ) -> &mut Self

The built RawVec will have the given growth_strategy.

Panics

Panics if growth_strategy isn’t valid per the documentation of GrowthStrategy.

pub const fn header(&mut self, header_layout: Layout) -> &mut Self

The built RawVec will have a header with the given header_layout.

header_layout.size() bytes will be allocated before the start of the vector’s elements, with the start aligned to header_layout.align(). You can use RawVec::as_ptr and offset backwards to access the header.

Panics

Panics if header_layout is not padded to its alignment.

pub unsafe fn build<T>(&self) -> RawVec<T>

Builds the RawVec.

Safety

T must be zeroable.

Panics

• Panics if the max_capacity would exceed isize::MAX bytes.
• Panics if the capacity is greater than the max_capacity.
• Panics if reserving the allocation returns an error.

pub unsafe fn try_build<T>(&self) -> Result<RawVec<T>, TryReserveError>

Tries to build the RawVec, returning an error when allocation fails.

Safety

T must be zeroable.

Errors

• Returns an error if the max_capacity would exceed isize::MAX bytes.
• Returns an error if the capacity is greater than the max_capacity.
• Returns an error if reserving the allocation returns an error.

Trait Implementations

impl Clone for VecBuilder

fn clone(&self) -> VecBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VecBuilder

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

Formats the value using the given formatter.

impl Copy for VecBuilder