dlopen2 0.9.0

Library for opening and operating on dynamic link libraries (also known as shared objects or shared libraries).
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

use std::{
    convert::From,
    error::Error as ErrorTrait,
    ffi::NulError,
    fmt::{Display, Formatter, Result as FmtResult},
    io::Error as IoError,
};

/// This is a library-specific error that is returned by all calls to all APIs.
#[derive(Debug)]
pub enum Error {
    /// Provided string could not be coverted into `std::ffi::CString` because it contained null
    /// character.
    NullCharacter(NulError),
    /// The library could not be opened.
    OpeningLibraryError(IoError),
    /// The symbol could not be obtained.
    SymbolGettingError(IoError),
    /// Value of the symbol was null.
    NullSymbol,
    /// Address could not be matched to a dynamic link library
    AddrNotMatchingDll(IoError),
}

impl ErrorTrait for Error {
    fn source(&self) -> Option<&(dyn ErrorTrait + 'static)> {
        use self::Error::*;
        match *self {
            NullCharacter(ref val) => Some(val),
            OpeningLibraryError(_) | SymbolGettingError(_) | NullSymbol | AddrNotMatchingDll(_) => {
                None
            }
        }
    }
}

impl Display for Error {
    fn fmt(&self, f: &mut Formatter) -> FmtResult {
        use self::Error::*;

        match self {
            NullCharacter(_) => write!(f, "String had a null character"),
            OpeningLibraryError(msg) => write!(f, "Could not open library: {msg}"),
            SymbolGettingError(msg) => {
                write!(f, "Could not obtain symbol from the library: {msg}")
            }
            NullSymbol => write!(f, "The symbol is NULL"),
            AddrNotMatchingDll(_) => write!(f, "Address does not match any dynamic link library"),
        }
    }
}

impl From<NulError> for Error {
    fn from(val: NulError) -> Error {
        Error::NullCharacter(val)
    }
}