ruru 0.9.3

Native Ruby extensions in Rust
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use std::ptr;

use ruby_sys::{thread, vm};

use types::{CallbackPtr, c_int, c_void, Value};
use util;

pub fn block_proc() -> Value {
    unsafe { vm::rb_block_proc() }
}

pub fn is_block_given() -> bool {
    let result = unsafe { vm::rb_block_given_p() };

    util::c_int_to_bool(result)
}

pub fn init() {
    unsafe {
        vm::ruby_init();
    }
}

pub fn require(name: &str) {
    let name = util::str_to_cstring(name);

    unsafe {
        vm::rb_require(name.as_ptr());
    }
}

pub fn raise(exception: Value, message: &str) {
    let message = util::str_to_cstring(message);

    unsafe {
        vm::rb_raise(exception, message.as_ptr());
    }
}

pub fn thread_call_without_gvl<F, R, G>(func: F, unblock_func: Option<G>) -> R
    where F: FnOnce() -> R,
          G: FnOnce()
{
    unsafe {
        let ptr = if let Some(ubf) = unblock_func {
            thread::rb_thread_call_without_gvl(callbox as CallbackPtr,
                                               util::closure_to_ptr(func),
                                               callbox as CallbackPtr,
                                               util::closure_to_ptr(ubf))
        } else {
            thread::rb_thread_call_without_gvl(callbox as CallbackPtr,
                                               util::closure_to_ptr(func),
                                               ptr::null() as CallbackPtr,
                                               ptr::null() as *const c_void)
        };

        util::ptr_to_data(ptr)
    }
}

pub fn thread_call_without_gvl2<F, R, G>(func: F, unblock_func: Option<G>) -> R
    where F: FnOnce() -> R,
          G: FnOnce()
{
    unsafe {
        let ptr = if let Some(ubf) = unblock_func {
            thread::rb_thread_call_without_gvl2(callbox as CallbackPtr,
                                                util::closure_to_ptr(func),
                                                callbox as CallbackPtr,
                                                util::closure_to_ptr(ubf))
        } else {
            thread::rb_thread_call_without_gvl2(callbox as CallbackPtr,
                                                util::closure_to_ptr(func),
                                                ptr::null() as CallbackPtr,
                                                ptr::null() as *const c_void)
        };

        util::ptr_to_data(ptr)
    }
}

pub fn thread_call_with_gvl<F, R>(func: F) -> R
    where F: FnOnce() -> R
{
    unsafe {
        let ptr = thread::rb_thread_call_with_gvl(callbox as CallbackPtr,
                                                  util::closure_to_ptr(func));

        util::ptr_to_data(ptr)
    }

}

extern "C" fn callbox(boxptr: *mut c_void) -> *const c_void {
    let mut fnbox: Box<Box<FnMut() -> *const c_void>> =
        unsafe { Box::from_raw(boxptr as *mut Box<FnMut() -> *const c_void>) };

    fnbox()
}

pub fn protect<F>(func: F) -> Result<Value, c_int>
    where F: FnOnce()
{
    let mut state = 0;
    let value = unsafe {
        vm::rb_protect(callbox as CallbackPtr,
                       util::closure_to_ptr(func),
                       &mut state as *mut c_int)
    };
    if state == 0 { Ok(value) } else { Err(state) }
}