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

//! A reference to a slot in a frame.

use std::{cell::Cell, os::raw::c_void};

use crate::memory::context::stack::Stack;

/// A reference to a slot in a [`LocalGcFrame`].
///
/// [`LocalGcFrame`]: crate::memory::target::frame::LocalGcFrame
pub struct LocalSlotRef<'target> {
    slot: &'target Cell<*mut c_void>,
}

impl<'target> LocalSlotRef<'target> {
    #[inline]
    pub(crate) fn new(slot: &'target Cell<*mut c_void>) -> Self {
        LocalSlotRef { slot }
    }
}

/// A reference to a slot in a [`GcFrame`].
///
/// [`GcFrame`]: crate::memory::target::frame::GcFrame
pub struct StackSlotRef<'target> {
    stack: &'target Stack,
    offset: usize,
}

impl<'target> StackSlotRef<'target> {
    #[inline]
    pub(crate) fn new(stack: &'target Stack, offset: usize) -> Self {
        StackSlotRef { stack, offset }
    }
}

/// A reference to a slot in a frame.
pub unsafe trait SlotRef: private::SlotRefPriv {}

unsafe impl<'target> SlotRef for LocalSlotRef<'target> {}

unsafe impl<'target> SlotRef for StackSlotRef<'target> {}

mod private {
    use std::{os::raw::c_void, ptr::NonNull};

    use super::{LocalSlotRef, StackSlotRef};
    use crate::private::Private;

    pub unsafe trait SlotRefPriv {
        unsafe fn set(&self, data: NonNull<c_void>, _: Private);
    }

    unsafe impl<'target> SlotRefPriv for StackSlotRef<'target> {
        #[inline]
        unsafe fn set(&self, data: NonNull<c_void>, _: Private) {
            unsafe {
                self.stack.set_root(self.offset, data.cast());
            }
        }
    }

    unsafe impl<'target> SlotRefPriv for LocalSlotRef<'target> {
        #[inline]
        unsafe fn set(&self, data: NonNull<c_void>, _: Private) {
            self.slot.set(data.as_ptr().cast());
        }
    }
}