Enum AllocatorType

pub enum AllocatorType {
    MimallocSecure,
    Mimalloc,
    EmbeddedHeap,
    System,
}

Memory allocator type enumeration

Represents all memory allocator types supported by auto-allocator. Selection priority: mimalloc > embedded > system

Performance Characteristics

• AllocatorType::MimallocSecure - Microsoft-developed allocator with security hardening (10% overhead)
• AllocatorType::Mimalloc - Microsoft-developed allocator, optimal multi-threaded performance
• AllocatorType::EmbeddedHeap - Lightweight allocator for resource-constrained environments
• AllocatorType::System - Operating system default allocator, maximum compatibility

Automatic Selection Logic

1. Modern Linux: mimalloc (if GCC 4.9+ and stdatomic.h available)
2. Legacy Linux: Compilation error with upgrade guidance
3. Windows/macOS: mimalloc (always available)
4. Mobile/BSD: System allocators (platform compliance)
5. Embedded (target_os = "none"): embedded-alloc (all no_std architectures)

Example

use auto_allocator;

let info = auto_allocator::get_allocator_info();
match info.allocator_type {
    auto_allocator::AllocatorType::Mimalloc => {
        println!("Using mimalloc - optimal performance");
    }
    auto_allocator::AllocatorType::System => {
        println!("Using system allocator - platform compliance");
    }
    _ => println!("Using other allocator"),
}

Variants

MimallocSecure

Security-hardened mimalloc allocator

Microsoft-developed allocator with enhanced security features. ~10% performance overhead for comprehensive heap protection. Available when secure feature is enabled on compatible platforms.

Mimalloc

High-performance mimalloc allocator

Microsoft-developed allocator optimized for multi-threaded workloads. Automatically selected on modern systems with GCC 4.9+ and stdatomic.h.

EmbeddedHeap

Embedded systems allocator

Lightweight allocator designed for resource-constrained environments. Automatically selected on embedded architectures.

System

System default allocator

Operating system provided allocator, maximum compatibility. Selected for debug builds, WASM, mobile, and platforms with optimized native allocators.

Trait Implementations

impl Clone for AllocatorType

fn clone(&self) -> AllocatorType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AllocatorType

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

Formats the value using the given formatter.

impl PartialEq for AllocatorType

fn eq(&self, other: &AllocatorType) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for AllocatorType

impl Eq for AllocatorType

impl StructuralPartialEq for AllocatorType