dlsym 0.0.1

Memory-safe bindings around the platform's dynamic library loading primitives
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

use std::borrow::Cow;
use std::ffi::{CStr, CString};

use crate::{Error, Result};

/// Types that can name a symbol.
///
/// Implemented for [`CStr`] (zero-cost; use `c"name"` literals) and for string
/// and byte slices, which are copied into a temporary NUL-terminated buffer
/// unless they already end with a NUL byte.
pub trait SymbolName {
    /// Returns the name as a C string.
    fn to_symbol_name(&self) -> Result<Cow<'_, CStr>>;
}

impl SymbolName for CStr {
    fn to_symbol_name(&self) -> Result<Cow<'_, CStr>> {
        Ok(Cow::Borrowed(self))
    }
}

impl SymbolName for CString {
    fn to_symbol_name(&self) -> Result<Cow<'_, CStr>> {
        Ok(Cow::Borrowed(self.as_c_str()))
    }
}

impl SymbolName for [u8] {
    fn to_symbol_name(&self) -> Result<Cow<'_, CStr>> {
        match CStr::from_bytes_until_nul(self) {
            Ok(s) if s.count_bytes() + 1 == self.len() => Ok(Cow::Borrowed(s)),
            Ok(s) => Err(Error::InteriorNul {
                position: s.count_bytes(),
            }),
            Err(_) => CString::new(self)
                .map(Cow::Owned)
                .map_err(|e| Error::InteriorNul {
                    position: e.nul_position(),
                }),
        }
    }
}

impl SymbolName for str {
    fn to_symbol_name(&self) -> Result<Cow<'_, CStr>> {
        self.as_bytes().to_symbol_name()
    }
}

impl SymbolName for String {
    fn to_symbol_name(&self) -> Result<Cow<'_, CStr>> {
        self.as_str().to_symbol_name()
    }
}

impl<T: SymbolName + ?Sized> SymbolName for &T {
    fn to_symbol_name(&self) -> Result<Cow<'_, CStr>> {
        (**self).to_symbol_name()
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn borrows_when_possible() {
        assert!(matches!(c"cos".to_symbol_name(), Ok(Cow::Borrowed(_))));
        assert!(matches!("cos\0".to_symbol_name(), Ok(Cow::Borrowed(_))));
        assert!(matches!("cos".to_symbol_name(), Ok(Cow::Owned(_))));
    }

    #[test]
    fn rejects_interior_nul() {
        assert!(matches!(
            "co\0s".to_symbol_name(),
            Err(Error::InteriorNul { position: 2 })
        ));
        assert!(matches!(
            "co\0s\0".to_symbol_name(),
            Err(Error::InteriorNul { position: 2 })
        ));
    }
}