#allocation #bounds #limit

cap

An allocator that can track and limit memory usage. This crate provides a generic allocator that wraps another allocator, tracking memory usage and enabling limits to be set

3 releases

0.1.2 Mar 26, 2023
0.1.1 Aug 15, 2022
0.1.0 Oct 21, 2019

#134 in Memory management

Download history 2633/week @ 2024-12-09 2288/week @ 2024-12-16 801/week @ 2024-12-23 1055/week @ 2024-12-30 2042/week @ 2025-01-06 2728/week @ 2025-01-13 4161/week @ 2025-01-20 2767/week @ 2025-01-27 3148/week @ 2025-02-03 2316/week @ 2025-02-10 2718/week @ 2025-02-17 4191/week @ 2025-02-24 2711/week @ 2025-03-03 3257/week @ 2025-03-10 5009/week @ 2025-03-17 3383/week @ 2025-03-24

14,519 downloads per month
Used in 7 crates

MIT/Apache

17KB
413 lines

cap

Crates.io MIT / Apache 2.0 licensed Build Status

Docs

An allocator that can track and limit memory usage.

This crate provides a generic allocator that wraps another allocator, tracking memory usage and enabling limits to be set.

Example

It can be used by declaring a static and marking it with the #[global_allocator] attribute:

use std::alloc;
use cap::Cap;

#[global_allocator]
static ALLOCATOR: Cap<alloc::System> = Cap::new(alloc::System, usize::max_value());

fn main() {
    // Set the limit to 30MiB.
    ALLOCATOR.set_limit(30 * 1024 * 1024).unwrap();
    // ...
    println!("Currently allocated: {}B", ALLOCATOR.allocated());
}

License

Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps

Features