libuv 2.13.1

A safe rust wrapper for libuv
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
112

use crate::{FromInner, Inner, IntoInner};
use std::ffi::{c_void, CStr, CString};
use std::mem::{size_of, transmute};
use uv::{uv_dlclose, uv_dlerror, uv_dlopen, uv_dlsym, uv_lib_t};

/// Returns an error from DLib::open() or DLib::sym()
#[derive(Debug)]
pub struct DLError(String);

impl DLError {
    /// Construct a new DLError
    fn new(lib: &DLib) -> DLError {
        let ptr = unsafe { uv_dlerror(lib.inner()) };
        DLError(unsafe { CStr::from_ptr(ptr).to_string_lossy().into_owned() })
    }

    /// Retrieve the error message
    pub fn message(&self) -> String {
        self.0.clone()
    }
}

impl std::fmt::Display for DLError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(&self.0)
    }
}

impl std::error::Error for DLError {}

/// Shared library data type.
pub struct DLib {
    lib: *mut uv_lib_t,
}

impl DLib {
    /// Construct a new DLib
    fn new() -> crate::Result<DLib> {
        let layout = std::alloc::Layout::new::<uv_lib_t>();
        let lib = unsafe { std::alloc::alloc(layout) as *mut uv_lib_t };
        if lib.is_null() {
            return Err(crate::Error::ENOMEM);
        }
        Ok(DLib { lib })
    }

    /// Opens a shared library. The filename is in utf-8.
    pub fn open(filename: &str) -> Result<DLib, Box<dyn std::error::Error>> {
        let filename = CString::new(filename)?;
        let lib = DLib::new()?;
        let libptr = lib.inner();
        let result = unsafe { uv_dlopen(filename.as_ptr(), libptr) };
        if result < 0 {
            Err(Box::new(DLError::new(&lib)))
        } else {
            Ok(lib)
        }
    }

    /// Close the shared library.
    pub fn close(self) {
        unsafe { uv_dlclose(self.lib.into_inner()) };
    }

    /// Retrieves a data pointer from a dynamic library. It is legal for a symbol to map to NULL.
    /// Returns a DLError if the symbol was not found.
    ///
    /// Type "T" should be either a function pointer or a *mut/*const pointer. For example:
    ///   sym::<extern "C" fn()>("test")
    ///   sym::<*mut f64>("test")
    pub fn sym<T>(&self, name: &str) -> Result<&T, Box<dyn std::error::Error>> {
        if size_of::<T>() != size_of::<*mut c_void>() {
            return Err(Box::new(DLError(
                "Type is not compatible with *mut c_void".to_owned(),
            )));
        }

        let name = CString::new(name)?;
        let mut ptr: *mut c_void = std::ptr::null_mut();
        let result = unsafe { uv_dlsym((*self).inner(), name.as_ptr(), &mut ptr) };
        if result < 0 {
            Err(Box::new(DLError::new(self)))
        } else {
            unsafe { Ok(transmute(&ptr)) }
        }
    }
}

impl Drop for DLib {
    fn drop(&mut self) {
        let layout = std::alloc::Layout::new::<uv_lib_t>();
        unsafe { std::alloc::dealloc(self.lib as _, layout) };
    }
}

impl FromInner<*mut uv_lib_t> for DLib {
    fn from_inner(lib: *mut uv_lib_t) -> DLib {
        DLib { lib }
    }
}

impl Inner<*mut uv_lib_t> for DLib {
    fn inner(&self) -> *mut uv_lib_t {
        self.lib
    }
}

impl Inner<*const uv_lib_t> for DLib {
    fn inner(&self) -> *const uv_lib_t {
        self.lib as _
    }
}