jlrs 0.23.0

jlrs provides bindings to the Julia C API that enable Julia code to be called from Rust and more.
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

use std::time::{Duration, Instant};

use jlrs_sys::{jlrs_gc_safe_enter, jlrs_gc_safe_leave};
use parking_lot::RawMutex;

use crate::memory::get_tls;

/// See [`parking_lot::RawFairMutex`] for more information.
pub struct RawGcSafeFairMutex {
    inner: RawMutex,
}

unsafe impl lock_api::RawMutex for RawGcSafeFairMutex {
    const INIT: Self = RawGcSafeFairMutex {
        inner: <RawMutex as lock_api::RawMutex>::INIT,
    };

    type GuardMarker = <RawMutex as lock_api::RawMutex>::GuardMarker;

    #[inline]
    fn lock(&self) {
        unsafe {
            if self.try_lock() {
                return;
            }

            let ptls = get_tls();
            let state = jlrs_gc_safe_enter(ptls);
            self.inner.lock();
            jlrs_gc_safe_leave(ptls, state);
        }
    }

    #[inline]
    fn try_lock(&self) -> bool {
        self.inner.try_lock()
    }

    #[inline]
    unsafe fn unlock(&self) {
        unsafe { self.inner.unlock() }
    }

    #[inline]
    fn is_locked(&self) -> bool {
        self.inner.is_locked()
    }
}

unsafe impl lock_api::RawMutexFair for RawGcSafeFairMutex {
    #[inline]
    unsafe fn unlock_fair(&self) {
        unsafe { self.inner.unlock_fair() }
    }

    #[inline]
    unsafe fn bump(&self) {
        unsafe { self.inner.bump() }
    }
}

unsafe impl lock_api::RawMutexTimed for RawGcSafeFairMutex {
    type Duration = Duration;
    type Instant = Instant;

    #[inline]
    fn try_lock_until(&self, timeout: Instant) -> bool {
        self.inner.try_lock_until(timeout)
    }

    #[inline]
    fn try_lock_for(&self, timeout: Duration) -> bool {
        self.inner.try_lock_for(timeout)
    }
}