Struct Library

pub struct Library { /* private fields */ }

A handle wrapper with a VTable of symbols found in the library as they’re requested.

Implementations

impl Library

pub unsafe fn handle(&self) -> &*mut c_void

Returns an unsafe reference to the handle of the library. Usually, the [sym] and drop methods are enough, but you’re free to use it for anything else, provided you can dereference it.

pub unsafe fn table(&self) -> &HashMap<String, *mut c_void>

Returns an unsafe reference to the VTable of the library. Usually, the [sym] method is enough, though you’re free to use it for what you may want to use it for.

pub fn name(&self) -> String

Returns the path of the dynamic library as given to [open] or [new].

pub fn sym<T>(&mut self, name: String) -> Option<Box<T>>

Requests and finds a symbol in the library. So long [RtldOr::Local] wasn’t specified, it will also look at other loaded symbols which are either in the program itself or were loaded with [RtldOr::Global].

pub fn open(name: String, flags: RtldValue, closure: fn(lib: Library)) -> bool

Makes a safe instance using [new] then applies the closure given to it. It returns true if it was successful, or false if anything went wrong.

pub unsafe fn new(name_c: CString, flags: RtldValue) -> Option<Self>

Creates a new instance of the library wanted. There are no checks other than handle checks upon loading it. It is the user’s responsibility to pass a valid CString instance and valid flags.

Trait Implementations

impl Drop for Library

fn drop(&mut self)

Closes the handle then drops the entire library.