Trait Allocator

Source

pub trait Allocator:
    Send
    + Sync
    + 'static {
    // Required method
    fn allocate(&self, capacity: usize) -> Vec<u8> ⓘ;
}

Expand description

Controls how the pool creates raw byte buffers.

§Contract

allocate(capacity) must return a Vec<u8> with capacity() >= capacity.
The returned Vec must have len() == 0.
The Vec must be deallocatable by the standard global allocator.

§Example

use zeropool::{Allocator, ZeroPool};

struct PrefaultAllocator;

impl Allocator for PrefaultAllocator {
    fn allocate(&self, capacity: usize) -> Vec<u8> {
        let mut buf = Vec::with_capacity(capacity);
        buf.resize(capacity, 0); // pre-fault pages
        buf.clear();
        buf
    }
}

let pool = ZeroPool::new().allocator(PrefaultAllocator);