sandpit 0.5.2

A concurrent garbage collected arena
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

#[cfg(feature = "std")]
use std::env;
#[cfg(feature = "std")]
use std::sync::OnceLock;

#[cfg(feature = "std")]
static GC_DEBUG_ENABLED: OnceLock<bool> = OnceLock::new();
#[cfg(feature = "std")]
static GC_TRACE_ENABLED: OnceLock<bool> = OnceLock::new();

/// Check if GC_DEBUG environment variable is set and print the message if it is.
/// This function caches the environment variable check on first call.
///
/// In `no_std` environments, this function is a no-op that compiles away.
#[cfg(feature = "std")]
#[inline]
pub fn gc_debug(msg: &str) {
    let enabled = *GC_DEBUG_ENABLED.get_or_init(|| env::var("GC_DEBUG").is_ok());
    if enabled {
        println!("GC_DEBUG: {}", msg);
    }
}

/// Check if GC_DEBUG environment variable is set and print the message if it is.
/// This function caches the environment variable check on first call.
///
/// In `no_std` environments, this function is a no-op that compiles away.
#[cfg(not(feature = "std"))]
#[inline]
pub fn gc_debug(_msg: &str) {
    // No-op in no_std environments
}

/// Check if GC_TRACE environment variable is set and print the message if it is.
/// This function caches the environment variable check on first call.
///
/// In `no_std` environments, this function is a no-op that compiles away.
#[cfg(feature = "std")]
#[inline]
pub fn gc_trace(msg: &str) {
    let enabled = *GC_TRACE_ENABLED.get_or_init(|| env::var("GC_TRACE").is_ok());
    if enabled {
        println!("GC_TRACE: {}", msg);
    }
}

/// Check if GC_TRACE environment variable is set and print the message if it is.
/// This function caches the environment variable check on first call.
///
/// In `no_std` environments, this function is a no-op that compiles away.
#[cfg(not(feature = "std"))]
#[inline]
pub fn gc_trace(_msg: &str) {
    // No-op in no_std environments
}